chiark / gitweb /
doc: corrections to words and forms
authorJan Engelhardt <jengelh@inai.de>
Wed, 7 May 2014 23:28:44 +0000 (01:28 +0200)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Thu, 8 May 2014 00:13:26 +0000 (20:13 -0400)
This patch exchange words which are inappropriate for a situation,
deletes duplicated words, and adds particles where needed.

15 files changed:
NEWS
man/sd_bus_message_append_string_memfd.xml
man/sd_bus_message_append_strv.xml
man/sd_bus_open_user.xml
man/sd_bus_path_encode.xml
man/sd_event_new.xml
man/systemctl.xml
man/systemd-gpt-auto-generator.xml
man/systemd-journal-remote.xml
man/systemd-nspawn.xml
man/systemd-run.xml
man/systemd.exec.xml
man/systemd.link.xml
man/systemd.socket.xml
src/core/unit-printf.c

diff --git a/NEWS b/NEWS
index ac2cf4130c5401cec75ed907c29c78e9e31cdead..1b548f50349cbf3ad52282e50fda4a34f9fddb18 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -2348,7 +2348,7 @@ CHANGES WITH 190:
           dir: %_presetdir.
 
         * journald will now warn if it ca not forward a message to the
           dir: %_presetdir.
 
         * journald will now warn if it ca not forward a message to the
-          syslog daemon because it's socket is full.
+          syslog daemon because its socket is full.
 
         * timedated will no longer write or process /etc/timezone,
           except on Debian. As we do not support late mounted /usr
 
         * timedated will no longer write or process /etc/timezone,
           except on Debian. As we do not support late mounted /usr
index a9b892480550adcb340961e988b65941900a2342..bf185ef6d4177c511b48217f5170d9bd9d2ba37e 100644 (file)
@@ -115,8 +115,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     space for a string to message <parameter>m</parameter>. If behaves
     similarly to <function>sd_bus_message_append_basic</function> with
     type <literal>s</literal>, but instead of copying a string into
     space for a string to message <parameter>m</parameter>. If behaves
     similarly to <function>sd_bus_message_append_basic</function> with
     type <literal>s</literal>, but instead of copying a string into
-    the the message, it returns a pointer to the destination area to
-    the caller in pointer <parameter>p</parameter>. Space for string
+    the message, it returns a pointer to the destination area to
+    the caller in pointer <parameter>p</parameter>. Space for the string
     of length <parameter>size</parameter> plus the terminating
     <constant>NUL</constant> is allocated.</para>
   </refsect1>
     of length <parameter>size</parameter> plus the terminating
     <constant>NUL</constant> is allocated.</para>
   </refsect1>
index 048bbcac08fe56cc697829c779c3780134a6f13b..4fb1390df48ebf6af5d4516aeb5ee9ce6a496328 100644 (file)
@@ -77,8 +77,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     <para>The memory pointed at by <parameter>p</parameter> and the
     contents of the strings themselves are copied into the memory area
     containing the message and may be changed after this call. Note
     <para>The memory pointed at by <parameter>p</parameter> and the
     contents of the strings themselves are copied into the memory area
     containing the message and may be changed after this call. Note
-    that the signature of <parameter>l</parameter> parameter is be
-    treated as <type>const char* const*</type>, and the the contents
+    that the signature of <parameter>l</parameter> parameter is to be
+    treated as <type>const char *const *</type>, and the contents
     will not be modified.</para>
   </refsect1>
 
     will not be modified.</para>
   </refsect1>
 
index 7fa1be61ed1854747e986eaf41fd1c6623406639..740977e1cfd5455470a4fd8f515c9ae44cad7c3f 100644 (file)
@@ -96,13 +96,13 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     <title>Description</title>
 
     <para><function>sd_bus_open_user()</function> creates a new bus
     <title>Description</title>
 
     <para><function>sd_bus_open_user()</function> creates a new bus
-    object and opens a connection to the the user bus.
+    object and opens a connection to the user bus.
     <function>sd_bus_open_system()</function> does the same, but
     connects to the system bus.</para>
 
     <para>If the <varname>$DBUS_SESSION_BUS_ADDRESS</varname> environment
     variable is set
     <function>sd_bus_open_system()</function> does the same, but
     connects to the system bus.</para>
 
     <para>If the <varname>$DBUS_SESSION_BUS_ADDRESS</varname> environment
     variable is set
-    (c.f. <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry>),
+    (cf. <citerefentry><refentrytitle>environ</refentrytitle><manvolnum>7</manvolnum></citerefentry>),
     it will be used as the address of the user bus. This variable can
     contain multiple addresses separated by <literal>;</literal>. If
     this variable is not set, a suitable default for the default user
     it will be used as the address of the user bus. This variable can
     contain multiple addresses separated by <literal>;</literal>. If
     this variable is not set, a suitable default for the default user
