chiark / gitweb /
man: wording and grammar updates
authorJan Engelhardt <jengelh@inai.de>
Sun, 21 Jul 2013 04:53:14 +0000 (06:53 +0200)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Sun, 21 Jul 2013 15:23:58 +0000 (11:23 -0400)
This includes regularly-submitted corrections to comma setting and
orthographical mishaps that appeared in man/ in recent commits.

15 files changed:
man/crypttab.xml
man/journalctl.xml
man/machinectl.xml
man/pam_systemd.xml
man/systemctl.xml
man/systemd-bootchart.xml
man/systemd-machined.service.xml
man/systemd-run.xml
man/systemd.cgroup.xml
man/systemd.scope.xml
man/systemd.slice.xml
man/systemd.special.xml
man/systemd.unit.xml
man/systemd.xml
man/udev.xml

index 298f39e0e3ca6c9d2d02a8cdbf7841113f85e433..5aade57c426af33152e8d0cf6c1f8e8296d486d6 100644 (file)
                                 <term><varname>luks</varname></term>
 
                                 <listitem><para>Force LUKS mode. When this mode
-                                is used the following options are ignored since
+                                is used, the following options are ignored since
                                 they are provided by the LUKS header on the
                                 device: <varname>cipher=</varname>,
                                 <varname>hash=</varname>,
                                 <term><varname>tcrypt</varname></term>
 
                                 <listitem><para>Use TrueCrypt encryption mode.
-                                When this mode is used the following options are
+                                When this mode is used, the following options are
                                 ignored since they are provided by the TrueCrypt
                                 header on the device or do not apply:
                                 <varname>cipher=</varname>,
index c8559a0cb01740b4987eb52e8b0437082e859883..dcc6d5dce919bab6234a3c84730ddf1b89f9e1a9 100644 (file)
                                                         <option>short-iso</option>
                                                 </term>
                                                 <listitem>
-                                                        <para>is very similar
+                                                        <para>is very similar,
                                                         but shows ISO 8601
                                                         wallclock timestamps.
                                                         </para>
index 37fefeadc8123f55aae1221a63a00297e7d6058b..5efa3a542a5766570ba4dca973217eab343661fe 100644 (file)
                                 <term><option>--signal=</option></term>
 
                                 <listitem><para>When used with
-                                <command>kill-machine</command> choose
+                                <command>kill-machine</command>, choose
                                 which signal to send to selected
                                 processes. Must be one of the
                                 well-known signal specifiers, such as
index 1d924bc319b382398d3d9a993c986730086a129c..951ae207a4a9568433de23c73ca0937b5d488efc 100644 (file)
 
                         <listitem><para>A new systemd scope unit is
                         created for the session. If this is the first
-                        concurrent session of the user an implicit
+                        concurrent session of the user, an implicit
                         slice below <filename>user.slice</filename> is
                         automatically created and the scope placed in
                         it. In instance of the system service
-                        <filename>user@.service</filename> which runt
+                        <filename>user@.service</filename> which runs
                         the systemd user manager
                         instance.</para></listitem>
                 </orderedlist>
                 <para>On logout, this module ensures the following:</para>
 
                 <orderedlist>
-                        <listitem><para>If this is enabled all
+                        <listitem><para>If this is enabled, all
                         processes of the session are terminated. If
-                        the last concurrent session of a user ends his
+                        the last concurrent session of a user ends, his
                         user systemd instance will be terminated too,
                         and so will the user's slice
                         unit.</para></listitem>
 
-                        <listitem><para>If the las concurrent session
-                        of a user ends the
+                        <listitem><para>If the last concurrent session
+                        of a user ends, the
                         <varname>$XDG_RUNTIME_DIR</varname> directory
                         and all its contents are removed,
                         too.</para></listitem>
index 4bfce95ffabb4a164eb9581a135827bda6995207..ee13a70fef66e6f8e2ac1da9e216eb51cef56207 100644 (file)
@@ -111,8 +111,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
         <term><option>--state=</option></term>
 
         <listitem>
