chiark / gitweb /
man: wording and grammar updates
authorJan Engelhardt <jengelh@inai.de>
Thu, 7 Nov 2013 00:17:48 +0000 (01:17 +0100)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Thu, 7 Nov 2013 06:23:54 +0000 (01:23 -0500)
This is a recurring submission and includes corrections to various
issue spotted: comma setting, missing words/preposition choice.

15 files changed:
man/hostnamectl.xml
man/localectl.xml
man/loginctl.xml
man/machinectl.xml
man/systemctl.xml
man/systemd-analyze.xml
man/systemd-halt.service.xml
man/systemd-run.xml
man/systemd-socket-proxyd.xml
man/systemd-system.conf.xml
man/systemd.mount.xml
man/systemd.service.xml
man/systemd.socket.xml
man/systemd.swap.xml
man/timedatectl.xml

index b39fb55..29914b8 100644 (file)
                                 remotely. Specify a hostname, or
                                 username and hostname separated by <literal>@</literal>,
                                 to connect to. This will use SSH to
-                                talk to a remote
+                                talk to the remote
                                 system.</para></listitem>
                         </varlistentry>
 
index ad4f3d4..0950cce 100644 (file)
                                 remotely. Specify a hostname, or
                                 username and hostname separated by <literal>@</literal>,
                                 to connect to. This will use SSH to
-                                talk to a remote
+                                talk to the remote
                                 system.</para></listitem>
                         </varlistentry>
 
index 1b54ff7..7d4f26a 100644 (file)
                                 <term><option>-H</option></term>
                                 <term><option>--host</option></term>
 
-                                <listitem><para>Execute operation
+                                <listitem><para>Execute the operation
                                 remotely. Specify a hostname, or
                                 username and hostname separated by <literal>@</literal>,
                                 to connect to. This will use SSH to
index c06d0c7..ec2aaa5 100644 (file)
                                 <term><option>-H</option></term>
                                 <term><option>--host=</option></term>
 
-                                <listitem><para>Execute operation
+                                <listitem><para>Execute the operation
                                 remotely. Specify a hostname, or
                                 username and hostname separated by <literal>@</literal>,
                                 to connect to. This will use SSH to
                                 <term><option>-M</option></term>
                                 <term><option>--machine=</option></term>
 
-                                <listitem><para>Execute operation on a
+                                <listitem><para>Execute the operation on a
                                 local container. Specify a container
                                 name to connect to.</para></listitem>
                         </varlistentry>
                                 <listitem><para>Open a terminal login
                                 session to a container. This will
                                 create a TTY connection to a specific
-                                container and asks for execution of a
+                                container and asks for the execution of a
                                 getty on it. Note that this is only
                                 supported for containers running
                                 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
index 605b786..c7313ed 100644 (file)
@@ -64,15 +64,15 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
     system and service manager.</para>
 
-    <para>For Unit Commands the <replaceable>NAME</replaceable> represents full name of unit.
+    <para>For unit commands, the <replaceable>NAME</replaceable> represents full name of the unit.
     <programlisting>
 systemctl start foo.service
     </programlisting>
-    For Unit File Commands the <replaceable>NAME</replaceable> represents full name of the unit file, or absolute path to the unit file.
+    For unit file commands, the <replaceable>NAME</replaceable> represents the full name of the unit file, or the absolute path to the unit file.
     <programlisting>
 systemctl start /path/to/foo.service
     </programlisting>
-    While working with services/service files, <command>systemctl</command> is able to append .service suffix when it is missing.
+    While working with services/service files, <command>systemctl</command> implicitly appends the ".service" suffix when it is missing.
     <programlisting>
 systemctl start foo
     </programlisting></para>
@@ -457,7 +457,7 @@ systemctl start foo
         <term><option>--host</option></term>
 
         <listitem>
-          <para>Execute operation remotely. Specify a hostname, or
+          <para>Execute the operation remotely. Specify a hostname, or
           username and hostname separated by <literal>@</literal>, to connect to. This
           will use SSH to talk to the remote systemd
           instance.</para>
index 3141361..1898ca6 100644 (file)
                                 <term><option>-H</option></term>
                                 <term><option>--host=</option></term>
 
-                                <listitem><para>Execute operation
+                                <listitem><para>Execute the operation
                                 remotely. Specify a hostname, or
                                 username and hostname separated by
                                 <literal>@</literal>, to connect
                                 <term><option>-M</option></term>
                                 <term><option>--machine=</option></term>
 
-                                <listitem><para>Execute operation on a
+                                <listitem><para>Execute the operation on a
                                 local container. Specify a container
                                 name to connect to.</para></listitem>
                         </varlistentry>
index 812281e..2fd7b8b 100644 (file)
                 <filename>kexec.target</filename> to execute the
                 respective actions.</para>
 
