man: wording and grammar updates

This includes regularly-submitted corrections to comma setting and
orthographical mishaps that appeared in man/ in recent commits.

In this particular commit:
- the usual comma fixes
- expand contractions (this is prose)
This commit is contained in:
Jan Engelhardt 2013-08-25 09:01:45 +02:00 committed by Lennart Poettering
parent b8ab2dc6c9
commit 6b4991cfde
19 changed files with 37 additions and 38 deletions

View File

@ -281,7 +281,7 @@
<option>short-monotonic</option>
</term>
<listitem>
<para>is very similar
<para>is very similar,
but shows monotonic
timestamps instead of
wallclock timestamps.

View File

@ -120,7 +120,7 @@
returns 0 on success or a negative errno-style error
code. <function>sd_journal_test_cursor()</function>
returns positive if the current entry matches the
specified cursor, 0 if it doesn't match the specified
specified cursor, 0 if it does not match the specified
cursor or a negative errno-style error code on
failure.</para>
</refsect1>

View File

@ -232,15 +232,15 @@ else {
<constant>SD_JOURNAL_APPEND</constant> or
<constant>SD_JOURNAL_INVALIDATE</constant> on success or
a negative errno-style error code. If
<constant>SD_JOURNAL_NOP</constant> is returned the
journal didn't change since the last invocation. If
<constant>SD_JOURNAL_APPEND</constant> is returned new
<constant>SD_JOURNAL_NOP</constant> is returned, the
journal did not change since the last invocation. If
<constant>SD_JOURNAL_APPEND</constant> is returned, new
entries have been appended to the end of the
journal. If <constant>SD_JOURNAL_INVALIDATE</constant>
journal. If <constant>SD_JOURNAL_INVALIDATE</constant>,
journal files were added or removed (possibly due to
rotation). In the latter event live-view UIs should
probably refresh their entire display while in the
case of <constant>SD_JOURNAL_APPEND</constant> it is
rotation). In the latter event, live-view UIs should
probably refresh their entire display, while in the
case of <constant>SD_JOURNAL_APPEND</constant>, it is
sufficient to simply continue reading at the previous
end of the journal.</para>
</refsect1>

View File

@ -200,7 +200,7 @@
the status was sent these functions return with a
positive return value. In order to support both, init
systems that implement this scheme and those which
don't, it is generally recommended to ignore the return
do not, it is generally recommended to ignore the return
value of this call.</para>
</refsect1>

View File

@ -133,7 +133,7 @@
<varlistentry>
<term><option>-k</option></term>
<listitem><para>Don't halt, power-off,
<listitem><para>Do not halt, power-off,
reboot, just write wall
message.</para></listitem>
</varlistentry>
@ -141,7 +141,7 @@
<varlistentry>
<term><option>--no-wall</option></term>
<listitem><para>Don't send wall
<listitem><para>Do not send wall
message before
halt, power-off, reboot.</para></listitem>
</varlistentry>

View File

@ -57,9 +57,9 @@
<para><filename>systemd-backlight@.service</filename>
is a service that restores the display backlight
brightness at early-boot and saves it at shutdown. On
disk the backlight brightness is stored in
disk, the backlight brightness is stored in
<filename>/var/lib/backlight/</filename>. Note that by
default only firmware backlight devices are
default, only firmware backlight devices are
saved/restored.</para>
</refsect1>

View File

@ -107,7 +107,7 @@
<varlistentry>
<term><option>--all</option></term>
<listitem><para>Don't hide empty
<listitem><para>Do not hide empty
control groups in the
output.</para></listitem>
</varlistentry>

View File

@ -56,7 +56,7 @@
<para><filename>systemd-efi-boot-generator</filename>
is a generator that automatically creates mount and
automount units for the EFI System Partition (ESP)
automount units for the EFI System Partition (ESP),
mounting it to <filename>/boot</filename>. Note that
this generator will execute no operation on non-EFI
systems, on systems where the boot loader does not
@ -64,7 +64,7 @@
<filename>/boot</filename> is an explicitly configured
mount (for example, listed in <citerefentry><refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum></citerefentry>) or where the <filename>/boot</filename> mount
point is non-empty. Since this generator creates an
automount unit the mount will only be activated
automount unit, the mount will only be activated
on-demand, when accessed.</para>
<para><filename>systemd-efi-boot-generator</filename>

View File

@ -334,7 +334,7 @@
<filename>/var/log/journal</filename>
exists, it will be bind mounted
into the container. If the
subdirectory doesn't exist, no
subdirectory does not exist, no
linking is performed. Effectively,
booting a container once with
<literal>guest</literal> or

View File