index 7cb8e77bc086b854e73f3d02baeb55e756376d64..7e119068724dcecaf812c8507064afcc5da141ba 100644 (file)
@@ -101,11 +101,11 @@ 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
     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 the
+    string is set to <constant>NULL</constant>. Otherwise the
     string following the prefix is unescaped and returned in the
     external identifier string.</para>
 
     string following the prefix is unescaped and returned in the
     external identifier string.</para>
 
-    <para>The escaping used will will replace all characters which are
+    <para>The escaping used will replace all characters which are
     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>
     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>
index 6545cde7cac678f7bd02edfa1c968f5f4181d54d..f25631f9caa74ca060c744da453d41c7f5bbfebd 100644 (file)
@@ -109,7 +109,7 @@ 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
     <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
-    is freed regardless if it is the default event loop object of a
+    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
     then acquiring a new one with
     thread or not. This means that allocating an event loop with
     <function>sd_event_default()</function>, then releasing it and
     then acquiring a new one with
index 94f238041a8a71253201c8eeab84a52d2e8d1d41..28a7cca0ede14c542d77413c547ca4ba290e0190 100644 (file)
@@ -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
             <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 shows 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>
             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>
index 32e118333621af48ad3ac4bb8e67a2c2952ffecf..41b83dd383b865e538a48d849167713c58c144d1 100644 (file)
@@ -60,7 +60,7 @@
                 is a unit generator that automatically discovers root,
                 <filename>/home</filename>, <filename>/srv</filename>
                 and swap partitions and creates mount and swap units
                 is a unit generator that automatically discovers root,
                 <filename>/home</filename>, <filename>/srv</filename>
                 and swap partitions and creates mount and swap units
-                for them, based on the the partition type GUIDs of
+                for them, based on the partition type GUIDs of
                 GUID partition tables (GPT). It implements the <ulink
                 url="http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/">Discoverable
                 Partitions Specification</ulink>. Note that this
                 GUID partition tables (GPT). It implements the <ulink
                 url="http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/">Discoverable
                 Partitions Specification</ulink>. Note that this
@@ -75,7 +75,7 @@
                 Partition (ESP) is located on. It will only look for
                 the other partitions on the same physical disk the
                 root file system is located on. These partitions will
                 Partition (ESP) is located on. It will only look for
                 the other partitions on the same physical disk the
                 root file system is located on. These partitions will
-                not be search on systems where the root file system is
+                not be searched on systems where the root file system is
                 distributed on multiple disks, for example via btrfs
                 RAID.</para>
 
                 distributed on multiple disks, for example via btrfs
                 RAID.</para>
 
index 40bef05a13747812157a605ad5f656288c0a6639..1f0d93e2f327778061a244d3c6c50d21c23f5bac 100644 (file)
@@ -79,7 +79,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
       (<command>systemd-journal-remote</command> requests and pulls
       the data), or "passive"
       (<command>systemd-journal-remote</command> waits for a
       (<command>systemd-journal-remote</command> requests and pulls
       the data), or "passive"
       (<command>systemd-journal-remote</command> waits for a
-      connection and than receives events pushed by the other side).
+      connection and then receives events pushed by the other side).
     </para>
 
     <para>
     </para>
 
     <para>
@@ -131,7 +131,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
         <term><option>--listen-raw=<replaceable>ADDRESS</replaceable></option></term>
 
         <listitem><para><replaceable>ADDRESS</replaceable> must be an
         <term><option>--listen-raw=<replaceable>ADDRESS</replaceable></option></term>
 
         <listitem><para><replaceable>ADDRESS</replaceable> must be an
-        address suitable for <option>ListenStream=</option> (c.f.
+        address suitable for <option>ListenStream=</option> (cf.
         <citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>).
         <command>systemd-journal-remote</command> will listen on this
         socket for connections. Each connection is expected to be a
         <citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>).
         <command>systemd-journal-remote</command> will listen on this
         socket for connections. Each connection is expected to be a
@@ -195,8 +195,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
         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
         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
-        journald rules and a new journal file will be created in it's
-        stead. </para></listitem>
+        journald rules and a new journal file will be created in its
+        stead.</para></listitem>
       </varlistentry>
 
       <varlistentry>
       </varlistentry>
 
       <varlistentry>
index 18946167c559d07bce7d321c5c87f6062679e44c..1ad8e6ec056fb2ed9a33ca689d5808783776b704 100644 (file)
                                 container's name (as specified with
                                 <option>--machine=</option>), prefixed
                                 with <literal>ve-</literal>. The
                                 container's name (as specified with
                                 <option>--machine=</option>), prefixed
                                 with <literal>ve-</literal>. The
