picnoir/Systemd
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

man: wording and grammar updates

Browse source 
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
Show stats Download patch file Download diff file Expand all files Collapse all files

2
man/journalctl.xml
View file

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

2
man/sd_journal_get_cursor.xml
View file

@ -120,7 +120,7 @@
returns 0 on success or a negative errno-style error returns 0 on success or a negative errno-style error
code. <function>sd_journal_test_cursor()</function> code. <function>sd_journal_test_cursor()</function>
returns positive if the current entry matches the 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 cursor or a negative errno-style error code on
failure.</para> failure.</para>
</refsect1> </refsect1>

14
man/sd_journal_get_fd.xml
View file

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

2
man/sd_notify.xml
View file

@ -200,7 +200,7 @@
the status was sent these functions return with a the status was sent these functions return with a
positive return value. In order to support both, init positive return value. In order to support both, init
systems that implement this scheme and those which 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> value of this call.</para>
</refsect1> </refsect1>

4
man/shutdown.xml
View file

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

4
man/systemd-backlight@.service.xml
View file

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

2
man/systemd-cgls.xml
View file

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

4
man/systemd-efi-boot-generator.xml
View file

@ -56,7 +56,7 @@
<para><filename>systemd-efi-boot-generator</filename> <para><filename>systemd-efi-boot-generator</filename>
is a generator that automatically creates mount and 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 mounting it to <filename>/boot</filename>. Note that
this generator will execute no operation on non-EFI this generator will execute no operation on non-EFI
systems, on systems where the boot loader does not systems, on systems where the boot loader does not
@ -64,7 +64,7 @@
<filename>/boot</filename> is an explicitly configured <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 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 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> on-demand, when accessed.</para>
<para><filename>systemd-efi-boot-generator</filename> <para><filename>systemd-efi-boot-generator</filename>

2
man/systemd-nspawn.xml
View file

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

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

2
man/systemd.journal-fields.xml
View file

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

2
man/systemd.mount.xml
View file

@ -84,7 +84,7 @@
using configuration not specified in using configuration not specified in
<filename>/etc/fstab</filename>; <filename>/etc/fstab</filename>;
<citerefentry><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry> <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 <filename>/etc/fstab</filename> if it is not run as
UID 0.</para> UID 0.</para>

4
man/systemd.service.xml
View file

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

2
man/systemd.special.xml
View file

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

2
man/systemd.time.xml
View file

@ -127,7 +127,7 @@
but when the weekday is specified it must either be but when the weekday is specified it must either be
in the abbreviated (<literal>Wed</literal>) or in the abbreviated (<literal>Wed</literal>) or
non-abbreviated (<literal>Wednesday</literal>) English 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 subject to the locale choice of the user. Either the
date, or the time part may be omitted, in which case date, or the time part may be omitted, in which case
the current date or 00:00:00, resp., is assumed. The the current date or 00:00:00, resp., is assumed. The

2
man/systemd.xml
View file

@ -1022,7 +1022,7 @@
option prefixed with option prefixed with
<literal>rd.</literal> is honored <literal>rd.</literal> is honored
only in the initial RAM disk (initrd), 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> in the main system.</para></listitem>
</varlistentry> </varlistentry>

2
man/telinit.xml
View file

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

2
man/timedatectl.xml
View file

@ -92,7 +92,7 @@
<varlistentry> <varlistentry>
<term><option>--no-ask-password</option></term> <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 for authentication for privileged
operations.</para></listitem> operations.</para></listitem>
</varlistentry> </varlistentry>

12
man/tmpfiles.d.xml
View file

@ -104,7 +104,7 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>f</varname></term> <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>
<varlistentry> <varlistentry>
@ -122,7 +122,7 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<varlistentry> <varlistentry>
<term><varname>d</varname></term> <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>
<varlistentry> <varlistentry>
@ -132,22 +132,22 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<varlistentry> <varlistentry>
<term><varname>p</varname></term> <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>
<varlistentry> <varlistentry>
<term><varname>L</varname></term> <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>
<varlistentry> <varlistentry>
<term><varname>c</varname></term> <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>
<varlistentry> <varlistentry>
<term><varname>b</varname></term> <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>
<varlistentry> <varlistentry>