@ -1,4 +1,3 @@
<?xml version='1.0'?> <!--*-nxml-*-->
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
@ -327,8 +326,8 @@
absolute filename or wildcard
expression, optionally prefixed with
<literal>-</literal>, which indicates
that if the file does not exist it
won't be read and no error or warning
that if the file does not exist, it
will not be read and no error or warning
message is logged. This option may be
specified more than once in which case
all specified files are read. If the
@ -835,7 +834,7 @@
<varname>InaccessibleDirectories=</varname>
may be prefixed with
<literal>-</literal>, in which case
they will be ignored when they don't
they will be ignored when they do not
exist.</para></listitem>
</varlistentry>
@ -972,7 +971,7 @@
<function>sigreturn</function>,
<function>exit_group</function>,
<function>exit</function> system calls
are implicitly whitelisted and don't
are implicitly whitelisted and do not
need to be listed explicitly. This
option may be specified more than once
in which case the filter masks are

View File

@ -525,7 +525,7 @@
url="http://www.freedesktop.org/wiki/Software/systemd/json">Journal
JSON Format</ulink>, the addresses of journal entries
are serialized into fields prefixed with double
underscores. Note that these aren't proper fields when
underscores. Note that these are not proper fields when
stored in the journal but for addressing meta data of
entries. They cannot be written as part of structured
log entries via calls such as

View File

@ -84,7 +84,7 @@
using configuration not specified in
<filename>/etc/fstab</filename>;
<citerefentry><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
will refuse options that aren't listed in
will refuse options that are not listed in
<filename>/etc/fstab</filename> if it is not run as
UID 0.</para>

View File

@ -483,7 +483,7 @@
was stopped. This includes cases where
the commands configured in
<varname>ExecStop=</varname> were used,
where the service doesn't have any
where the service does not have any
<varname>ExecStop=</varname> defined, or
where the service exited unexpectedly. This
argument takes multiple command lines,
@ -823,7 +823,7 @@
in other words: the
<varname>Service=</varname> setting of
<filename>.socket</filename> units
doesn't have to match the inverse of
does not have to match the inverse of
the <varname>Sockets=</varname>
setting of the
<filename>.service</filename> it

View File

@ -448,7 +448,7 @@
after it. Note that networking
daemons that simply provide
functionality to other hosts
generally don't need to pull
generally do not need to pull
this in.</para>
</listitem>
</varlistentry>

View File

@ -127,7 +127,7 @@
but when the weekday is specified it must either be
in the abbreviated (<literal>Wed</literal>) or
non-abbreviated (<literal>Wednesday</literal>) English
language form (case doesn't matter), and is not
language form (case does not matter), and is not
subject to the locale choice of the user. Either the
date, or the time part may be omitted, in which case
the current date or 00:00:00, resp., is assumed. The

View File

@ -1022,7 +1022,7 @@
option prefixed with
<literal>rd.</literal> is honored
only in the initial RAM disk (initrd),
while the one that isn't prefixed only
while the one that is not prefixed only
in the main system.</para></listitem>
</varlistentry>

View File

@ -80,7 +80,7 @@
<varlistentry>
<term><option>--no-wall</option></term>
<listitem><para>Don't send wall
<listitem><para>Do not send wall
message before
reboot/halt/power-off.</para></listitem>
</varlistentry>

View File

@ -92,7 +92,7 @@
<varlistentry>
<term><option>--no-ask-password</option></term>
<listitem><para>Don't query the user
<listitem><para>Do not query the user
for authentication for privileged
operations.</para></listitem>
</varlistentry>

View File

@ -104,7 +104,7 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<variablelist>
<varlistentry>
<term><varname>f</varname></term>
<listitem><para>Create a file if it doesn't exist yet (optionally writing a short string into it, if the argument parameter is passed)</para></listitem>
<listitem><para>Create a file if it does not exist yet (optionally writing a short string into it, if the argument parameter is passed)</para></listitem>
</varlistentry>
<varlistentry>
@ -122,7 +122,7 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<varlistentry>
<term><varname>d</varname></term>
<listitem><para>Create a directory if it doesn't exist yet</para></listitem>
<listitem><para>Create a directory if it does not exist yet</para></listitem>
</varlistentry>
<varlistentry>
@ -132,22 +132,22 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<varlistentry>
<term><varname>p</varname></term>
<listitem><para>Create a named pipe (FIFO) if it doesn't exist yet</para></listitem>
<listitem><para>Create a named pipe (FIFO) if it does not exist yet</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>L</varname></term>
<listitem><para>Create a symlink if it doesn't exist yet</para></listitem>
<listitem><para>Create a symlink if it does not exist yet</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>c</varname></term>
<listitem><para>Create a character device node if it doesn't exist yet</para></listitem>
<listitem><para>Create a character device node if it does not exist yet</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>b</varname></term>
<listitem><para>Create a block device node if it doesn't exist yet</para></listitem>
<listitem><para>Create a block device node if it does not exist yet</para></listitem>
</varlistentry>
<varlistentry>