-                <para>When these services are run they ensure that PID
+                <para>When these services are run, they ensure that PID
                 1 is replaced by the
                 <filename>/usr/lib/systemd/systemd-shutdown</filename>
                 tool which is then responsible for the actual
-                shutdown. Before shutting down this binary will try to
+                shutdown. Before shutting down, this binary will try to
                 unmount all remaining file systems, disable all
                 remaining swap devices, detach all remaining storage
                 devices and kill all remaining processes.</para>
index 031c207..daf2bdc 100644 (file)
@@ -125,7 +125,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
               <term><option>-H</option></term>
               <term><option>--host=</option></term>
 
-              <listitem><para>Execute operation
+              <listitem><para>Execute the operation
               remotely. Specify a hostname, or
               username and hostname separated by <literal>@</literal>,
               to connect to. This will use SSH to
@@ -137,7 +137,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
               <term><option>-M</option></term>
               <term><option>--machine=</option></term>
 
-              <listitem><para>Execute operation on a
+              <listitem><para>Execute the operation on a
               local container. Specify a container
               name to connect to.</para></listitem>
       </varlistentry>
index fcf4aaf..6983346 100644 (file)
@@ -64,7 +64,7 @@
                 local or remote destination socket.</para>
 
                 <para>One use of this tool is to provide
-                socket-activation support for services that do not
+                socket activation support for services that do not
                 natively support socket activation. On behalf of the
                 service to activate, the proxy inherits the socket
                 from systemd, accepts each client connection, opens a
index c1f2648..2a0a10c 100644 (file)
                                 <listitem><para>Configures the default
                                 time-outs for starting and stopping of
                                 units, as well as the default time to
-                                sleep between automatic restarts of a
+                                sleep between automatic restarts of
                                 units, as configured per-unit in
                                 <varname>TimeoutStartSec=</varname>,
                                 <varname>TimeoutStopSec=</varname> and
                                 <varname>RestartSec=</varname> (for
-                                service units see
+                                service units, see
                                 <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>
                                 for details on the per-unit
-                                settings). For non-service units
+                                settings). For non-service units,
                                 <varname>DefaultTimeoutStartSec=</varname>
                                 sets the default
                                 <varname>TimeoutSec=</varname> value.
index daf1189..bd50f35 100644 (file)
                                 Takes a unit-less value in seconds, or
                                 a time span value such as "5min
                                 20s". Pass 0 to disable the timeout
-                                logic. Default value is setted up in manager configuration
-                                file via <varname>DefaultTimeoutStart=</varname>.</para></listitem>
+                                logic. The default value is set from the manager configuration
+                                file's <varname>DefaultTimeoutStart=</varname> variable.</para></listitem>
                         </varlistentry>
                 </variablelist>
 
index 0cb3d9e..d1f4a2d 100644 (file)
                                 Takes a unit-less value in seconds, or a
                                 time span value such as "5min
                                 20s". Pass 0 to disable the timeout
-                                logic. Defaults to <varname>TimeoutStartSec=</varname> in
+                                logic. Defaults to <varname>TimeoutStartSec=</varname> from the
                                 manager configuration file, except when
                                 <varname>Type=oneshot</varname> is
-                                used in which case the timeout
+                                used, in which case the timeout
                                 is disabled by default.
                                 </para></listitem>
                         </varlistentry>
                                 Takes a unit-less value in seconds, or a
                                 time span value such as "5min
                                 20s". Pass 0 to disable the timeout
-                                logic. Defaults to <varname>TimeoutStartSec=</varname> in
+                                logic. Defaults to <varname>TimeoutStartSec=</varname> from the
                                 manager configuration file.
                                 </para></listitem>
                         </varlistentry>
index 1c78562..7c10c58 100644 (file)
                                 Takes a unit-less value in seconds, or
                                 a time span value such as "5min
                                 20s". Pass 0 to disable the timeout
-                                logic. Defaults to <varname>TimeoutStartSec=</varname> in
+                                logic. Defaults to <varname>TimeoutStartSec=</varname> from the
                                 manager configuration file.</para></listitem>
                         </varlistentry>
 
index 13f6c84..0411232 100644 (file)
                                 Takes a unit-less value in seconds, or
                                 a time span value such as "5min
                                 20s". Pass 0 to disable the timeout
-                                logic. Defaults to <varname>TimeoutStartSec=</varname> in
+                                logic. Defaults to <varname>TimeoutStartSec=</varname> from the
                                 manager configuration file.</para></listitem>
                         </varlistentry>
                 </variablelist>
index 2dd6beb..afcb716 100644 (file)
                                 <term><option>-H</option></term>
                                 <term><option>--host=</option></term>
 
-                                <listitem><para>Execute operation
+                                <listitem><para>Execute the operation
                                 remotely. Specify a hostname, or
                                 username and hostname separated by <literal>@</literal>,
                                 to connect to. This will use SSH to