-        <para>Argument should be a comma-separated list of unit LOAD
-        or SUB or ACTIVE states. When listing units show only those
+        <para>The argument should be a comma-separated list of unit LOAD
+        or SUB or ACTIVE states. When listing units, show only those
         with specified LOAD or SUB or ACTIVE state.</para>
         </listitem>
       </varlistentry>
@@ -433,7 +433,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
           is lost on reboot, the changes are lost too.</para>
 
           <para>Similar, when used with
-          <command>set-property</command> make changes only
+          <command>set-property</command>, make changes only
           temporarily, so that they are lost on the next
           reboot.</para>
         </listitem>
@@ -727,7 +727,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
           <citerefentry><refentrytitle>systemd.cgroup</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
           may. The changes are applied instantly, and stored on disk
           for future boots, unless <option>--runtime</option> is
-          passed in which case the settings only apply until the next
+          passed, in which case the settings only apply until the next
           reboot. The syntax of the property assignment follows
           closely the syntax of assignments in unit files.</para>
 
@@ -736,7 +736,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
           <para>Note that this command allows changing multiple
           properties at the same time, which is preferable over
           setting them individually. Like unit file configuration
-          settings assigning the empty list to list parameters will
+          settings, assigning the empty list to list parameters will
           reset the list.</para>
         </listitem>
       </varlistentry>
index 8de4c69a2d2ff4afb92e5288776c234f7a6a9abf..ae432b563f8a70c0bedb43deca2d83895a6b5007 100644 (file)
                         <varlistentry>
                                 <term><option>-o</option></term>
                                 <term><option>--output <replaceable>path</replaceable></option></term>
-                                <listitem><para>Specify the output folder for the
+                                <listitem><para>Specify the output directory for the
                                 graphs. By default, bootchart writes the graphs to
                                 <filename>/run/log</filename>.</para></listitem>
                         </varlistentry>
index 525944b1bcdc3c0c7be8a5b8235fcdc2f0f65bf4..abe221a17863118af275ec5caef725eea20dae42 100644 (file)
@@ -63,7 +63,7 @@
 
                 <para>See
                 <citerefentry><refentrytitle>systemd-nspawn</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                for some examples how to start a container the systemd
+                for some examples on how to start a container the systemd
                 way.</para>
 
                 <para>See the <ulink
index 98ee4762dd1a5568055ece27494b586e4ebfa2b0..3f777b5a4e583f7789b35df5236543ecb2820d8f 100644 (file)
@@ -151,7 +151,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
 
     <para>All command-line arguments after the first non-option
     argument become part of the commandline of the launched
-    process. If a command is run as service unit its first argument
+    process. If a command is run as service unit, its first argument
     needs to be an absolute binary path.</para>
   </refsect1>
 
index 12b19f5c4b72890a511597e3fa9c9daa68168c2d..cc0eb15abb901976db4a2641ab3c793489c7128f 100644 (file)
@@ -322,9 +322,9 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
           hierarchy of slices each of which might have resource
           settings applied.</para>
 
-          <para>For units of type slice the only accepted value for
+          <para>For units of type slice, the only accepted value for
           this setting is the parent slice. Since the name of a slice
-          unit implies the parent slice it is hence redundant to ever
+          unit implies the parent slice, it is hence redundant to ever
           set this parameter directly for slice units.</para>
         </listitem>
       </varlistentry>
index ff41c926f46e5fc752a6d5f4fdc49fe915e5e9b4..e8fa1aed599d845f39551f7f70ec9122b0faa2ed 100644 (file)
@@ -58,7 +58,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     but are only created programmatically using the bus interfaces of
     systemd. They are named similar to filenames. A unit whose name
     ends in <literal>.scope</literal> refers to a scope unit. Scopes
-    units manage a set of system processes. Unlike service units scope
+    units manage a set of system processes. Unlike service units, scope
     units manage externally created processes, and do not fork off
     processes on its own.</para>
 
index 7ddef85eec8df662362cb650dd0dbe99621b58f3..b7b0622d3c3d2de6dd63cd5f91bc3067628502c2 100644 (file)
@@ -60,10 +60,10 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     processes. This management is performed by creating a node in the
     control group tree. Units that manage processes (primarilly scope
     and service units) may be assigned to a specific slice. For each
