[systemd-devel] [PATCH 2/4] doc: comma placement corrections and word order

Jan Engelhardt jengelh at inai.de
Wed May 7 16:28:45 PDT 2014


Set commas where there should be some.
Some improvements to word order.
---
 NEWS                                         | 38 ++++++++++++++--------------
 README                                       |  2 +-
 man/logind.conf.xml                          |  4 +--
 man/sd_bus_error.xml                         |  4 +--
 man/sd_bus_message_append.xml                |  2 +-
 man/sd_bus_message_append_array.xml          | 22 ++++++++--------
 man/sd_bus_message_append_basic.xml          |  4 +--
 man/sd_bus_message_append_string_memfd.xml   | 18 ++++++-------
 man/sd_bus_message_append_strv.xml           |  8 +++---
 man/sd_bus_negotiate_fds.xml                 | 22 ++++++++--------
 man/sd_bus_path_encode.xml                   | 18 ++++++-------
 man/sd_event_add_time.xml                    |  6 ++---
 man/sd_event_new.xml                         | 16 ++++++------
 man/systemctl.xml                            | 10 ++++----
 man/systemd-gpt-auto-generator.xml           | 10 ++++----
 man/systemd-journal-remote.xml               | 20 +++++++--------
 man/systemd-networkd-wait-online.service.xml |  4 +--
 man/systemd-nspawn.xml                       |  4 +--
 man/systemd-run.xml                          |  4 +--
 man/systemd.exec.xml                         | 14 +++++-----
 man/systemd.link.xml                         |  2 +-
 man/systemd.network.xml                      |  2 +-
 man/systemd.timer.xml                        |  2 +-
 man/systemd.unit.xml                         |  2 +-
 man/tmpfiles.d.xml                           |  2 +-
 25 files changed, 120 insertions(+), 120 deletions(-)

diff --git a/NEWS b/NEWS
index 1b548f5..f90d7f8 100644
--- a/NEWS
+++ b/NEWS
@@ -60,9 +60,9 @@ CHANGES WITH 212:
           users who are logged out cannot continue to consume IPC
           resources. This covers SysV memory, semaphores and message
           queues as well as POSIX shared memory and message
-          queues. Traditionally SysV and POSIX IPC had no life-cycle
-          limits, with this functionality this is corrected. This may
-          be turned off using the RemoveIPC= switch of logind.conf.
+          queues. Traditionally, SysV and POSIX IPC had no life-cycle
+          limits. With this functionality, that is corrected. This may
+          be turned off by using the RemoveIPC= switch of logind.conf.
 
         * The systemd-machine-id-setup and tmpfiles tools gained a
           --root= switch to operate on a specific root directory,
@@ -95,7 +95,7 @@ CHANGES WITH 212:
           this is appropriate.
 
         * systemd-udevd will now run in a disassociated mount
-          namespace. To mount directories from udev rules make sure to
+          namespace. To mount directories from udev rules, make sure to
           pull in mount units via SYSTEMD_WANTS properties.
 
         * The kdbus support gained support for uploading policy into
@@ -118,12 +118,12 @@ CHANGES WITH 212:
           DefaultTimerAccuracySec= has been added that controls the
           default AccuracySec= setting of .timer units.
 
-        * Timer units gained a new WakeSystem= switch. If enabled
+        * Timer units gained a new WakeSystem= switch. If enabled,
           timers configured this way will cause the system to resume
           from system suspend (if the system supports that, which most
           do these days).
 
-        * Timer units gained a new Persistent= switch. If enabled
+        * Timer units gained a new Persistent= switch. If enabled,
           timers configured this way will save to disk when they have
           been last triggered. This information is then used on next
           reboot to possible execute overdue timer events, that
@@ -181,12 +181,12 @@ CHANGES WITH 211:
         * systemd-gpt-auto-generator is now able to discover /srv and
           root partitions in addition to /home and swap partitions. It
           also supports LUKS-encrypted partitions now. With this in
-          place automatic discovery of partitions to mount following
+          place, automatic discovery of partitions to mount following
           the Discoverable Partitions Specification
           (http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec)
           is now a lot more complete. This allows booting without
           /etc/fstab and without root= on the kernel command line on
-          appropriately prepared systems.
+          systems prepared appropriately.
 
         * systemd-nspawn gained a new --image= switch which allows
           booting up disk images and Linux installations on any block
@@ -291,11 +291,11 @@ CHANGES WITH 210:
 
         * logind is now a lot more aggressive when suspending the
           machine due to a closed laptop lid. Instead of acting only
-          on the lid close action it will continuously watch the lid
+          on the lid close action, it will continuously watch the lid
           status and act on it. This is useful for laptops where the
           power button is on the outside of the chassis so that it can
           be reached without opening the lid (such as the Lenovo
-          Yoga). On those machines logind will now immediately
+          Yoga). On those machines, logind will now immediately
           re-suspend the machine if the power button has been
           accidentally pressed while the laptop was suspended and in a
           backpack or similar.
@@ -332,7 +332,7 @@ CHANGES WITH 210:
         * The DeviceAllow= setting in unit files now supports a syntax
           to whitelist an entire group of devices node majors at once,
           based on the /proc/devices listing. For example, with the
