From 9fccdb0f64d12bc09a71442dd0af2248c1aa3e89 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Fri, 14 Feb 2014 15:56:19 +0100 Subject: [PATCH] man: always place and in a line with actual sources, so that we don't get spurious newlines in the man page output --- man/daemon.xml | 3 +- man/kernel-install.xml | 8 ++--- man/nss-myhostname.xml | 12 +++---- man/sd_journal_get_fd.xml | 3 +- man/systemctl.xml | 3 +- man/systemd-delta.xml | 12 +++---- man/systemd-journal-gatewayd.service.xml | 16 +++------ man/systemd-run.xml | 3 +- man/systemd-sleep.conf.xml | 6 ++-- man/systemd-socket-proxyd.xml | 42 ++++++++---------------- man/systemd.service.xml | 13 +++----- man/timedatectl.xml | 18 ++++------ man/tmpfiles.d.xml | 7 ++-- 13 files changed, 47 insertions(+), 99 deletions(-) diff --git a/man/daemon.xml b/man/daemon.xml index 105826ac6..17d9dd6a2 100644 --- a/man/daemon.xml +++ b/man/daemon.xml @@ -777,8 +777,7 @@ AS_IF([test "x$with_systemdsystemunitdir" = "xyes" -o "x$with_systemdsystemunitd [with_systemdsystemunitdir=$def_systemdsystemunitdir])]) AS_IF([test "x$with_systemdsystemunitdir" != "xno"], [AC_SUBST([systemdsystemunitdir], [$with_systemdsystemunitdir])]) -AM_CONDITIONAL(HAVE_SYSTEMD, [test "x$with_systemdsystemunitdir" != "xno"]) - +AM_CONDITIONAL(HAVE_SYSTEMD, [test "x$with_systemdsystemunitdir" != "xno"]) This snippet allows automatic installation of the unit files on systemd diff --git a/man/kernel-install.xml b/man/kernel-install.xml index 929ceef4a..3612b7d93 100644 --- a/man/kernel-install.xml +++ b/man/kernel-install.xml @@ -90,9 +90,7 @@ along with systemd; If not, see . /usr/lib/kernel/install.d/*.install and /etc/kernel/install.d/*.install with the arguments - -add KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/ - + add KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/ The kernel-install plugin 50-depmod.install runs depmod for the KERNEL-VERSION. @@ -114,9 +112,7 @@ add KERNEL-VERSION /boot/MACHI Calls every executable /usr/lib/kernel/install.d/*.install and /etc/kernel/install.d/*.install with the arguments - -remove KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/ - + remove KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/ kernel-install removes the entire directory diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml index efbadac33..cca3a99aa 100644 --- a/man/nss-myhostname.xml +++ b/man/nss-myhostname.xml @@ -86,8 +86,7 @@ Example - -# /etc/nsswitch.conf +# /etc/nsswitch.conf passwd: compat group: compat @@ -101,20 +100,17 @@ services: db files ethers: db files rpc: db files -netgroup: nis - +netgroup: nis To test, use glibc's getent tool: - -$ getent ahosts `hostname` + $ getent ahosts `hostname` ::1 STREAM omega ::1 DGRAM ::1 RAW 127.0.0.2 STREAM 127.0.0.2 DGRAM -127.0.0.2 RAW - +127.0.0.2 RAW In this case the local hostname is omega. diff --git a/man/sd_journal_get_fd.xml b/man/sd_journal_get_fd.xml index 4b36f97af..df7632f9b 100644 --- a/man/sd_journal_get_fd.xml +++ b/man/sd_journal_get_fd.xml @@ -330,8 +330,7 @@ int wait_for_changes(sd_journal *j) { pollfd.events = sd_journal_get_events(j); poll(&pollfd, 1, msec); return sd_journal_process(j); -} - +} diff --git a/man/systemctl.xml b/man/systemctl.xml index 906399c3b..d78916ba7 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -555,8 +555,7 @@ LISTEN UNIT ACTIVATES [::]:22 sshd.socket sshd.service kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service -5 sockets listed. - +5 sockets listed. Note: because the addresses might contains spaces, this output is not suitable for programmatic consumption. diff --git a/man/systemd-delta.xml b/man/systemd-delta.xml index ebaa3492f..f802aa5eb 100644 --- a/man/systemd-delta.xml +++ b/man/systemd-delta.xml @@ -204,20 +204,16 @@ Examples To see all local configuration: - systemd-delta - + systemd-delta To see all runtime configuration: - systemd-delta /run - + systemd-delta /run To see all system unit configuration changes: - systemd-delta systemd/system - + systemd-delta systemd/system To see all runtime "drop-in" changes for system units: - systemd-delta --type=extended /run/systemd/system - + systemd-delta --type=extended /run/systemd/system diff --git a/man/systemd-journal-gatewayd.service.xml b/man/systemd-journal-gatewayd.service.xml index 0b6fd706a..f639811e3 100644 --- a/man/systemd-journal-gatewayd.service.xml +++ b/man/systemd-journal-gatewayd.service.xml @@ -154,14 +154,12 @@ along with systemd; If not, see . Return a JSON structure describing the machine. Example: - -{ "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446", + { "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446", "boot_id" : "3d3c9efaf556496a9b04259ee35df7f7", "hostname" : "fedora", "os_pretty_name" : "Fedora 19 (Rawhide)", "virtualization" : "kvm", - ...} - + ...} @@ -295,16 +293,12 @@ along with systemd; If not, see . in Journal Export Format: - -curl --silent -H'Accept: application/vnd.fdo.journal' \ - 'http://localhost:19531/entries?boot' - + curl --silent -H'Accept: application/vnd.fdo.journal' \ + 'http://localhost:19531/entries?boot' Listen for core dumps: - -curl 'http://localhost:19531/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1' - + curl 'http://localhost:19531/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1' diff --git a/man/systemd-run.xml b/man/systemd-run.xml index daf2bdcbb..4b67b7b5c 100644 --- a/man/systemd-run.xml +++ b/man/systemd-run.xml @@ -230,8 +230,7 @@ Sep 08 07:37:21 bupkis systemd[1]: Starting /usr/bin/env... Sep 08 07:37:21 bupkis systemd[1]: Started /usr/bin/env. Sep 08 07:37:21 bupkis env[19948]: PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin Sep 08 07:37:21 bupkis env[19948]: LANG=en_US.UTF-8 -Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3.11.0-0.rc5.git6.2.fc20.x86_64 - +Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3.11.0-0.rc5.git6.2.fc20.x86_64 diff --git a/man/systemd-sleep.conf.xml b/man/systemd-sleep.conf.xml index d4b07a0ca..a917f4d06 100644 --- a/man/systemd-sleep.conf.xml +++ b/man/systemd-sleep.conf.xml @@ -160,10 +160,8 @@ along with systemd; If not, see . Example: to exploit the freeze mode added in Linux 3.9, one can use systemctl suspend with - -[Sleep] -SuspendState=freeze - + [Sleep] +SuspendState=freeze diff --git a/man/systemd-socket-proxyd.xml b/man/systemd-socket-proxyd.xml index 4aef62005..8061466d8 100644 --- a/man/systemd-socket-proxyd.xml +++ b/man/systemd-socket-proxyd.xml @@ -113,26 +113,22 @@ and no namespace isolation. proxy-to-nginx.socket - - - +WantedBy=sockets.target]]> proxy-to-nginx.service - - - +PrivateNetwork=yes]]> nginx.conf @@ -145,11 +141,9 @@ server { Enabling the proxy - - - +$ curl http://localhost:80/]]> @@ -163,18 +157,15 @@ $ curl http://localhost:80/]]> too. proxy-to-nginx.socket - - - +WantedBy=sockets.target]]> proxy-to-nginx.service - - - +PrivateNetwork=yes]]> nginx.conf - - - + [...]]]> Enabling the proxy - - - +$ curl http://localhost:80/]]> diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 72b872bec..6e9b6696f 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -442,12 +442,9 @@ be used, they need to be passed explicitly to a shell implementation of some kind. Example: - ExecStart=/bin/sh -c 'dmesg | tac' - - + ExecStart=/bin/sh -c 'dmesg | tac' Example: - ExecStart=/bin/echo one ; /bin/echo "two two" - + ExecStart=/bin/echo one ; /bin/echo "two two" This will execute /bin/echo two times, each time with one argument, @@ -460,8 +457,7 @@ Example: ExecStart=/bin/echo / >/dev/null & \; \ -/bin/ls - +/bin/ls This will execute /bin/echo with five arguments: /, @@ -472,8 +468,7 @@ Example: Environment="ONE=one" 'TWO=two two' -ExecStart=/bin/echo $ONE $TWO ${TWO} - +ExecStart=/bin/echo $ONE $TWO ${TWO} This will execute /bin/echo with four arguments: one, diff --git a/man/timedatectl.xml b/man/timedatectl.xml index 6bf277d69..a82e6468c 100644 --- a/man/timedatectl.xml +++ b/man/timedatectl.xml @@ -233,8 +233,7 @@ Examples Show current settings: - -$ timedatectl + $ timedatectl Local time: Fri, 2012-11-02 09:26:46 CET Universal time: Fri, 2012-11-02 08:26:46 UTC RTC time: Fri, 2012-11-02 08:26:45 @@ -250,27 +249,22 @@ NTP synchronized: no Next DST change: CET → CEST, DST will become active the clock will jump one hour forward Sun, 2013-03-31 01:59:59 CET - Sun, 2013-03-31 03:00:00 CEST - + Sun, 2013-03-31 03:00:00 CEST Enable an NTP daemon (chronyd): - -$ timedatectl set-ntp true + $ timedatectl set-ntp true ==== AUTHENTICATING FOR org.freedesktop.timedate1.set-ntp === Authentication is required to control whether network time synchronization shall be enabled. Authenticating as: user Password: ******** -==== AUTHENTICATION COMPLETE === - +==== AUTHENTICATION COMPLETE === - -$ systemctl status chronyd.service + $ systemctl status chronyd.service chronyd.service - NTP client/server Loaded: loaded (/usr/lib/systemd/system/chronyd.service; enabled) Active: active (running) since Fri, 2012-11-02 09:36:25 CET; 5s ago -... - +... diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index a304dd00e..812129f61 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -109,7 +109,6 @@ d /run/user 0755 root root 10d - L /tmp/foobar - - - - /dev/null - Type @@ -277,13 +276,11 @@ L /tmp/foobar - - - - /dev/null For example: - -# Make sure these are created by default so that nobody else can + # Make sure these are created by default so that nobody else can d /tmp/.X11-unix 1777 root root 10d # Unlink the X11 lock files -r! /tmp/.X[0-9]*-lock - +r! /tmp/.X[0-9]*-lock The second line in contrast to the first one would break a running system, and will only be executed with . -- 2.30.2