man: grammar and wording improvements

This is a recurring submission and includes corrections to:
- missing words, preposition choice.
- change of /lib to /usr/lib, because that is what most distros are
  using as the system-wide location for systemd/udev files.
This commit is contained in:
Jan Engelhardt 2013-12-26 02:47:45 +01:00 committed by Zbigniew Jędrzejewski-Szmek
parent b040723ea4
commit e0e009c067
13 changed files with 41 additions and 41 deletions

View File

@ -408,7 +408,7 @@
description files.</para>
<para>In systemd, if the developer or
administrator wants to make sure a service or
administrator wants to make sure that a service or
other unit is activated automatically on boot,
it is recommended to place a symlink to the
unit file in the <filename>.wants/</filename>

View File

@ -119,7 +119,7 @@
<para>When outputing to a tty, lines are colored
according to priority: lines of level ERROR and higher
are colored red; lines of level NOTICE and higher are
highlighted; and other lines are displayed normally.
highlighted; other lines are displayed normally.
</para>
</refsect1>
@ -232,7 +232,7 @@
<term><option>-r</option></term>
<term><option>--reverse</option></term>
<listitem><para>Reverse output so the newest
<listitem><para>Reverse output so that the newest
entries are displayed first.</para></listitem>
</varlistentry>

View File

@ -85,7 +85,7 @@
field.</para>
<para>Both functions take a message object as first
parameter and a place to store the 64bit cookie
parameter and a place to store the 64-bit cookie
in.</para>
</refsect1>
@ -97,7 +97,7 @@
errno-style error code.</para>
<para>On success, the cookie/reply cookie is returned
in the specified 64bit unsigned integer variable.</para>
in the specified 64-bit unsigned integer variable.</para>
</refsect1>
<refsect1>
@ -122,7 +122,7 @@
been sent yet and hence has no cookie
assigned, or that the message is not a
method response message and hence
carries to reply cookie
carries a reply cookie
field.</para></listitem>
</varlistentry>
</variablelist>

View File

@ -81,7 +81,7 @@
<term><varname>SD_BUS_NAME_ALLOW_REPLACEMENT</varname></term>
<listitem><para>After acquiring the
name successuflly, permit other peers
name successfully, permit other peers
to take over the name when they try to
acquire it with the
<varname>SD_BUS_NAME_REPLACE_EXISTING</varname>
@ -95,10 +95,10 @@
<varlistentry>
<term><varname>SD_BUS_NAME_REPLACE_EXISTING</varname></term>
<listitem><para>Take over a the name
if it is already acquired by a another
peer, and that other peer permitted
taking it over by setting
<listitem><para>Take over the name
if it is already acquired by another
peer, and that other peer has permitted
takeover by setting
<varname>SD_BUS_NAME_ALLOW_REPLACEMENT</varname>
while acquiring it.</para></listitem>
</varlistentry>
@ -106,8 +106,8 @@
<varlistentry>
<term><varname>SD_BUS_NAME_QUEUE</varname></term>
<listitem><para>Queue name
acquisition when the name is already
<listitem><para>Queue the acquisition
of the name when the name is already
taken.</para></listitem>
</varlistentry>
</variablelist>
@ -165,7 +165,7 @@
<varlistentry>
<term><varname>-ESRCH</varname></term>
<listitem><para>It was attemted to
<listitem><para>It was attempted to
release a name that is currently not
registered on the
bus.</para></listitem>
@ -174,7 +174,7 @@
<varlistentry>
<term><varname>-EADDRINUSE</varname></term>
<listitem><para>It was attemted to
<listitem><para>It was attempted to
release a name that is owned by a
different peer on the
bus.</para></listitem>
@ -199,7 +199,7 @@
<listitem><para>The bus connection has
been created in a different process
than the current.</para></listitem>
than the current one.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>

View File

@ -165,7 +165,7 @@
called to check whether the specified file descriptor
refers to a special file. If the
<parameter>path</parameter> parameter is not
<constant>NULL</constant>, it is checked whether file
<constant>NULL</constant>, it is checked whether the file
descriptor is bound to the specified file
name. Special files in this context are character
device nodes and files in <filename>/proc</filename>

View File

@ -194,8 +194,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
<term><option>--job-mode=</option></term>
<listitem>
<para>When queuing a new job, control how to deal with already
queued jobs. Takes one of <literal>fail</literal>,
<para>When queuing a new job, this option controls how to deal with
already queued jobs. It takes one of <literal>fail</literal>,
<literal>replace</literal>,
<literal>replace-irreversibly</literal>,
<literal>isolate</literal>,
@ -543,7 +543,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
<term><command>list-sockets <optional><replaceable>PATTERN</replaceable>...</optional></command></term>
<listitem>
<para>List socket units ordered by the listening address.
<para>List socket units ordered by listening address.
If one or more <replaceable>PATTERN</replaceable>s are
specified, only socket units matching one of them are
shown. Produces output similar to
@ -692,7 +692,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
<listitem>
<para>Check whether any of the specified units are active
(i.e. running). Returns an exit code 0 if at least one is
active, non-zero otherwise. Unless <option>--quiet</option>
active, or non-zero otherwise. Unless <option>--quiet</option>
is specified, this will also print the current unit state to
STDOUT.</para>
</listitem>

