]> git.ipfire.org Git - thirdparty/systemd.git/commit
man: use <simplelist> for file lists in synopsis
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Thu, 14 Dec 2023 11:52:03 +0000 (12:52 +0100)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 15 Dec 2023 13:27:28 +0000 (14:27 +0100)
commit73e97bb064387579e9af390cc52221892e319f90
tree095cde97188ff552f16c00be6462592b23a8aa22
parentf36c796e0fa4285d350b460ab72a6bec82d60a71
man: use <simplelist> for file lists in synopsis

With <para><filename>…</filename></para>, we get a separate "paragraph" for
each line, i.e. entries separated by empty lines. This uses up a lot of space
and was only done because docbook makes it hard to insert a newline. In some
other places, <literallayout> was used, but then we cannot indent the source
text (because the whitespace would end up in the final page). We can get the
desired result with <simplelist>.

With <simplelist> the items are indented in roff output, but not in html
output. In some places this looks better then no indentation, and in others it
would probably be better to have no indent. But this is a minor issue and we
cannot control that.

(I didn't convert all spots. There's a bunch of other man pages which have two
lines, e.g. an executable and service file, and it doesn't matter there so
much.)
33 files changed:
man/binfmt.d.xml
man/coredump.conf.xml
man/dnssec-trust-anchors.d.xml
man/environment.d.xml
man/homed.conf.xml
man/journal-remote.conf.xml
man/journald.conf.xml
man/logind.conf.xml
man/modules-load.d.xml
man/networkd.conf.xml
man/oomd.conf.xml
man/os-release.xml
man/repart.d.xml
man/resolved.conf.xml
man/sysctl.d.xml
man/systemd-ask-password-console.service.xml
man/systemd-fsck@.service.xml
man/systemd-journald.service.xml
man/systemd-sleep.conf.xml
man/systemd-stub.xml
man/systemd-suspend.service.xml
man/systemd-sysext.xml
man/systemd-tmpfiles.xml
man/systemd.environment-generator.xml
man/systemd.generator.xml
man/systemd.nspawn.xml
man/systemd.pcrlock.xml
man/systemd.preset.xml
man/systemd.unit.xml
man/sysupdate.d.xml
man/sysusers.d.xml
man/timesyncd.conf.xml
man/tmpfiles.d.xml