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:
parent
b040723ea4
commit
e0e009c067
|
@ -408,7 +408,7 @@
|
||||||
description files.</para>
|
description files.</para>
|
||||||
|
|
||||||
<para>In systemd, if the developer or
|
<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,
|
other unit is activated automatically on boot,
|
||||||
it is recommended to place a symlink to the
|
it is recommended to place a symlink to the
|
||||||
unit file in the <filename>.wants/</filename>
|
unit file in the <filename>.wants/</filename>
|
||||||
|
|
|
@ -119,7 +119,7 @@
|
||||||
<para>When outputing to a tty, lines are colored
|
<para>When outputing to a tty, lines are colored
|
||||||
according to priority: lines of level ERROR and higher
|
according to priority: lines of level ERROR and higher
|
||||||
are colored red; lines of level NOTICE and higher are
|
are colored red; lines of level NOTICE and higher are
|
||||||
highlighted; and other lines are displayed normally.
|
highlighted; other lines are displayed normally.
|
||||||
</para>
|
</para>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
|
||||||
|
@ -232,7 +232,7 @@
|
||||||
<term><option>-r</option></term>
|
<term><option>-r</option></term>
|
||||||
<term><option>--reverse</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>
|
entries are displayed first.</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
|
|
@ -85,7 +85,7 @@
|
||||||
field.</para>
|
field.</para>
|
||||||
|
|
||||||
<para>Both functions take a message object as first
|
<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>
|
in.</para>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
|
||||||
|
@ -97,7 +97,7 @@
|
||||||
errno-style error code.</para>
|
errno-style error code.</para>
|
||||||
|
|
||||||
<para>On success, the cookie/reply cookie is returned
|
<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>
|
||||||
|
|
||||||
<refsect1>
|
<refsect1>
|
||||||
|
@ -122,7 +122,7 @@
|
||||||
been sent yet and hence has no cookie
|
been sent yet and hence has no cookie
|
||||||
assigned, or that the message is not a
|
assigned, or that the message is not a
|
||||||
method response message and hence
|
method response message and hence
|
||||||
carries to reply cookie
|
carries a reply cookie
|
||||||
field.</para></listitem>
|
field.</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
</variablelist>
|
</variablelist>
|
||||||
|
|
|
@ -81,7 +81,7 @@
|
||||||
<term><varname>SD_BUS_NAME_ALLOW_REPLACEMENT</varname></term>
|
<term><varname>SD_BUS_NAME_ALLOW_REPLACEMENT</varname></term>
|
||||||
|
|
||||||
<listitem><para>After acquiring the
|
<listitem><para>After acquiring the
|
||||||
name successuflly, permit other peers
|
name successfully, permit other peers
|
||||||
to take over the name when they try to
|
to take over the name when they try to
|
||||||
acquire it with the
|
acquire it with the
|
||||||
<varname>SD_BUS_NAME_REPLACE_EXISTING</varname>
|
<varname>SD_BUS_NAME_REPLACE_EXISTING</varname>
|
||||||
|
@ -95,10 +95,10 @@
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><varname>SD_BUS_NAME_REPLACE_EXISTING</varname></term>
|
<term><varname>SD_BUS_NAME_REPLACE_EXISTING</varname></term>
|
||||||
|
|
||||||
<listitem><para>Take over a the name
|
<listitem><para>Take over the name
|
||||||
if it is already acquired by a another
|
if it is already acquired by another
|
||||||
peer, and that other peer permitted
|
peer, and that other peer has permitted
|
||||||
taking it over by setting
|
takeover by setting
|
||||||
<varname>SD_BUS_NAME_ALLOW_REPLACEMENT</varname>
|
<varname>SD_BUS_NAME_ALLOW_REPLACEMENT</varname>
|
||||||
while acquiring it.</para></listitem>
|
while acquiring it.</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
@ -106,8 +106,8 @@
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><varname>SD_BUS_NAME_QUEUE</varname></term>
|
<term><varname>SD_BUS_NAME_QUEUE</varname></term>
|
||||||
|
|
||||||
<listitem><para>Queue name
|
<listitem><para>Queue the acquisition
|
||||||
acquisition when the name is already
|
of the name when the name is already
|
||||||
taken.</para></listitem>
|
taken.</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
</variablelist>
|
</variablelist>
|
||||||
|
@ -165,7 +165,7 @@
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><varname>-ESRCH</varname></term>
|
<term><varname>-ESRCH</varname></term>
|
||||||
|
|
||||||
<listitem><para>It was attemted to
|
<listitem><para>It was attempted to
|
||||||
release a name that is currently not
|
release a name that is currently not
|
||||||
registered on the
|
registered on the
|
||||||
bus.</para></listitem>
|
bus.</para></listitem>
|
||||||
|
@ -174,7 +174,7 @@
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><varname>-EADDRINUSE</varname></term>
|
<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
|
release a name that is owned by a
|
||||||
different peer on the
|
different peer on the
|
||||||
bus.</para></listitem>
|
bus.</para></listitem>
|
||||||
|
@ -199,7 +199,7 @@
|
||||||
|
|
||||||
<listitem><para>The bus connection has
|
<listitem><para>The bus connection has
|
||||||
been created in a different process
|
been created in a different process
|
||||||
than the current.</para></listitem>
|
than the current one.</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
</variablelist>
|
</variablelist>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
|
|
@ -165,7 +165,7 @@
|
||||||
called to check whether the specified file descriptor
|
called to check whether the specified file descriptor
|
||||||
refers to a special file. If the
|
refers to a special file. If the
|
||||||
<parameter>path</parameter> parameter is not
|
<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
|
descriptor is bound to the specified file
|
||||||
name. Special files in this context are character
|
name. Special files in this context are character
|
||||||
device nodes and files in <filename>/proc</filename>
|
device nodes and files in <filename>/proc</filename>
|
||||||
|
|
|
@ -194,8 +194,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
||||||
<term><option>--job-mode=</option></term>
|
<term><option>--job-mode=</option></term>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>When queuing a new job, control how to deal with already
|
<para>When queuing a new job, this option controls how to deal with
|
||||||
queued jobs. Takes one of <literal>fail</literal>,
|
already queued jobs. It takes one of <literal>fail</literal>,
|
||||||
<literal>replace</literal>,
|
<literal>replace</literal>,
|
||||||
<literal>replace-irreversibly</literal>,
|
<literal>replace-irreversibly</literal>,
|
||||||
<literal>isolate</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>
|
<term><command>list-sockets <optional><replaceable>PATTERN</replaceable>...</optional></command></term>
|
||||||
|
|
||||||
<listitem>
|
<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
|
If one or more <replaceable>PATTERN</replaceable>s are
|
||||||
specified, only socket units matching one of them are
|
specified, only socket units matching one of them are
|
||||||
shown. Produces output similar to
|
shown. Produces output similar to
|
||||||
|
@ -692,7 +692,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Check whether any of the specified units are active
|
<para>Check whether any of the specified units are active
|
||||||
(i.e. running). Returns an exit code 0 if at least one is
|
(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
|
is specified, this will also print the current unit state to
|
||||||
STDOUT.</para>
|
STDOUT.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
|
@ -64,8 +64,8 @@
|
||||||
<para>Network configurations applied before networkd is started
|
<para>Network configurations applied before networkd is started
|
||||||
are not removed, and configuration applied by networkd are not
|
are not removed, and configuration applied by networkd are not
|
||||||
removed when networkd exits. This ensures restarting networkd
|
removed when networkd exits. This ensures restarting networkd
|
||||||
does not cut the network connection, and in particular that it
|
does not cut the network connection, and, in particular, that
|
||||||
is safe to transition between the initrd and the real root,
|
it is safe to transition between the initrd and the real root,
|
||||||
and back.</para>
|
and back.</para>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
|
||||||
|
@ -80,10 +80,10 @@
|
||||||
identical filenames replace each other. Files in
|
identical filenames replace each other. Files in
|
||||||
<filename>/etc</filename> have the highest priority, files in
|
<filename>/etc</filename> have the highest priority, files in
|
||||||
<filename>/run</filename> take precedence over files with the same
|
<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
|
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>/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>
|
disables the configuration file entirely.</para>
|
||||||
|
|
||||||
<refsect2><title>Virtual Network Devices</title>
|
<refsect2><title>Virtual Network Devices</title>
|
||||||
|
|
|
@ -149,7 +149,7 @@
|
||||||
even if it shows up in the udev
|
even if it shows up in the udev
|
||||||
tree. If this property is unset or set
|
tree. If this property is unset or set
|
||||||
to 1, the device will be considered
|
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
|
udev tree. This property has no
|
||||||
influence on the behavior when a
|
influence on the behavior when a
|
||||||
device disappears from the udev
|
device disappears from the udev
|
||||||
|
|
|
@ -847,7 +847,7 @@
|
||||||
processes and mounts private
|
processes and mounts private
|
||||||
<filename>/tmp</filename> and
|
<filename>/tmp</filename> and
|
||||||
<filename>/var/tmp</filename>
|
<filename>/var/tmp</filename>
|
||||||
directories inside it that are not
|
directories inside it that is not
|
||||||
shared by processes outside of the
|
shared by processes outside of the
|
||||||
namespace. This is useful to secure
|
namespace. This is useful to secure
|
||||||
access to temporary files of the
|
access to temporary files of the
|
||||||
|
@ -857,7 +857,7 @@
|
||||||
<filename>/var/tmp</filename>
|
<filename>/var/tmp</filename>
|
||||||
impossible. All temporary data created
|
impossible. All temporary data created
|
||||||
by service will be removed after
|
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
|
false. Note that it is possible to run
|
||||||
two or more units within the same
|
two or more units within the same
|
||||||
private <filename>/tmp</filename> and
|
private <filename>/tmp</filename> and
|
||||||
|
|
|
@ -427,7 +427,7 @@
|
||||||
<programlisting>ExecStart=/bin/sh -c 'dmesg | tac'
|
<programlisting>ExecStart=/bin/sh -c 'dmesg | tac'
|
||||||
</programlisting>
|
</programlisting>
|
||||||
|
|
||||||
<para>Only select environment variables
|
<para>Only select environment variables that
|
||||||
are set for executed commands. See
|
are set for executed commands. See
|
||||||
<citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
|
<citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
|
||||||
</para>
|
</para>
|
||||||
|
|
|
@ -165,8 +165,8 @@
|
||||||
assignments will have no
|
assignments will have no
|
||||||
effect.</para>
|
effect.</para>
|
||||||
|
|
||||||
<para>Note that timers are not
|
<para>Note that timers do not
|
||||||
necessarily expired at the precise
|
necessarily expire at the precise
|
||||||
time configured with these settings,
|
time configured with these settings,
|
||||||
as they are subject to the
|
as they are subject to the
|
||||||
<varname>AccuracySec=</varname>
|
<varname>AccuracySec=</varname>
|
||||||
|
@ -187,8 +187,8 @@
|
||||||
<varname>OnActiveSec=</varname> and
|
<varname>OnActiveSec=</varname> and
|
||||||
related settings.</para>
|
related settings.</para>
|
||||||
|
|
||||||
<para>Note that timers are not
|
<para>Note that timers do not
|
||||||
necessarily expired at the precise
|
necessarily expire at the precise
|
||||||
time configured with this setting,
|
time configured with this setting,
|
||||||
as it is subject to the
|
as it is subject to the
|
||||||
<varname>AccuracySec=</varname>
|
<varname>AccuracySec=</varname>
|
||||||
|
@ -201,7 +201,7 @@
|
||||||
<listitem><para>Specify the accuracy
|
<listitem><para>Specify the accuracy
|
||||||
the timer shall elapse with. Defaults
|
the timer shall elapse with. Defaults
|
||||||
to 1min. The timer is scheduled to
|
to 1min. The timer is scheduled to
|
||||||
expire within a time window starting
|
elapse within a time window starting
|
||||||
with the time specified in
|
with the time specified in
|
||||||
<varname>OnCalendar=</varname>,
|
<varname>OnCalendar=</varname>,
|
||||||
<varname>OnActiveSec=</varname>,
|
<varname>OnActiveSec=</varname>,
|
||||||
|
|
|
@ -548,7 +548,7 @@
|
||||||
of units. When systemd stops or restarts
|
of units. When systemd stops or restarts
|
||||||
the units listed here, the action is
|
the units listed here, the action is
|
||||||
propagated to this unit.
|
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
|
changes to this unit do not affect the
|
||||||
listed units.
|
listed units.
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
|
|
12
man/udev.xml
12
man/udev.xml
|
@ -63,10 +63,10 @@
|
||||||
regardless of the directories in which they live. However, files with
|
regardless of the directories in which they live. However, files with
|
||||||
identical filenames replace each other. Files in <filename>/etc</filename>
|
identical filenames replace each other. Files in <filename>/etc</filename>
|
||||||
have the highest priority, files in <filename>/run</filename> take precedence
|
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;
|
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
|
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
|
disables the rules file entirely. Rule files must have the extension
|
||||||
<filename>.rules</filename>; other extensions are ignored.</para>
|
<filename>.rules</filename>; other extensions are ignored.</para>
|
||||||
|
|
||||||
|
@ -715,10 +715,10 @@
|
||||||
regardless of the directories in which they live. However, files with
|
regardless of the directories in which they live. However, files with
|
||||||
identical filenames replace each other. Files in <filename>/etc</filename>
|
identical filenames replace each other. Files in <filename>/etc</filename>
|
||||||
have the highest priority, files in <filename>/run</filename> take precedence
|
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;
|
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
|
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
|
disables the hwdb file entirely. hwdb files must have the extension
|
||||||
<filename>.hwdb</filename>; other extensions are ignored.</para>
|
<filename>.hwdb</filename>; other extensions are ignored.</para>
|
||||||
|
|
||||||
|
@ -754,10 +754,10 @@
|
||||||
regardless of the directories in which they live. However, files with
|
regardless of the directories in which they live. However, files with
|
||||||
identical filenames replace each other. Files in <filename>/etc</filename>
|
identical filenames replace each other. Files in <filename>/etc</filename>
|
||||||
have the highest priority, files in <filename>/run</filename> take precedence
|
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;
|
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
|
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>
|
disables the link file entirely.</para>
|
||||||
|
|
||||||
<para>The link file contains a <literal>[Match]</literal> section, which
|
<para>The link file contains a <literal>[Match]</literal> section, which
|
||||||
|
|
Loading…
Reference in New Issue