-          string "char-pts" it is now possible to whitelist all
+          string "char-pts", it is now possible to whitelist all
           current and future pseudo-TTYs at once.
 
         * sd-event learned a new "post" event source. Event sources of
@@ -346,20 +346,20 @@ CHANGES WITH 210:
           enabled/disabled using systemctl. It still is enabled by
           default however.
 
-        * When creating a veth interface pair with systemd-nspawn the
+        * When creating a veth interface pair with systemd-nspawn, the
           host side will now be prefixed with "vb-" if
           --network-bridge= is used, and with "ve-" if --network-veth
-          is used. This way it is easy to distinguish these cases on
+          is used. This way, it is easy to distinguish these cases on
           the host, for example to apply different configuration to
           them with systemd-networkd.
 
         * The compatibility libraries for libsystemd-journal.so,
           libsystem-id128.so, libsystemd-login.so and
           libsystemd-daemon.so do not make use of IFUNC
-          anymore. Instead we now build libsystemd.so multiple times
+          anymore. Instead, we now build libsystemd.so multiple times
           under these alternative names. This means that the footprint
           is drastically increased, but given that these are
-          transitional compatibility libraries this should not matter
+          transitional compatibility libraries, this should not matter
           much. This change has been made necessary to support the ARM
           platform for these compatibility libraries, as the ARM
           toolchain is not really at the same level as the toolchain
@@ -770,8 +770,8 @@ CHANGES WITH 209:
         * systemd-nspawn gained a new --personality= switch for
           setting the kernel personality for the container. This is
           useful when running a 32-bit container on a 64-bit host. A
-          similar option Personality= is now also available in service
-          units.
+          similar option Personality= is now also available for service
+          units to use.
 
         * logind will now also track a "Desktop" identifier for each
           session which encodes the desktop environment of it. This is
@@ -795,8 +795,8 @@ CHANGES WITH 209:
 
         * For usage together with SystemCallFilter=, a new
           SystemCallErrorNumber= setting has been introduced that
-          allows configuration of a system error number to return on
-          filtered system calls, instead of immediately killing the
+          allows configuration of a system error number to be returned
+          on filtered system calls, instead of immediately killing the
           process. Also, SystemCallArchitectures= has been added to
           limit access to system calls of a particular architecture
           (in order to turn off support for unused secondary
diff --git a/README b/README
index ef8c620..4358cd7 100644
--- a/README
+++ b/README
@@ -200,7 +200,7 @@ WARNINGS:
         supported anymore by the basic set of Linux OS components.
 
         systemd requires that the /run mount point exists. systemd also
-        requires that /var/run is a a symlink → /run.
+        requires that /var/run is a a symlink to /run.
 
         For more information on this issue consult
         http://freedesktop.org/wiki/Software/systemd/separate-usr-is-broken
diff --git a/man/logind.conf.xml b/man/logind.conf.xml
index 9914091..1293e71 100644
--- a/man/logind.conf.xml
+++ b/man/logind.conf.xml
@@ -312,7 +312,7 @@
                                 physical RAM. Defaults to 10%. Note
                                 that this size is a safety limit
                                 only. As each runtime directory is a
-                                tmpfs file system it will only consume
+                                tmpfs file system, it will only consume
                                 as much memory as it is filled up
                                 to.</para></listitem>
                         </varlistentry>
@@ -324,7 +324,7 @@
                                 System V and POSIX IPC objects
                                 belonging to the user shall be removed
                                 when she or he fully logs out. Takes a
-                                boolean argument. If enabled the user
+                                boolean argument. If enabled, the user
                                 may not consume IPC resources after
                                 the last of his sessions
                                 terminated. This covers System V
diff --git a/man/sd_bus_error.xml b/man/sd_bus_error.xml
index 68f1d7b..9be4747 100644
--- a/man/sd_bus_error.xml
+++ b/man/sd_bus_error.xml
@@ -232,8 +232,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     <title>Description</title>
 
     <para>The <structname>sd_bus_error</structname> structure carries
-    information for a <filename>sd-bus</filename> error.
-    Functions described below can be used to set and query fields in
+    information for a <filename>sd-bus</filename> error. The
+    functions described below can be used to set and query fields in
     this structure. The <structfield>name</structfield> field contains a
     short identifier of an error. It should follow the rules for error
     names described in the D-Bus specification, subsection <ulink
diff --git a/man/sd_bus_message_append.xml b/man/sd_bus_message_append.xml
index 2a1e95a..b14a6c9 100644
--- a/man/sd_bus_message_append.xml
+++ b/man/sd_bus_message_append.xml
@@ -65,7 +65,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Description</title>
 
-    <para>Function <function>sd_bus_message_append</function> appends
+    <para>The <function>sd_bus_message_append</function> function appends
     a sequence of items to message <parameter>m</parameter>. The
     format string <parameter>types</parameter> describes the types of
     arguments that follow.</para>
diff --git a/man/sd_bus_message_append_array.xml b/man/sd_bus_message_append_array.xml
index fe84671..455e1bb 100644
--- a/man/sd_bus_message_append_array.xml
+++ b/man/sd_bus_message_append_array.xml
@@ -91,7 +91,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Description</title>
 
-    <para>Function <function>sd_bus_message_append_array</function>
+    <para>The <function>sd_bus_message_append_array</function> functionc
     appends items to message <parameter>m</parameter> as the single
     array. A container will be opened, items appended, and the
     container closed. Parameter <parameter>type</parameter> determines
@@ -116,19 +116,19 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     into the memory area containing the message and may be changed
     after this call.</para>
 
-    <para>Function
-    <function>sd_bus_message_append_array_memfd</function> appends
+    <para>The
+    <function>sd_bus_message_append_array_memfd</function> function appends
     items to message <parameter>m</parameter>, similarly to
     <function>sd_bus_message_append_array</function>. Contents of the
     memory file descriptor <parameter>memfd</parameter> are used as
     the contents of the array. Their size must be a multiple of the
     size of the type <parameter>type</parameter>.</para>
 
-    <para>Descriptor <parameter>memfd</parameter> will be sealed
-    and cannot be modified after this call.</para>
+    <para>The descriptor specified with <parameter>memfd</parameter>
+    will be sealed and cannot be modified after this call.</para>
 
-    <para>Function
-    <function>sd_bus_message_append_array_iovec</function> appends
+    <para>The
+    <function>sd_bus_message_append_array_iovec</function> function appends
     items to message <parameter>m</parameter>, similarly to
     <function>sd_bus_message_append_array</function>. Contents of the
     iovec <parameter>iov</parameter> are used as the contents of the
@@ -136,7 +136,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     sum of <structfield>iov_len</structfield> fields) must be a multiple
     of the size of the type <parameter>type</parameter>.</para>
 
