man: wording and grammar updates

This includes regularly-submitted corrections to comma setting and
orthographical mishaps that appeared in man/ in recent commits.

In this particular commit:
- the usual comma fixes
- expand contractions (this is prose)

diff --git a/man/journalctl.xml b/man/journalctl.xml
index b52caa47bfd6cf95562e3a2361e4bf66da376e27..a5778bf3696b9242b4702f46fabdc185253c00be 100644 (file)
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -281,7 +281,7 @@
                                                         <option>short-monotonic</option>
                                                 </term>
                                                 <listitem>
-                                                        <para>is very similar
+                                                        <para>is very similar,
                                                         but shows monotonic
                                                         timestamps instead of
                                                         wallclock timestamps.

diff --git a/man/sd_journal_get_cursor.xml b/man/sd_journal_get_cursor.xml
index 861927e2e1173795c68494529965b589ef37a630..4cee7d5b636069791d2d4a44ec18de86d35fa29c 100644 (file)
--- a/man/sd_journal_get_cursor.xml
+++ b/man/sd_journal_get_cursor.xml
@@ -120,7 +120,7 @@
                 returns 0 on success or a negative errno-style error
                 code. <function>sd_journal_test_cursor()</function>
                 returns positive if the current entry matches the
-                specified cursor, 0 if it doesn't match the specified
+                specified cursor, 0 if it does not match the specified
                 cursor or a negative errno-style error code on
                 failure.</para>
         </refsect1>

diff --git a/man/sd_journal_get_fd.xml b/man/sd_journal_get_fd.xml
index 1c6f25005eac5f82a09176700c7ae1f17001d96c..c4387b0856e341187053ac16dc03823d56099495 100644 (file)
--- a/man/sd_journal_get_fd.xml
+++ b/man/sd_journal_get_fd.xml
@@ -232,15 +232,15 @@ else {
                 <constant>SD_JOURNAL_APPEND</constant> or
                 <constant>SD_JOURNAL_INVALIDATE</constant> on success or
                 a negative errno-style error code. If
-                <constant>SD_JOURNAL_NOP</constant> is returned the
-                journal didn't change since the last invocation. If
-                <constant>SD_JOURNAL_APPEND</constant> is returned new
+                <constant>SD_JOURNAL_NOP</constant> is returned, the
+                journal did not change since the last invocation. If
+                <constant>SD_JOURNAL_APPEND</constant> is returned, new
                 entries have been appended to the end of the
-                journal. If <constant>SD_JOURNAL_INVALIDATE</constant>
+                journal. If <constant>SD_JOURNAL_INVALIDATE</constant>,
                 journal files were added or removed (possibly due to
-                rotation). In the latter event live-view UIs should
-                probably refresh their entire display while in the
-                case of <constant>SD_JOURNAL_APPEND</constant> it is
+                rotation). In the latter event, live-view UIs should
+                probably refresh their entire display, while in the
+                case of <constant>SD_JOURNAL_APPEND</constant>, it is
                 sufficient to simply continue reading at the previous
                 end of the journal.</para>
         </refsect1>

diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index 7d9689039727a4214b6908747cbfc15211f367dd..fc0f2f69273f0377cf56f2f8cf62f49857e692f5 100644 (file)
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -200,7 +200,7 @@
                 the status was sent these functions return with a
                 positive return value. In order to support both, init
                 systems that implement this scheme and those which
-                don't, it is generally recommended to ignore the return
+                do not, it is generally recommended to ignore the return
                 value of this call.</para>
         </refsect1>
 

diff --git a/man/shutdown.xml b/man/shutdown.xml
index af799c66490365a27894d8b52bc37061fcf073e3..795fb6632881b84863d4925f074d2f4a385be0d5 100644 (file)
--- a/man/shutdown.xml
+++ b/man/shutdown.xml
@@ -133,7 +133,7 @@
                         <varlistentry>
                                 <term><option>-k</option></term>
 
-                                <listitem><para>Don't halt, power-off,
+                                <listitem><para>Do not halt, power-off,
                                 reboot, just write wall
                                 message.</para></listitem>
                         </varlistentry>