View File

@ -64,8 +64,8 @@
<para>Network configurations applied before networkd is started
are not removed, and configuration applied by networkd are not
removed when networkd exits. This ensures restarting networkd
does not cut the network connection, and in particular that it
is safe to transition between the initrd and the real root,
does not cut the network connection, and, in particular, that
it is safe to transition between the initrd and the real root,
and back.</para>
</refsect1>
@ -80,10 +80,10 @@
identical filenames replace each other. Files in
<filename>/etc</filename> have the highest priority, files in
<filename>/run</filename> take precedence over files with the same
name in <filename>/lib</filename>. This can be used to override a
name in <filename>/usr/lib</filename>. This can be used to override a
system-supplied configuration file with a local file if needed; a symlink in
<filename>/etc</filename> with the same name as a configuration file in
<filename>/lib</filename>, pointing to <filename>/dev/null</filename>,
<filename>/usr/lib</filename>, pointing to <filename>/dev/null</filename>,
disables the configuration file entirely.</para>
<refsect2><title>Virtual Network Devices</title>

View File

@ -149,7 +149,7 @@
even if it shows up in the udev
tree. If this property is unset or set
to 1, the device will be considered
plugged if it visible in the
plugged if it is visible in the
udev tree. This property has no
influence on the behavior when a
device disappears from the udev

View File

@ -847,7 +847,7 @@
processes and mounts private
<filename>/tmp</filename> and
<filename>/var/tmp</filename>
directories inside it that are not
directories inside it that is not
shared by processes outside of the
namespace. This is useful to secure
access to temporary files of the
@ -857,7 +857,7 @@
<filename>/var/tmp</filename>
impossible. All temporary data created
by service will be removed after
service is stopped. Defaults to
the service is stopped. Defaults to
false. Note that it is possible to run
two or more units within the same
private <filename>/tmp</filename> and

View File

@ -427,7 +427,7 @@
<programlisting>ExecStart=/bin/sh -c 'dmesg | tac'
</programlisting>
<para>Only select environment variables
<para>Only select environment variables that
are set for executed commands. See
<citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
</para>

View File

@ -165,8 +165,8 @@
assignments will have no
effect.</para>
<para>Note that timers are not
necessarily expired at the precise
<para>Note that timers do not
necessarily expire at the precise
time configured with these settings,
as they are subject to the
<varname>AccuracySec=</varname>
@ -187,8 +187,8 @@
<varname>OnActiveSec=</varname> and
related settings.</para>
<para>Note that timers are not
necessarily expired at the precise
<para>Note that timers do not
necessarily expire at the precise
time configured with this setting,
as it is subject to the
<varname>AccuracySec=</varname>
@ -201,7 +201,7 @@
<listitem><para>Specify the accuracy
the timer shall elapse with. Defaults
to 1min. The timer is scheduled to
expire within a time window starting
elapse within a time window starting
with the time specified in
<varname>OnCalendar=</varname>,
<varname>OnActiveSec=</varname>,

View File

@ -548,7 +548,7 @@
of units. When systemd stops or restarts
the units listed here, the action is
propagated to this unit.
Note that this is a one way dependency
Note that this is a one-way dependency 
changes to this unit do not affect the
listed units.
</para></listitem>

View File

@ -63,10 +63,10 @@
regardless of the directories in which they live. However, files with
identical filenames replace each other. Files in <filename>/etc</filename>
have the highest priority, files in <filename>/run</filename> take precedence
over files with the same name in <filename>/lib</filename>. This can be
over files with the same name in <filename>/usr/lib</filename>. This can be
used to override a system-supplied rules 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>,
<filename>/usr/lib</filename>, pointing to <filename>/dev/null</filename>,
disables the rules file entirely. Rule files must have the extension
<filename>.rules</filename>; other extensions are ignored.</para>
@ -715,10 +715,10 @@
regardless of the directories in which they live. However, files with
identical filenames replace each other. Files in <filename>/etc</filename>
have the highest priority, files in <filename>/run</filename> take precedence
over files with the same name in <filename>/lib</filename>. This can be
over files with the same name in <filename>/usr/lib</filename>. This can be
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 hwdb file in
<filename>/lib</filename>, pointing to <filename>/dev/null</filename>,
<filename>/usr/lib</filename>, pointing to <filename>/dev/null</filename>,
disables the hwdb file entirely. hwdb files must have the extension
<filename>.hwdb</filename>; other extensions are ignored.</para>
@ -754,10 +754,10 @@
regardless of the directories in which they live. However, files with
identical filenames replace each other. Files in <filename>/etc</filename>
have the highest priority, files in <filename>/run</filename> take precedence
over files with the same name in <filename>/lib</filename>. This can be
over files with the same name in <filename>/usr/lib</filename>. This can be
used to override a system-supplied link file with a local file if needed;
a symlink in <filename>/etc</filename> with the same name as a link file in
<filename>/lib</filename>, pointing to <filename>/dev/null</filename>,
<filename>/usr/lib</filename>, pointing to <filename>/dev/null</filename>,
disables the link file entirely.</para>
<para>The link file contains a <literal>[Match]</literal> section, which