-    <para>Pointer <parameter>iov</parameter> must point to
+    <para>The <parameter>iov</parameter> argument must point to
     <parameter>n</parameter> <structname>struct iovec</structname>
     structures. Each structure may have the
     <structname>iov_base</structname> field set, in which case the
@@ -146,8 +146,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     memory pointed at by <parameter>iov</parameter> may be changed
     after this call.</para>
 
-    <para>Function
-    <function>sd_bus_message_append_array_space</function> appends
+    <para>The
+    <function>sd_bus_message_append_array_space</function> function appends
     space for an array of items to message <parameter>m</parameter>.
     It behaves the same as
     <function>sd_bus_message_append_array</function>, but instead
@@ -159,7 +159,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Return Value</title>
 
-    <para>On success, those calls return 0 or a positive integer. On
+    <para>On success, these calls return 0 or a positive integer. On
     failure, they returns a negative errno-style error code.</para>
   </refsect1>
 
diff --git a/man/sd_bus_message_append_basic.xml b/man/sd_bus_message_append_basic.xml
index a8e91f9..68e1191 100644
--- a/man/sd_bus_message_append_basic.xml
+++ b/man/sd_bus_message_append_basic.xml
@@ -198,7 +198,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     character sequence. As a special case, a <constant>NULL</constant>
     pointer is interpreted as an empty string. The string should be
     valid Unicode string encoded as UTF-8. In case of the two latter
-    types, additionally the requirements for a D-Bus object path or
+    types, the additional requirements for a D-Bus object path or
     type signature should be satisfied. Those requirements should be
     verified by the recepient of the message.
     </para>
@@ -257,7 +257,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Notes</title>
 
-    <para><function>sd_bus_append_basic()</function> function
+    <para>The <function>sd_bus_append_basic()</function> function
     described here is available as a shared library, which can be
     compiled and linked to with the
     <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
diff --git a/man/sd_bus_message_append_string_memfd.xml b/man/sd_bus_message_append_string_memfd.xml
index bf185ef..b44c482 100644
--- a/man/sd_bus_message_append_string_memfd.xml
+++ b/man/sd_bus_message_append_string_memfd.xml
@@ -80,27 +80,27 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Description</title>
 
-    <para>Functions
+    <para>The functions
     <function>sd_bus_message_append_string_memfd</function> and
     <function>sd_bus_message_append_string_iovec</function> can be
     used to append a single string (item of type <literal>s</literal>)
     to message <parameter>m</parameter>.</para>
 
     <para>In case of
-    <function>sd_bus_message_append_string_memfd</function> the
+    <function>sd_bus_message_append_string_memfd</function>, the
     contents of <parameter>memfd</parameter> are the string. They must
     satisfy the same constraints as described for the
     <literal>s</literal> type in
     <citerefentry><refentrytitle>sd_bus_message_append_basic</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
 
     <para>In case of
-    <function>sd_bus_message_append_string_iovec</function> the
+    <function>sd_bus_message_append_string_iovec</function>, the
     payload of <parameter>iov</parameter> is the string. It must
     satisfy the same constraints as described for the
     <literal>s</literal> type in
     <citerefentry><refentrytitle>sd_bus_message_append_basic</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
 