@@ -141,7 +141,7 @@
                         <varlistentry>
                                 <term><option>--no-wall</option></term>
 
-                                <listitem><para>Don't send wall
+                                <listitem><para>Do not send wall
                                 message before
                                 halt, power-off, reboot.</para></listitem>
                         </varlistentry>

diff --git a/man/systemd-backlight@.service.xml b/man/systemd-backlight@.service.xml
index f2f54728a3f872576be3ca4dadeaeb813c9b1356..2b73625e91ae19bf7c1358521bbb92354b8fb6d5 100644 (file)
--- a/man/systemd-backlight@.service.xml
+++ b/man/systemd-backlight@.service.xml
@@ -57,9 +57,9 @@
                 <para><filename>systemd-backlight@.service</filename>
                 is a service that restores the display backlight
                 brightness at early-boot and saves it at shutdown. On
-                disk the backlight brightness is stored in
+                disk, the backlight brightness is stored in
                 <filename>/var/lib/backlight/</filename>. Note that by
-                default only firmware backlight devices are
+                default, only firmware backlight devices are
                 saved/restored.</para>
         </refsect1>
 

diff --git a/man/systemd-cgls.xml b/man/systemd-cgls.xml
index 53e7f7ddd8f0534475dbfd2662b7eac782ea4876..2877f22126ee09b04d70a9e73d10ca54071d3308 100644 (file)
--- a/man/systemd-cgls.xml
+++ b/man/systemd-cgls.xml
@@ -107,7 +107,7 @@
                         <varlistentry>
                                 <term><option>--all</option></term>
 
-                                <listitem><para>Don't hide empty
+                                <listitem><para>Do not hide empty
                                 control groups in the
                                 output.</para></listitem>
                         </varlistentry>

diff --git a/man/systemd-efi-boot-generator.xml b/man/systemd-efi-boot-generator.xml
index 03a4fdd0b83d65dc94dc705e4c011fe7755ea29d..3a79dfb8df020954b104a3417281c4526055a695 100644 (file)
--- a/man/systemd-efi-boot-generator.xml
+++ b/man/systemd-efi-boot-generator.xml
@@ -56,7 +56,7 @@
 
                 <para><filename>systemd-efi-boot-generator</filename>
                 is a generator that automatically creates mount and
-                automount units for the EFI System Partition (ESP)
+                automount units for the EFI System Partition (ESP),
                 mounting it to <filename>/boot</filename>. Note that
                 this generator will execute no operation on non-EFI
                 systems, on systems where the boot loader does not
@@ -64,7 +64,7 @@
                 <filename>/boot</filename> is an explicitly configured
                 mount (for example, listed in <citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>) or where the <filename>/boot</filename> mount
                 point is non-empty. Since this generator creates an
-                automount unit the mount will only be activated
+                automount unit, the mount will only be activated
                 on-demand, when accessed.</para>
 
                 <para><filename>systemd-efi-boot-generator</filename>

diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml
index e55933d069d9b341dacf4ba8e48370e701cb18c0..6264e48dbc9b69abf5310e3d6b0a59b355666b95 100644 (file)
--- a/man/systemd-nspawn.xml
+++ b/man/systemd-nspawn.xml
@@ -334,7 +334,7 @@
                                 <filename>/var/log/journal</filename>
                                 exists, it will be bind mounted
                                 into the container. If the
-                                subdirectory doesn't exist, no
+                                subdirectory does not exist, no
                                 linking is performed. Effectively,
                                 booting a container once with
                                 <literal>guest</literal> or

diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index b761832ed6bbdca94debe5df33cdb579d4c0376f..2c673a2a968bb0fbd05683ee3bea48309abbdba8 100644 (file)
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -1,4 +1,3 @@
-<?xml version='1.0'?> <!--*-nxml-*-->
 <?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
         "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
@@ -327,8 +326,8 @@
                                 absolute filename or wildcard
                                 expression, optionally prefixed with
                                 <literal>-</literal>, which indicates
