man: fix typos

doc: correct orthography, word forms and missing/extraneous words

doc: correct punctuation and improve typography in documentation

man: fully document sd_bus_creds subsystem [@zonque: typo fixed, reported by @ronnychevalier]

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: always build sd-bus man pages, even if kdbus is disabled After all, we now moved sd-bus out of the kdbus conditional, hence the man pages should be too.

man: mention sd_bus_message_get_creds as another way of retrieving sd_bus_creds even though sd_bus_creds itself contains very limited information.

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.

treewide: Correct typos and spell plural of bus consistent

man: document when the sd_bus_creds_xxx() calls return ENXIO

man: fix indentation of copyright headers

man: no paren in link

man: fix name of systemd.journal-fields(7)

sd-bus: get rid of PID starttime concept As kdbus no longer exports this, remove all traces from sd-bus too

man: add emacs header to get correct indention in nxml-mode for the manpage XML files that use 2ch indenting In the long run we really should figure out if we want to stick with 8ch or 2ch indenting, and not continue with half-and-half. For now, just make emacs aware of the files that use 2ch indenting.

s/command-line/command line/g A follow-up to: commit 3f85ef0f05ffc51e19f86fb83a1c51e8e3cd6817 Author: Harald Hoyer <harald@redhat.com> Date: Thu Nov 6 15:33:48 2014 +0100 s/commandline/command line/g

sd-bus: rename sd_bus_get_owner_uid(), sd_bus_get_owner_machine_id() and sd_bus_get_peer_creds() Clean up the function namespace by renaming the following: sd_bus_get_owner_uid() → sd_bus_get_name_creds_uid() sd_bus_get_owner_machine_id() → sd_bus_get_name_machine_id() sd_bus_get_peer_creds() → sd_bus_get_owner_creds()

man: document sd_bus_creds_get_connection_name()

man: suffix C functions with ()

man: use <constant> markup for errno value We were inconsistent, but marking them up as constants makes more sense then as variables.

Fix a few more typos

man: add a mapping for external manpages It is annoying when we have dead links on fd.o. Add project='man-pages|die-net|archlinux' to <citerefentry>-ies. In generated html, add external links to http://man7.org/linux/man-pages/man, http://linux.die.net/man/, https://www.archlinux.org/. By default, pages in sections 2 and 4 go to man7, since Michael Kerrisk is the autorative source on kernel related stuff. The rest of links goes to linux.die.net, because they have the manpages. Except for the pacman stuff, since it seems to be only available from archlinux.org. Poor gummiboot gets no link, because gummitboot(8) ain't to be found on the net. According to common wisdom, that would mean that it does not exist. But I have seen Kay using it, so I know it does, and deserves to be found. Can somebody be nice and put it up somewhere?

build-sys: add conditionals and regenerate manpage list The list of man pages is auto generated, based on conditonal='...' attributes in the man page itself.

doc: balance C indirections in function prototypes Shift the asterisks in the documentation's prototypes such that they are consistent among each other. Use the right side to match source code.

doc: choose different words to improve clarity I suggest the following changes to improve the way the text reads ("flows").

doc: resolve missing/extraneous words or inappropriate forms Issues fixed: * missing words required by grammar * duplicated or extraneous words * inappropriate forms (e.g. singular/plural), and declinations * orthographic misspellings

doc: detail what "UID" is

man: use spaces instead of tabs Several sections of the man pages included intermixed tabs and spaces; this commit replaces all tabs with spaces.

nspawn,man: use a common vocabulary when referring to selinux security contexts Let's always call the security labels the same way: SMACK: "Smack Label" SELINUX: "SELinux Security Context" And the low-level encapsulation is called "seclabel". Now let's hope we stick to this vocabulary in future, too, and don't mix "label"s and "security contexts" and so on wildly.

libsystemd-bus: rename to libsystemd Documentation was updated to refer to either 'libsystemd' or 'sd-bus' in place of libsystemd-bus.

man: fix bogus description of sd_bus_creds_has_*_cap

man: document some more bus functions

man: document a batch of bus functions