-    <para>Pointer <parameter>iov</parameter> must point to
+    <para>The <parameter>iov</parameter> argument must point to
     <parameter>n</parameter> <structname>struct iovec</structname>
     structures. Each structure may have the
     <structname>iov_base</structname> field set, in which case the
@@ -110,10 +110,10 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     memory pointed at by <parameter>iov</parameter> may be changed
     after this call.</para>
 
-    <para>Function
-    <function>sd_bus_message_append_string_space</function> appends
-    space for a string to message <parameter>m</parameter>. If behaves
-    similarly to <function>sd_bus_message_append_basic</function> with
+    <para>The
+    <function>sd_bus_message_append_string_space</function> function appends
+    space for a string to message <parameter>m</parameter>. It behaves
+    similar to <function>sd_bus_message_append_basic</function> with
     type <literal>s</literal>, but instead of copying a string into
     the message, it returns a pointer to the destination area to
     the caller in pointer <parameter>p</parameter>. Space for the string
@@ -133,7 +133,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Notes</title>
 
-    <para>Functions described here are available as a shared library,
+    <para>The functions described here are available as a shared library,
     which can be compiled and linked to with the
     <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
     file.</para>
diff --git a/man/sd_bus_message_append_strv.xml b/man/sd_bus_message_append_strv.xml
index 4fb1390..a4e8350 100644
--- a/man/sd_bus_message_append_strv.xml
+++ b/man/sd_bus_message_append_strv.xml
@@ -64,10 +64,10 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Description</title>
 
-    <para>Function <function>sd_bus_message_append</function> can be
+    <para>The <function>sd_bus_message_append</function> function can be
     used to append an array of strings to message
-    <parameter>m</parameter>. Parameter <parameter>l</parameter>
-    points to a <constant>NULL</constant>-terminated array of pointers
+    <parameter>m</parameter>. The parameter <parameter>l</parameter>
+    shall point to a <constant>NULL</constant>-terminated array of pointers
     to <constant>NUL</constant>-terminated strings. Each string must
     satisfy the same constraints as described for the
     <literal>s</literal> type in
@@ -94,7 +94,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Notes</title>
 
-    <para><function>sd_bus_append_append_strv()</function> function
+    <para>The <function>sd_bus_append_append_strv()</function> function
     described here is available as a shared library, which can be
     compiled and linked to with the
     <constant>libsystemd</constant> <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
diff --git a/man/sd_bus_negotiate_fds.xml b/man/sd_bus_negotiate_fds.xml
index c206194..09563f8 100644
--- a/man/sd_bus_negotiate_fds.xml
+++ b/man/sd_bus_negotiate_fds.xml
@@ -79,35 +79,35 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
 
     <para><function>sd_bus_negotiate_fds()</function> controls whether
     file descriptor passing shall be negotiated for the specified bus
-    connection. Takes a bus object and a boolean, which when true
-    enables file descriptor passing, and when false disables it. Note
+    connection. It takes a bus object and a boolean, which, when true,
+    enables file descriptor passing, and, when false, disables it. Note
     that not all transports and servers support file descriptor
     passing. To find out whether file descriptor passing is available
-    after negotiation use
+    after negotiation, use
     <citerefentry><refentrytitle>sd_bus_can_send</refentrytitle><manvolnum>3</manvolnum></citerefentry>
     and pass <constant>SD_BUS_TYPE_UNIX_FD</constant>. Note that file
     descriptor passing is always enabled for both sending and
     receiving or for neither, but never only in one direction. By
-    default file descriptor passing is negotiated for all
+    default, file descriptor passing is negotiated for all
     connections.</para>
 
-    <para>Note that when bus activation is used it is highly
+    <para>Note that when bus activation is used, it is highly
     recommended to set the <option>AcceptFileDescriptors=</option>
     setting in the <filename>.busname</filename> unit file to the same
     setting as negotiated by the program ultimately activated. By
-    default file descriptor passing is enabled for both.</para>
+    default, file descriptor passing is enabled for both.</para>
 
     <para><function>sd_bus_negotiate_timestamps()</function> controls
     whether implicit sender timestamps shall be attached automatically
-    to all incoming messages. Takes a bus object and a boolean, which
-    when true enables timestamping, and when false disables it. If
+    to all incoming messages. Takes a bus object and a boolean, which,
+    when true, enables timestamping, and, when false, disables it. If
     this is disabled,
     <citerefentry><refentrytitle>sd_bus_message_get_monotonic_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
     <citerefentry><refentrytitle>sd_bus_message_get_realtime_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
     <citerefentry><refentrytitle>sd_bus_message_get_seqno</refentrytitle><manvolnum>3</manvolnum></citerefentry>
     fail with <constant>-ENODATA</constant> on incoming messages. Note
     that not all transports support timestamping of messages. On local
-    transports the timestamping is applied by the kernel and cannot be
+    transports, the timestamping is applied by the kernel and cannot be
     manipulated by userspace.</para>
 
     <para><function>sd_bus_negotiate_creds()</function> controls
@@ -119,9 +119,9 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     fails with <constant>-ENODATA</constant> on incoming
     messages. Note that not all transports support attaching sender
     credentials to messages, or do not support all types of sender