-                                that if the file does not exist it
-                                won't be read and no error or warning
+                                that if the file does not exist, it
+                                will not be read and no error or warning
                                 message is logged.  This option may be
                                 specified more than once in which case
                                 all specified files are read. If the
@@ -835,7 +834,7 @@
                                 <varname>InaccessibleDirectories=</varname>
                                 may be prefixed with
                                 <literal>-</literal>, in which case
-                                they will be ignored when they don't
+                                they will be ignored when they do not
                                 exist.</para></listitem>
                         </varlistentry>
 
@@ -972,7 +971,7 @@
                                 <function>sigreturn</function>,
                                 <function>exit_group</function>,
                                 <function>exit</function> system calls
-                                are implicitly whitelisted and don't
+                                are implicitly whitelisted and do not
                                 need to be listed explicitly. This
                                 option may be specified more than once
                                 in which case the filter masks are

diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml
index 452406c676f2c04c7f870b3e80d4268d7d9ae370..cffcccb53efa8c20072321ddd264c90113d98a6e 100644 (file)
--- a/man/systemd.journal-fields.xml
+++ b/man/systemd.journal-fields.xml
@@ -525,7 +525,7 @@
                 url="http://www.freedesktop.org/wiki/Software/systemd/json">Journal
                 JSON Format</ulink>, the addresses of journal entries
                 are serialized into fields prefixed with double
-                underscores. Note that these aren't proper fields when
+                underscores. Note that these are not proper fields when
                 stored in the journal but for addressing meta data of
                 entries. They cannot be written as part of structured
                 log entries via calls such as

diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml
index 214f40c74296aecd0a35720f879994b1dd38b3dc..9aac94e1a1a00697b51220506917228f645c0132 100644 (file)
--- a/man/systemd.mount.xml
+++ b/man/systemd.mount.xml
@@ -84,7 +84,7 @@
                 using configuration not specified in
                 <filename>/etc/fstab</filename>;
                 <citerefentry><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
-                will refuse options that aren't listed in
+                will refuse options that are not listed in
                 <filename>/etc/fstab</filename> if it is not run as
                 UID 0.</para>
 

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 238a49a2512c610910b27b6c01369b487839f5f9..5df554ca12d6f3a22ce7d23a300ad7e54aacbfc5 100644 (file)
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -483,7 +483,7 @@
                                 was stopped. This includes cases where
                                 the commands configured in
                                 <varname>ExecStop=</varname> were used,
-                                where the service doesn't have any
+                                where the service does not have any
                                 <varname>ExecStop=</varname> defined, or
                                 where the service exited unexpectedly. This
                                 argument takes multiple command lines,
@@ -823,7 +823,7 @@
                                 in other words: the
                                 <varname>Service=</varname> setting of
                                 <filename>.socket</filename> units
-                                doesn't have to match the inverse of
+                                does not have to match the inverse of
                                 the <varname>Sockets=</varname>
                                 setting of the
                                 <filename>.service</filename> it

diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 2900808ef4e42c9f3475fab4cd9b39599905755d..4d0660714531f45d3227de3a5e258fdb0d6e45f8 100644 (file)
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -448,7 +448,7 @@
                                         after it. Note that networking
                                         daemons that simply provide
                                         functionality to other hosts
-                                        generally don't need to pull
+                                        generally do not need to pull
                                         this in.</para>
                                         </listitem>
                         </varlistentry>

diff --git a/man/systemd.time.xml b/man/systemd.time.xml
index 4f6dd0f0865f34e9f681be3b68ecb0f235212445..3d13b573fa46ee8c1bb81e085375308205917712 100644 (file)
--- a/man/systemd.time.xml
+++ b/man/systemd.time.xml
@@ -127,7 +127,7 @@
                 but when the weekday is specified it must either be
                 in the abbreviated (<literal>Wed</literal>) or
                 non-abbreviated (<literal>Wednesday</literal>) English