-    slice certain resource limits may the be set, that apply to all
+    slice, certain resource limits may the be set that apply to all
     processes of all units contained in that slice. Slices are
     organized hierarchially in a tree. The name of the slice encodes
-    the location in the tree. The name consists of a "-" separated
+    the location in the tree. The name consists of a dash-separated
     series of names, which describes the path to the slice from the
     root slice. The root slice is named,
     <filename>-.slice</filename>. Example:
@@ -72,7 +72,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     the root slice <filename>-.slice</filename>.
     </para>
 
-    <para>By default service and scope units are placed in
+    <para>By default, service and scope units are placed in
     <filename>system.slice</filename>, virtual machines and containers
     registered with
     <citerefentry><refentrytitle>systemd-machined</refentrytitle><manvolnum>1</manvolnum></citerefentry>
index 6d456e18e52625be0504336713bf1188ae2e201d..e1299abcb00ba3762fc90226f2f1d2505afa63d1 100644 (file)
                         <varlistentry>
                                 <term><filename>system.slice</filename></term>
                                 <listitem>
-                                        <para>By default all services
+                                        <para>By default, all services
                                         services started by
                                         <command>systemd</command> are
                                         found in this slice.</para>
                         <varlistentry>
                                 <term><filename>user.slice</filename></term>
                                 <listitem>
-                                        <para>By default all user
+                                        <para>By default, all user
                                         processes and services started
                                         on behalf of the user,
                                         including the per-user systemd
                         <varlistentry>
                                 <term><filename>machine.slice</filename></term>
                                 <listitem>
-                                        <para>By defalt all virtual
+                                        <para>By defalt, all virtual
                                         machines and containers
                                         registered with
                                         <command>systemd-machined</command>
index 65ba54503713715edab2eb370c77603051e71033..f6a0791bf98b5f2cac59274087619f498ed55a80 100644 (file)
                                 <listitem><para>A symbolic link is
                                 created in the
                                 <filename>.wants/</filename> or
-                                <filename>.requires/</filename> folder
+                                <filename>.requires/</filename> directory
                                 of the listed unit when this unit is
                                 activated by <command>systemctl
                                 enable</command>.  This has the effect
index 06d2ecf6f8ae7886894a71f8662bb662e1b5babe..1e54eac9267825340e70d1aa8b1e58d1abbbc5ff 100644 (file)
                 <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                 however some are created automatically from other
                 configuration, dynamically from system state or
-                programmatically at runtime. Units may be 'active'
-                (meaning started, bound, plugged in, ...  depending on
-                the unit type, see below), or 'inactive' (meaning
+                programmatically at runtime. Units may be "active"
+                (meaning started, bound, plugged in, ..., depending on
+                the unit type, see below), or "inactive" (meaning
                 stopped, unbound, unplugged, ...), as well as in the
                 process of being activated or deactivated,
                 i.e. between the two states (these states are called
-                'activating', 'deactivating'). A special 'failed'
-                state is available as well which is very similar to
-                'inactive' and is entered when the service failed in
+                "activating", "deactivating"). A special "failed"
+                state is available as well, which is very similar to
+                "inactive" and is entered when the service failed in
                 some way (process returned error code on exit, or
                 crashed, or an operation timed out). If this state is
-                entered the cause will be logged, for later
+                entered, the cause will be logged, for later
                 reference. Note that the various unit types may have a
                 number of additional substates, which are mapped to
                 the five generalized unit states described
index 435dec4c6151d87ff23f974d2a6d782a25e8df66..022072514082bfa11fa649ff92490788c5ee0af8 100644 (file)
       used to override a system-supplied hwdb file with a local file if needed;
       a symlink in <filename>/etc</filename> with the same name as a rules file in
       <filename>/lib</filename>, pointing to <filename>/dev/null</filename>,
-      disables the rules file entirely. Hwdb files must have the extension
+      disables the rules file entirely. hwdb files must have the extension
       <filename>.hwdb</filename>; other extensions are ignored.</para>
 
       <para>The hwdb file contains data records consisting of matches and