-    credential parameters. On local transports the sender credentials
+    credential parameters. On local transports, the sender credentials
     are attached by the kernel and cannot be manipulated by
-    userspace. By default no sender credentials are attached.</para>
+    userspace. By default, no sender credentials are attached.</para>
 
     <para>These functions may be called only before the connection has
     been started with
diff --git a/man/sd_bus_path_encode.xml b/man/sd_bus_path_encode.xml
index 7e11906..5849127 100644
--- a/man/sd_bus_path_encode.xml
+++ b/man/sd_bus_path_encode.xml
@@ -82,16 +82,16 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     prefix and an external identifier string as arguments, plus a
     place to store the returned bus path string. The bus path prefix
     must be a valid bus path, starting with a slash
-    <literal>/</literal>, but not ending in one. The external
-    identifier string may be in any format, may be the empty string
-    and no restrictions on the charset are made - however it must
+    <literal>/</literal>, and not ending in one. The external
+    identifier string may be in any format, may be the empty string,
+    and has no restrictions on the charset — however, it must
     always be <constant>NUL</constant>-terminated. The returned string
     will be the concatenation of the bus path prefix plus an escaped
     version of the external identifier string. This operation may be
     reversed with <function>sd_bus_decode()</function>. It is
-    recommended to only use external identifiers here that generally
+    recommended to only use external identifiers that generally
     require little escaping to be turned into valid bus path
