man: include the target name when linking to man pages in html output Links like http://www.freedesktop.org/software/systemd/man/systemd.socket.html are changed to http://www.freedesktop.org/software/systemd/man/systemd.socket.html#Accept=. This implementation is quick & dirty, and misses various corner cases. A fairly important one is that when a few directives share the same anchor (which happens when multiple directives are described in the same paragraph), generated links for everything except the first one link to an invalid anchor. Another shortcoming is that the formatting does not use the proper generateID machinery, so the anchor name could be wrong in some cases. But it seems to work for a large percentage of links, so seems to be an improvement in usability. When the anchor is missing, we land at the top of the page, which is the same as before. If the anchor were to point to different spot, this would be more confusing... Not sure if that ever happens. Anyway, the user should be able to recover from landing on the wrong place in the page. (Mostly) fixes https://github.com/systemd/systemd/issues/1956.

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

doc: correct punctuation and improve typography in documentation

man: typo fixes

doc: configure docbook stylesheet to generate reproducible IDs This makes auto generated anchor tags in HTML output reproducible.

Use a top-to-bottom numbering scheme for generating ids of subheadings and terms. This scheme fixes permalinks to distinguish between items that would previously have the same ID attribute. Where possible the generated ID values are the same as those generated with the previous versions of the stylesheet to retain backwards compatibility with published links. As a side effect of the changes xsltproc should no longer complain about duplicate IDs during build.

Remove python-systemd python-system has moved to it's own repository: https://github.com/systemd/python-systemd

man: remove stray · from header

remove gudev and gtk-doc The library moved to: https://git.gnome.org/browse/libgudev/

man: link to fd.o for dbus stuff

man: link to freebsd.org for inetd(8)

bootctl: add sd-boot support

man: switch yum to dnf for Fedora The dnf name is here to stay, we might as well adjust.

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?

man: always supply quotes around literals When manpages are displayed on a terminal, <literal>s are indistinguishable from surrounding text. Add quotes everywhere, remove duplicate quotes, and tweak a few lists for consistent formatting. https://bugzilla.redhat.com/show_bug.cgi?id=874631

man: add permalinks to subsection titles too

man: provide "permalinks" to sections and terms So no one needs to say "go to fd.o/software/systemd/man, open page X, then scroll down to section 3, and look for ..." anymore.

man,html: say 'systemd 198' in the header This should help readers of the man or HTML pages know if the documentation is out of date. An alternative to use a date generated from 'git log' was considered, but since we try to keep user visible documentation up to date, showing the project version should be enough.

man/*.html: link to directives, python, guvev, libudev in headers Since the HTML files are in different directories during build and on fd.o, links are broken in the build directory. This could be fixed by moving stuff around, or by modifying the files during upload, but I think that people do not usually create HTML files for local browsing, and this is not necessary.

man: html - cross-ref man page references and add Index link

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: switch to UTF-8 output, to work around charset issues