-                                container side of the the Ethernet
+                                container side of the Ethernet
                                 link will be named
                                 <literal>host0</literal>. Note that
                                 <option>--network-veth</option>
                                 link will be named
                                 <literal>host0</literal>. Note that
                                 <option>--network-veth</option>
index 8bb587cf7fad1815e139a4c7181b54260018942c..9ca17df55a7d6f1d5ad298ee33ad2c5d3f56d193 100644 (file)
@@ -121,7 +121,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
       <varlistentry>
         <term><option>--description=</option></term>
 
       <varlistentry>
         <term><option>--description=</option></term>
 
-        <listitem><para>Provide description for the service or scope
+        <listitem><para>Provide description for the service or scope
         unit. If not specified, the command itself will be used as a
         description.  See <varname>Description=</varname> in
         <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
         unit. If not specified, the command itself will be used as a
         description.  See <varname>Description=</varname> in
         <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
index d206d4f64564210aa0cedf913f263a5da0bc1caf..f79489494717df1d29e0bfd84620eddc65bac064 100644 (file)
                                 <para>The files listed with this
                                 directive will be read shortly before
                                 the process is executed (more
                                 <para>The files listed with this
                                 directive will be read shortly before
                                 the process is executed (more
-                                specifically, this means after all
+                                specifically, after all
                                 processes from a previous unit state
                                 terminated. This means you can
                                 generate these files in one unit
                                 processes from a previous unit state
                                 terminated. This means you can
                                 generate these files in one unit
                         <varlistentry>
                                 <term><varname>AppArmorProfile=</varname></term>
 
                         <varlistentry>
                                 <term><varname>AppArmorProfile=</varname></term>
 
-                                <listitem><para>Take a profile name as argument.
+                                <listitem><para>Takes a profile name as argument.
                                 The process executed by the unit will switch to
                                 this profile when started. Profiles must already
                                 be loaded in the kernel, or the unit will fail.
                                 The process executed by the unit will switch to
                                 this profile when started. Profiles must already
                                 be loaded in the kernel, or the unit will fail.
                 <varname>systemd.setenv=</varname> (see
                 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>). Additional
                 variables may also be set through PAM,
                 <varname>systemd.setenv=</varname> (see
                 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>). Additional
                 variables may also be set through PAM,
-                c.f. <citerefentry><refentrytitle>pam_env</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
+                cf. <citerefentry><refentrytitle>pam_env</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
         </refsect1>
 
         <refsect1>
         </refsect1>
 
         <refsect1>
index 2f5de23742db8fad69ece8283ca3685ce642bac9..1bee07cf1dfdaf351a987113f13610567eff1843 100644 (file)
                                                         <listitem>
                                                                 <para>If the hardware has a persistent
                                                                 MAC address, as most hardware should,
                                                         <listitem>
                                                                 <para>If the hardware has a persistent
                                                                 MAC address, as most hardware should,
-                                                                and this is used by the kernel, nothing
+                                                                and if it is used by the kernel, nothing
                                                                 is done. Otherwise, a new MAC address
                                                                 is generated which is guaranteed to be
                                                                 the same on every boot for the given
                                                                 is done. Otherwise, a new MAC address
                                                                 is generated which is guaranteed to be
                                                                 the same on every boot for the given
index d645de45e10ae074a1c64412c9c29450d045edd1..c0d7906d7ed652cc9f1c47b4c430e8ea524ae892 100644 (file)
 
                         <varlistentry>
                                 <term><varname>PipeSize=</varname></term>
 
                         <varlistentry>
                                 <term><varname>PipeSize=</varname></term>
-                                <listitem><para>Takes an size in
+                                <listitem><para>Takes a size in
                                 bytes. Controls the pipe buffer size
                                 of FIFOs configured in this socket
                                 unit. See
                                 bytes. Controls the pipe buffer size
                                 of FIFOs configured in this socket
                                 unit. See
index 4e18afab8bb62f989d3acd111657f6641a1bbec7..d16d856b516aa5e36bd84831a42ff45fbc801c5b 100644 (file)
@@ -369,7 +369,7 @@ int unit_full_printf(Unit *u, const char *format, char **ret) {
         /* This is similar to unit_name_printf() but also supports
          * unescaping. Also, adds a couple of additional codes:
          *
         /* This is similar to unit_name_printf() but also supports
          * unescaping. Also, adds a couple of additional codes:
          *
-         * %f the the instance if set, otherwise the id
+         * %f the instance if set, otherwise the id
          * %c cgroup path of unit
          * %r where units in this slice are placed in the cgroup tree
          * %R the root of this systemd's instance tree
          * %c cgroup path of unit
          * %r where units in this slice are placed in the cgroup tree
          * %R the root of this systemd's instance tree