-    identifiers (for example by sticking to a 7-bit ASCII character
+    identifiers (for example, by sticking to a 7-bit ASCII character
     set), in order to ensure the resulting bus path is still short and
     easily processed.</para>
 
@@ -101,12 +101,12 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     takes a bus path and a prefix string, plus a place to store the
     returned external identifier string. If the bus path does not
     start with the specified prefix, 0 is returned and the returned
-    string is set to <constant>NULL</constant>. Otherwise the
+    string is set to <constant>NULL</constant>. Otherwise, the
     string following the prefix is unescaped and returned in the
     external identifier string.</para>
 
     <para>The escaping used will replace all characters which are
-    invalid in a bus object path by <literal>_</literal> followed by a
+    invalid in a bus object path by <literal>_</literal>, followed by a
     hexadecimal value. As a special case, the empty string will be
     replaced by a lone <literal>_</literal>.</para>
   </refsect1>
@@ -118,8 +118,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     returns positive or 0, and a valid bus path in the return
     argument. On success, <function>sd_bus_path_decode()</function>
     returns a positive value if the prefixed matched, or 0 if it
-    did not. If the prefix matched the external identifier is returned
-    in the return parameter. If it did not match NULL is returned in
+    did not. If the prefix matched, the external identifier is returned
+    in the return parameter. If it did not match, NULL is returned in
     the return parameter. On failure, a negative errno-style error
     number is returned by either function. The returned strings must
     be
diff --git a/man/sd_event_add_time.xml b/man/sd_event_add_time.xml
index 9af8bb9..983e486 100644
--- a/man/sd_event_add_time.xml
+++ b/man/sd_event_add_time.xml
@@ -121,7 +121,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     accuracy value in microseconds specifying a time the timer event
     may be delayed. Specify 0 for selecting the default accuracy
     (250ms). Specify 1 for most accurate timers. Consider specifying
-    60000000 or larger (1h) for long running events that may be
+    60000000 or larger (1h) for long-running events that may be
     delayed substantially. Picking higher accuracy values allows the
     system to coalesce timer events more aggressively, thus improving
     power efficiency. The <parameter>handler</parameter> shall
@@ -132,10 +132,10 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     actually have been called at a slightly later time, subject to the
     specified accuracy value, the kernel timer slack (see
     <citerefentry><refentrytitle>prctl</refentrytitle><manvolnum>2</manvolnum></citerefentry>)
-    and additional scheduling latencies. By default the timer will
+    and additional scheduling latencies. By default, the timer will
     elapse once (SD_EVENT_ONESHOT), but this may be changed with
     <citerefentry><refentrytitle>sd_event_source_set_enabled</refentrytitle><manvolnum>3</manvolnum></citerefentry>. If
-    the handler function returns a negative error code it will be
+    the handler function returns a negative error code, it will be
     disabled after the invocation, even if SD_EVENT_ON mode is set.
     </para>
 
diff --git a/man/sd_event_new.xml b/man/sd_event_new.xml
index f25631f..35e58ea 100644
--- a/man/sd_event_new.xml
+++ b/man/sd_event_new.xml
@@ -83,24 +83,24 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
 
     <para><function>sd_event_new()</function> allocates a new event
     loop object. The event loop object is returned in the
-    <parameter>event</parameter> parameter. After use drop
+    <parameter>event</parameter> parameter. After use, drop
     the returned reference with
     <function>sd_event_unref()</function>. When the last reference is
-    dropped the event loop is freed.</para>
+    dropped, the event loop is freed.</para>
 
     <para><function>sd_event_default()</function> acquires a reference
     to the default event loop object of the calling thread, possibly
     allocating a new object if no default event loop object has been
-    allocated yet for the thread. After use drop the returned
+    allocated yet for the thread. After use, drop the returned
     reference with <function>sd_event_unref()</function>. When the
-    last reference is dropped the event loop is freed. If this
+    last reference is dropped, the event loop is freed. If this
     function is called while the object returned from a previous call
     from the same thread is still referenced, the same object is
     returned again, but the reference is increased by one. It is
     recommended to use this call instead of
     <function>sd_event_new()</function> in order to share event loop
     objects between various components that are dispatched in the same
-    thread. All threads either have no or one default event loops
+    thread. All threads either have exactly zero or one default event loop
     associated, but never more.</para>
 
     <para><function>sd_event_ref()</function> increases the reference
@@ -108,13 +108,13 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
 
     <para><function>sd_event_unref()</function> decreases the
     reference counter of the specified event loop object by one. If
-    the counter hits zero the event loop object is freed. Note that it
+    the counter hits zero, the event loop object is freed. Note that it
     is freed regardless of whether it is the default event loop object for a
     thread or not. This means that allocating an event loop with
-    <function>sd_event_default()</function>, then releasing it and
+    <function>sd_event_default()</function>, then releasing it, and
     then acquiring a new one with
     <function>sd_event_default()</function> will result in two
-    distinct objects. Note that in order to free an event loop object
+    distinct objects. Note that, in order to free an event loop object,
     all remaining event sources of the event loop also need to be
     freed as they each keep a reference to it.</para>
   </refsect1>
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 28a7cca..181de4f 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -385,17 +385,17 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
           control processes. Note that there is only one control
           process per unit at a time, as only one state change is
           executed at a time. For services of type
-          <varname>Type=forking</varname> the initial process started
+          <varname>Type=forking</varname>, the initial process started
           by the manager for <varname>ExecStart=</varname> is a
           control process, while the process ultimately forked off by
           that one is then considered the main process of the unit (if
           it can be determined). This is different for service units
           of other types, where the process forked off by the manager
           for <varname>ExecStart=</varname> is always the main process
-          itself. A service unit consists of no or one main process,
-          no or one control process plus any number of additional
+          itself. A service unit consists of zero or one main process,
+          zero or one control process plus any number of additional
           processes. Not all unit types manage processes of these
-          types however. For example for mount units control processes
+          types however. For example, for mount units, control processes
           are defined (which are the invocations of
           <filename>/usr/bin/mount</filename> and
           <filename>/usr/bin/umount</filename>), but no main process
@@ -724,7 +724,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
             <para>Show terse runtime status information about one or
             more units, followed by most recent log data from the
             journal. If no units are specified, show system status. If
-            combined with <option>--all</option> also show the status of
+            combined with <option>--all</option>, also show the status of
             all units (subject to limitations specified with
             <option>-t</option>). If a PID is passed, show information
             about the unit the process belongs to.</para>
diff --git a/man/systemd-gpt-auto-generator.xml b/man/systemd-gpt-auto-generator.xml
index 41b83dd..68fe270 100644
--- a/man/systemd-gpt-auto-generator.xml
+++ b/man/systemd-gpt-auto-generator.xml
@@ -106,22 +106,22 @@
                                         <row>
                                                 <entry>44479540-f297-41b2-9af7-d131d5f0458a</entry>
                                                 <entry><filename>Root Partition (x86)</filename></entry>
-                                                <entry>On 32-bit x86 systems the first x86 root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
+                                                <entry>On 32-bit x86 systems, the first x86 root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
                                         </row>
                                         <row>
                                                 <entry>4f68bce3-e8cd-4db1-96e7-fbcaf984b709</entry>
                                                 <entry><filename>Root Partition (x86-64)</filename></entry>
-                                                <entry>On 64-bit x86 systems the first x86-64 root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
+                                                <entry>On 64-bit x86 systems, the first x86-64 root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
                                         </row>
                                         <row>
                                                 <entry>69dad710-2ce4-4e3c-b16c-21a1d49abed3</entry>
                                                 <entry><filename>Root Partition (32-bit ARM)</filename></entry>
-                                                <entry>On 32-bit ARM systems the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
+                                                <entry>On 32-bit ARM systems, the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
                                         </row>
                                         <row>
                                                 <entry>b921b045-1df0-41c3-af44-4c6f280d3fae</entry>
                                                 <entry><filename>Root Partition (64-bit ARM)</filename></entry>
-                                                <entry>On 64-bit ARM systems the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
+                                                <entry>On 64-bit ARM systems, the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory <filename>/</filename>.</entry>
                                         </row>
                                         <row>
                                                 <entry>933ac7e1-2eb4-4f13-b844-0e14e2aef915</entry>
@@ -158,7 +158,7 @@
                 <filename>/boot</filename> if not otherwise mounted.</para>
 
                 <para>When using this generator in conjunction with
-                btrfs file systems make sure to set the correct
+                btrfs file systems, make sure to set the correct
                 default subvolumes on them, using <command>btrfs
                 subvolume set-default</command>.</para>
 
diff --git a/man/systemd-journal-remote.xml b/man/systemd-journal-remote.xml
index 1f0d93e..972c322 100644
--- a/man/systemd-journal-remote.xml
+++ b/man/systemd-journal-remote.xml
@@ -86,7 +86,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
       <command>systemd-journal-remote</command> can read more than one
       event stream at a time. They will be interleaved in the output
       file. In case of "active" connections, each "source" is one
-      stream, and in case of "passive" connections each connection can
+      stream, and in case of "passive" connections, each connection can
       result in a separate stream. Sockets can be configured in
       "accept" mode (i.e. only one connection), or "listen" mode (i.e.
       multiple connections, each resulting in a stream).
@@ -153,7 +153,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
         <varname>$LISTEN_FDS</varname>/<varname>$LISTEN_PID</varname>.
         In the second case, an HTTP or HTTPS server will be spawned on
         this port, respectively for <option>--listen-http</option> and
-        <option>--listen-https</option>. Currenntly Only POST requests
+        <option>--listen-https</option>. Currenntly, only POST requests
         to <filename>/upload</filename> with <literal>Content-Type:
         application/vnd.fdo.journal</literal> are supported.</para>
         </listitem>
@@ -171,7 +171,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
         <option>--listen-http=-<replaceable>n</replaceable></option>
         or
         <option>--listen-https=-<replaceable>n</replaceable></option>
-        above. In this later case, an HTTP or HTTPS server will be
+        above. In the latter case, an HTTP or HTTPS server will be
         spawned using this descriptor and connections must be made
         over the HTTP protocol.</para>
         </listitem>
@@ -193,8 +193,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
 
         <listitem><para>Will write to this journal. The filename must
         end with <filename>.journal</filename>. The file will be
-        created if it does not exist. When necessary (journal file
-        full, or corrupted) the file will be renamed following normal
+        created if it does not exist. If necessary (journal file
+        full, or corrupted), the file will be renamed following normal
         journald rules and a new journal file will be created in its
         stead.</para></listitem>
       </varlistentry>
@@ -203,15 +203,15 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
         <term><option>--output=<replaceable>DIR</replaceable></option></term>
 
         <listitem><para>Will create journal files underneath directory
-        <replaceable>DIR</replaceable>. The directory must exist. When
-        necessary (journal files over size, or corrupted) journal
+        <replaceable>DIR</replaceable>. The directory must exist. If
+        necessary (journal files over size, or corrupted), journal
         files will be rotated following normal journald rules. Names
         of files underneath <replaceable>DIR</replaceable> will be
         generated using the rules described below.</para></listitem>
       </varlistentry>
     </variablelist>
 
-    <para>If <option>--output=</option> is not used, output directory
+    <para>If <option>--output=</option> is not used, the output directory
     <filename>/var/log/journal/<replaceable>machine-id</replaceable>/</filename>
     will be used, where <replaceable>machine-id</replaceable> is the
     identifier of the current system (see
@@ -223,7 +223,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     based on what passive and active sources are specified. It is
     recommended to give a full output filename.</para>
 
-    <para>In case of "active" sources, if the hostname is known it
+    <para>In case of "active" sources, if the hostname is known, it
     will be used in the <replaceable>variable</replaceable> part.
     Otherwise, local address and port number will be used, or
     <literal>stdin</literal> for events passed over standard
@@ -272,7 +272,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
       <varlistentry>
         <term><option>--getter=<replaceable>PROG --option1 --option2</replaceable></option></term>
 
-        <listitem><para>Program to invoke to retrieve data. Journal
+        <listitem><para>Program to invoke to retrieve data. The journal
         event stream must be generated on standard output.</para>
 
         <para>Examples:</para>
diff --git a/man/systemd-networkd-wait-online.service.xml b/man/systemd-networkd-wait-online.service.xml
index 1d368a2..3083588 100644
--- a/man/systemd-networkd-wait-online.service.xml
+++ b/man/systemd-networkd-wait-online.service.xml
@@ -58,8 +58,8 @@
 
                 <para><command>systemd-networkd-wait-online</command> is a
                 one-shot system service that waits for the network to be configured.
-                By default it will wait for all links it is aware of that are managed by
-                <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+                By default, it will wait for all links it is aware of and which are managed by
+                <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
                 to be fully configured or failed, and for at least one link to gain a
                 carrier.</para>
         </refsect1>
diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml
index 1ad8e6e..ccd3436 100644
--- a/man/systemd-nspawn.xml
+++ b/man/systemd-nspawn.xml
@@ -358,7 +358,7 @@
                                 <option>--network-bridge=</option>
                                 implies
                                 <option>--network-veth</option>. If
-                                this option is used the host side of
+                                this option is used, the host side of
                                 the Ethernet link will use the
                                 <literal>vb-</literal> prefix instead
                                 of <literal>ve-</literal>.</para></listitem>
@@ -601,7 +601,7 @@
                                 <literal>x86-64</literal> are
                                 supported. This is useful when running
                                 a 32-bit container on a 64-bit
-                                host. If this setting is not used
+                                host. If this setting is not used,
                                 the personality reported in the
                                 container is the same as the one
                                 reported on the
diff --git a/man/systemd-run.xml b/man/systemd-run.xml
index 9ca17df..e3c006a 100644
--- a/man/systemd-run.xml
+++ b/man/systemd-run.xml
@@ -123,7 +123,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
 
         <listitem><para>Provide a description for the service or scope
         unit. If not specified, the command itself will be used as a
-        description.  See <varname>Description=</varname> in
+        description. See <varname>Description=</varname> in
         <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
         </para></listitem>
       </varlistentry>
@@ -244,7 +244,7 @@ Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3.11.0-0.rc5.git6.2.fc20.
 
     <para>The following command invokes the
     <citerefentry><refentrytitle>updatedb</refentrytitle><manvolnum>8</manvolnum></citerefentry>
-    tool but lowers the block IO weight for it to 10. See
+    tool, but lowers the block IO weight for it to 10. See
     <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>
     for more information on the <varname>BlockIOWeight=</varname>
     property.</para>
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index f794894..22f0768 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -845,7 +845,7 @@
                                 processes via
                                 <filename>/tmp</filename> or
                                 <filename>/var/tmp</filename>
-                                impossible. If this is enabled all
+                                impossible. If this is enabled, all
                                 temporary files created by a service
                                 in these directories will be removed
                                 after the service is stopped. Defaults
@@ -1208,18 +1208,18 @@
                                 correctly on x86-64). If running in user
                                 mode and this option is used,
                                 <varname>NoNewPrivileges=yes</varname>
-                                is implied. By default no
+                                is implied. By default, no
                                 restriction applies, all address
                                 families are accessible to
                                 processes. If assigned the empty
-                                string any previous list changes are
+                                string, any previous list changes are
                                 undone.</para>
 
                                 <para>Use this option to limit
                                 exposure of processes to remote
                                 systems, in particular via exotic
                                 network protocols. Note that in most
-                                cases the local
+                                cases, the local
                                 <constant>AF_UNIX</constant> address
                                 family should be included in the
                                 configured whitelist as it is
@@ -1240,7 +1240,7 @@
                                 <constant>x86</constant> and
                                 <constant>x86-64</constant>. This is
                                 useful when running 32-bit services on
-                                a 64-bit host system. If not specified
+                                a 64-bit host system. If not specified,
                                 the personality is left unmodified and
                                 thus reflects the personality of the
                                 host system's
@@ -1252,14 +1252,14 @@
                                 <term><varname>RuntimeDirectoryMode=</varname></term>
 
                                 <listitem><para>Takes a list of
-                                directory names. If set one or more
+                                directory names. If set, one or more
                                 directories by the specified names
                                 will be created below
                                 <filename>/run</filename> (for system
                                 services) or below
                                 <varname>$XDG_RUNTIME_DIR</varname>
                                 (for user services) when the unit is
-                                started and removed when the unit is
+                                started, and removed when the unit is
                                 stopped. The directories will have the
                                 access mode specified in
                                 <varname>RuntimeDirectoryMode=</varname>,
diff --git a/man/systemd.link.xml b/man/systemd.link.xml
index 1bee07c..f73182a 100644
--- a/man/systemd.link.xml
+++ b/man/systemd.link.xml
@@ -101,7 +101,7 @@
                                 <listitem>
                                         <para>The driver currently bound to the device,
                                         as exposed by the udev property <literal>DRIVER</literal>
-                                        of its parent device, or if that is not set the
+                                        of its parent device, or if that is not set, the
                                         driver as exposed by <literal>ethtool -i</literal>
                                         of the device itself.</para>
                                 </listitem>
diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index c4e5055..efe6ce7 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -299,7 +299,7 @@
                                         <term><varname>Destination=</varname></term>
                                         <listitem>
                                                 <para>The destination prefix of the route. Possibly followed by a slash and the
-                                                prefixlength, if ommitted a full-length host route is assumed.</para>
+                                                prefixlength. If ommitted, a full-length host route is assumed.</para>
                                         </listitem>
                                 </varlistentry>
                         </variablelist>
diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml
index 44f55e0..d82b9bd 100644
--- a/man/systemd.timer.xml
+++ b/man/systemd.timer.xml
@@ -274,7 +274,7 @@
                                 <term><varname>WakeSystem=</varname></term>
 
                                 <listitem><para>Takes a boolean
-                                argument. If true an elapsing timer
+                                argument. If true, an elapsing timer
                                 will cause the system to resume from
                                 suspend, should it be suspended and if
                                 the system supports this. Note that
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 30b6ea1..157530b 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -1019,7 +1019,7 @@
                                 case the kernel command line is
                                 searched for the word appearing as is,
                                 or as left hand side of an
-                                assignment. In the latter case the
+                                assignment. In the latter case, the
                                 exact assignment is looked for with
                                 right and left hand side
                                 matching.</para>
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 343fad1..e54f1ba 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -73,7 +73,7 @@
 
                 <para>System daemons frequently require private
                 runtime directories below <filename>/run</filename> to
-                place communication sockets and similar in. For these
+                place communication sockets and similar in. For these,
                 consider declaring them in their unit files using
                 <varname>RuntimeDirectory=</varname>
                 (see <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry> for details),
-- 
1.8.4.5



More information about the systemd-devel mailing list