-                language form (case doesn't matter), and is not
+                language form (case does not matter), and is not
                 subject to the locale choice of the user. Either the
                 date, or the time part may be omitted, in which case
                 the current date or 00:00:00, resp., is assumed. The

diff --git a/man/systemd.xml b/man/systemd.xml
index 9f58bc2f8279a1e6e771192736d6dc5de5ac8913..47d6438939a12020142aa3db9ab86521f3f363ad 100644 (file)
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -1022,7 +1022,7 @@
                                 option prefixed with
                                 <literal>rd.</literal> is honored
                                 only in the initial RAM disk (initrd),
-                                while the one that isn't prefixed only
+                                while the one that is not prefixed only
                                 in the main system.</para></listitem>
                         </varlistentry>
 

diff --git a/man/telinit.xml b/man/telinit.xml
index 4c6064f54aeda1702ca09fdc25aa239b96ad8538..bb8093914ac5024e5287a4cda21c15c3231ab4e6 100644 (file)
--- a/man/telinit.xml
+++ b/man/telinit.xml
@@ -80,7 +80,7 @@
                         <varlistentry>
                                 <term><option>--no-wall</option></term>
 
-                                <listitem><para>Don't send wall
+                                <listitem><para>Do not send wall
                                 message before
                                 reboot/halt/power-off.</para></listitem>
                         </varlistentry>

diff --git a/man/timedatectl.xml b/man/timedatectl.xml
index 16ee3df4be7382c61cb6e67a26801726458bf81d..9aade29a787cc155d97002543b2c9f2a5c5d1e22 100644 (file)
--- a/man/timedatectl.xml
+++ b/man/timedatectl.xml
@@ -92,7 +92,7 @@
                         <varlistentry>
                                 <term><option>--no-ask-password</option></term>
 
-                                <listitem><para>Don't query the user
+                                <listitem><para>Do not query the user
                                 for authentication for privileged
                                 operations.</para></listitem>
                         </varlistentry>

diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 6a2193d67d637c3d768f42ebc625857756ed2d68..025c8018d94b3dd3b97a46583ada85051bf95e52 100644 (file)
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -104,7 +104,7 @@ L    /tmp/foobar -    -    -    -   /dev/null</programlisting>
                         <variablelist>
                                 <varlistentry>
                                         <term><varname>f</varname></term>
-                                        <listitem><para>Create a file if it doesn't exist yet (optionally writing a short string into it, if the argument parameter is passed)</para></listitem>
+                                        <listitem><para>Create a file if it does not exist yet (optionally writing a short string into it, if the argument parameter is passed)</para></listitem>
                                 </varlistentry>
 
                                 <varlistentry>
@@ -122,7 +122,7 @@ L    /tmp/foobar -    -    -    -   /dev/null</programlisting>
 
                                 <varlistentry>
                                         <term><varname>d</varname></term>
-                                        <listitem><para>Create a directory if it doesn't exist yet</para></listitem>
+                                        <listitem><para>Create a directory if it does not exist yet</para></listitem>
                                 </varlistentry>
 
                                 <varlistentry>
@@ -132,22 +132,22 @@ L    /tmp/foobar -    -    -    -   /dev/null</programlisting>
 
                                 <varlistentry>
                                         <term><varname>p</varname></term>
-                                        <listitem><para>Create a named pipe (FIFO) if it doesn't exist yet</para></listitem>
+                                        <listitem><para>Create a named pipe (FIFO) if it does not exist yet</para></listitem>
                                 </varlistentry>
 
                                 <varlistentry>
                                         <term><varname>L</varname></term>
-                                        <listitem><para>Create a symlink if it doesn't exist yet</para></listitem>
+                                        <listitem><para>Create a symlink if it does not exist yet</para></listitem>
                                 </varlistentry>
 
                                 <varlistentry>
                                         <term><varname>c</varname></term>
-                                        <listitem><para>Create a character device node if it doesn't exist yet</para></listitem>
+                                        <listitem><para>Create a character device node if it does not exist yet</para></listitem>
                                 </varlistentry>
 
                                 <varlistentry>
                                         <term><varname>b</varname></term>
-                                        <listitem><para>Create a block device node if it doesn't exist yet</para></listitem>
+                                        <listitem><para>Create a block device node if it does not exist yet</para></listitem>
                                 </varlistentry>
 
                                 <varlistentry>