doc: correct punctuation and improve typography in documentation

man: clarify wording of os-release.CPE_NAME We expect the CPE_NAME to be formatted in URI binding syntax. Make that clear in the documentation. Furthermore, the CPE-spec has been taken over by NIST, so adjust the links as well. Reported by: Ben Harris <bjh21@cam.ac.uk>

man: revert dynamic paths for split-usr setups This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all.

man: generate configured paths in manpages In particular, use /lib/systemd instead of /usr/lib/systemd in distributions like Debian which still have not adopted a /usr merge setup. Use XML entities from man/custom-entities.ent to replace configured paths while doing XSLT processing of the original XML files. There was precedent of some files (such as systemd.generator.xml) which were already using this approach. This addresses most of the (manual) fixes from this patch: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/patches/Fix-paths-in-man-pages.patch?h=experimental-220 The idea of using generic XML entities was presented here: http://lists.freedesktop.org/archives/systemd-devel/2015-May/032240.html This patch solves almost all the issues, with the exception of: - Path to /bin/mount and /bin/umount. - Generic statements about preference of /lib over /etc. These will be handled separately by follow up patches. Tested: - With default configure settings, ran "make install" to two separate directories and compared the output to confirm they matched exactly. - Used a set of configure flags including $CONFFLAGS from Debian: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/rules Installed the tree and confirmed the paths use /lib/systemd instead of /usr/lib/systemd and that no other unexpected differences exist. - Confirmed that `make distcheck` still passes.

Add VARIANT as a standard value for /etc/os-release Some distributions (such as Fedora) are using the VARIANT field to indicate to select packages which of several default configurations they should be using. For example, VARIANT=Server provides a different default firewall configuration (blocking basically everything but SSH and the management console) whereas VARIANT=Workstation opens many other ports for application compatibility. By adding this patch to the manual pages, we can standardize on a cross-distribution mechanism for accomplishing this. Fedora implementation details are available at https://fedoraproject.org/wiki/Packaging:Per-Product_Configuration (David: drop double paranthesis)

man: avoid line break in url

man: fix a bunch of links All hail linkchecker!

man: boilerplate unification

Reindent man pages to 2ch

os-release: Add PRIVACY_POLICY_URL

doc: os-release: mention all shell characters that must be escaped Since the manpage already talks about shell-compatibility, it should be more accurate about what needs to be escaped and how.

note on relative symlink in os-release

doc: grammatical corrections

os-release: define /usr/lib/os-release as fallback for /etc/os-release The file should have been in /usr/lib/ in the first place, since it describes the OS container in /usr (and not the configuration in /etc), hence, let's support os-release files in /usr/lib as fallback if no version in /etc exists, following the usual override logic. A prior commit already enabled tmpfiles to create /etc/os-release as a symlink to /usr/lib/os-release should it be missing, thus providing nice compatibility with applications only checking in /etc. While it's probably a good idea if all apps check both locations via a fallback logic, it is only necessary in the early boot process, as long as the /etc/os-release symlink has not been restored, in case we boot with an empty /etc.

man: wording and grammar updates This is a recurring submission and includes corrections to various issue spotted. I guess I can just skip over reporting ubiquitous comma placement fixes… Highligts in this particular commit: - the "unsigned" type qualifier is completed to form a full type "unsigned int" - alphabetic -> lexicographic (that way we automatically define how numbers get sorted)

man: use HTTPS links for links that support it

man: improve grammar and word formatting in numerous man pages Use proper grammar, word usage, adjective hyphenation, commas, capitalization, spelling, etc. To improve readability, some run-on sentences or sentence fragments were revised. [zj: remove the space from 'file name', 'host name', and 'time zone'.]

man/os-release: Add BUILD_ID field BUILD_ID is a fairly generic field used to identify the system image that was used to install the distribution.

Reword sentences that contain psuedo-English "resp." As you likely know, Arch Linux is in the process of moving to systemd. So I was reading through the various systemd docs and quickly became baffled by this new abbreviation "resp.", which I've never seen before in my English-mother-tongue life. Some quick Googling turned up a reference: <http://www.transblawg.eu/index.php?/archives/870-Resp.-and-other-non-existent-English-wordsNicht-existente-englische-Woerter.html> I guess it's a literal translation of the German "Beziehungsweise", but English doesn't work the same way. The word "respectively" is used exclusively to provide an ordering connection between two lists. E.g. "the prefixes k, M, and G refer to kilo-, mega-, and giga-, respectively." It is also never abbreviated to "resp." So the sentence "Sets the default output resp. error output for all services and sockets" makes no sense to a natural English speaker. This patch removes all instances of "resp." in the man pages and replaces them with sentences which are much more clear and, hopefully, grammatically valid. In almost all instances, it was simply replacing "resp." with "or," which the original author (Lennart?) could probably just do in the future. The only other instances of "resp." are in the src/ subtree, which I don't feel privileged to correct. Signed-off-by: Andrew Eikum <aeikum@codeweavers.com>

docs: typo fixes in logind.conf.xml and os-release.xml https://bugs.freedesktop.org/show_bug.cgi?id=54501

relicense to LGPLv2.1 (with exceptions) We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends.

man: clarify that applications must ignore unknown fields

man: document how os-release(5) may be extended by OS vendors

man: fix typo

man: allow that /etc/os-release is a symlink

man: add URL field definitions to os-release(5) As requested by Raphaël Hertzog from the Debian project, include information about the home page and support/bug report pages in /etc/os-release.

man: add ID_LIKE definition to os-release(5) As requested by Raphaël Hertzog from the Debian project, encode derivative information in /etc/os-release.

man: define more precisely the format of /etc/os-release

man: document CPE field in os-release file

man: we don't support systems without /etc/os-release anymore

man: it's probably a good idea to wrap the ANSI color in quotes, in order to allow proper shell parsing of the semicolon

man: clarify os-release in regards to spaces a bit

man: minor fixes

hostnamed: introduce systemd-hostnamed http://www.freedesktop.org/wiki/Software/systemd/hostnamed

Fix misspellings in os-release manpage and hwclock-load.service

man: make clear that VERSION and VERSION_ID is not mandatory in os-release.5

man: document /etc/os-release