As you likely know, Arch Linux is in the process of moving to systemd.
So I was reading through the various systemd docs and quickly became
baffled by this new abbreviation "resp.", which I've never seen before
in my English-mother-tongue life.
Some quick Googling turned up a reference:
<http://www.transblawg.eu/index.php?/archives/870-Resp.-and-other-non-existent-English-wordsNicht-existente-englische-Woerter.html>
I guess it's a literal translation of the German "beziehungsweise", but
English doesn't work the same way. The word "respectively" is used
exclusively to provide an ordering connection between two lists. E.g.
"the prefixes k, M, and G refer to kilo-, mega-, and giga-,
respectively." It is also never abbreviated to "resp." So the sentence
"Sets the default output resp. error output for all services and
sockets" makes no sense to a natural English speaker.
This patch removes all instances of "resp." in the man pages and
replaces them with sentences which are much more clear and, hopefully,
grammatically valid. In almost all instances, it was simply replacing
"resp." with "or," which the original author could probably just do in
the future to avoid this problem.
The only other instances of "resp." are in the src/ subtree, which I
don't feel privileged to correct.
---
man/daemon.xml | 2 +-
man/journalctl.xml | 8 ++---
man/os-release.xml | 2 +-
man/sd-daemon.xml | 2 +-
man/sd-readahead.xml | 2 +-
man/sd_booted.xml | 2 +-
man/sd_is_fifo.xml | 2 +-
man/sd_journal_next.xml | 2 +-
man/sd_listen_fds.xml | 2 +-
man/sd_notify.xml | 2 +-
man/sd_readahead.xml | 2 +-
man/systemd-ask-password-console.service.xml | 4 +--
man/systemd-cat.xml | 2 +-
man/systemd-cgtop.xml | 12 +++----
man/systemd-inhibit.xml | 5 +--
man/systemd.exec.xml | 18 +++++------
man/systemd.journal-fields.xml | 4 +--
man/systemd.kill.xml | 2 +-
man/systemd.service.xml | 2 +-
man/systemd.socket.xml | 16 +++++-----
man/systemd.swap.xml | 4 +--
man/systemd.unit.xml | 18 +++++------
man/systemd.xml | 48 ++++++++++++++--------------
23 files changed, 82 insertions(+), 81 deletions(-)
diff --git a/man/daemon.xml b/man/daemon.xml
index e3c038e..197138e 100644
--- a/man/daemon.xml
+++ b/man/daemon.xml
@@ -740,7 +740,7 @@
directory returned by <command>pkg-config
systemd
--variable=systemdsystemunitdir</command> (for
- system services), resp. <command>pkg-config
+ system services) or <command>pkg-config
systemd
--variable=systemduserunitdir</command>
(for user services). This will make the
diff --git a/man/journalctl.xml b/man/journalctl.xml
index 3786fdf..da6bce2 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -275,8 +275,8 @@
<term><option>--until=</option></term>
<listitem><para>Start showing entries
- newer or of the specified date,
- resp. older or of the specified
+ newer than the specified date,
+ or older than the specified
date. Date specifications should be of
the format "2012-10-30 18:17:16". If
the time part is omitted, 00:00:00 is
@@ -290,13 +290,13 @@
<literal>tomorrow</literal> are
understood, which refer to 00:00:00 of
the day before the current day, the
- current day, resp the day after the
+ current day, or the day after the
current day. <literal>now</literal>
refers to the current time. Finally,
relative times may be specified,
prefixed with <literal>-</literal> or
<literal>+</literal>, referring to
- times before resp. after the current
+ times before or after the current
time.</para></listitem>
</varlistentry>
diff --git a/man/os-release.xml b/man/os-release.xml
index 5e34a88..b39f95a 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -280,7 +280,7 @@
"About this system" UIs behind links
with captions such as "About this
Operating System", "Obtain Support"
- resp. "Report a Bug". The values should
+ or "Report a Bug". The values should
be in <ulink
url="https://tools.ietf.org/html/rfc3986";>RFC3986
format</ulink>, and should be
diff --git a/man/sd-daemon.xml b/man/sd-daemon.xml
index 1e1734a..8d1986d 100644
--- a/man/sd-daemon.xml
+++ b/man/sd-daemon.xml
@@ -139,7 +139,7 @@
check the liberally licensed reference implementation
sources:
<ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/libsystemd-daemon/sd-daemon.c"/>
- resp. <ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-daemon.h"/></para>
+ or <ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-daemon.h"/></para>
<para>These APIs are implemented in the reference
implementation's <filename>sd-daemon.c</filename> and
diff --git a/man/sd-readahead.xml b/man/sd-readahead.xml
index 484e127..aa4702d 100644
--- a/man/sd-readahead.xml
+++ b/man/sd-readahead.xml
@@ -87,7 +87,7 @@
check the liberally licensed reference implementation
sources:
<ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/readahead/sd-readahead.c"/>
- resp. <ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-readahead.h"/></para>
+ or <ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-readahead.h"/></para>
<para>These APIs are implemented in the reference
implementation's drop-in
diff --git a/man/sd_booted.xml b/man/sd_booted.xml
index 3567d58..5706b79 100644
--- a/man/sd_booted.xml
+++ b/man/sd_booted.xml
@@ -94,7 +94,7 @@
<para>For details about the algorithm check the
liberally licensed reference implementation sources:
<ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/libsystemd-daemon/sd-daemon.c"/>
- resp. <ulink
+ or <ulink
url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-daemon.h"/></para>
<para><function>sd_booted()</function> is implemented
diff --git a/man/sd_is_fifo.xml b/man/sd_is_fifo.xml
index a98122b..264cc54 100644
--- a/man/sd_is_fifo.xml
+++ b/man/sd_is_fifo.xml
@@ -181,7 +181,7 @@
<para>For details about the algorithms check the
liberally licensed reference implementation sources:
<ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/libsystemd-daemon/sd-daemon.c"/>
- resp. <ulink
+ or <ulink
url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-daemon.h"/></para>
<para><function>sd_is_fifo()</function> and the
diff --git a/man/sd_journal_next.xml b/man/sd_journal_next.xml
index 95429fa..b0e64b6 100644
--- a/man/sd_journal_next.xml
+++ b/man/sd_journal_next.xml
@@ -140,7 +140,7 @@
<para>The four calls return the number of entries
advanced/set back on success or a negative errno-style
- error code. When the end (resp. beginning) of the journal
+ error code. When the end (or beginning) of the journal
is reached a number smaller than requested is
returned. More specifically, if
<function>sd_journal_next()</function> or
diff --git a/man/sd_listen_fds.xml b/man/sd_listen_fds.xml
index 649b199..d20dd1f 100644
--- a/man/sd_listen_fds.xml
+++ b/man/sd_listen_fds.xml
@@ -142,7 +142,7 @@
<para>For details about the algorithm check the
liberally licensed reference implementation sources:
<ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/libsystemd-daemon/sd-daemon.c"/>
- resp. <ulink
+ or <ulink
url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-daemon.h"/></para>
<para><function>sd_listen_fds()</function> is
diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index 346ec8f..b7d2939 100644
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -228,7 +228,7 @@
<para>For details about the algorithms check the
liberally licensed reference implementation sources:
<ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/libsystemd-daemon/sd-daemon.c"/>
- resp. <ulink
+ or <ulink
url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-daemon.h"/></para>
<para><function>sd_notify()</function> and
diff --git a/man/sd_readahead.xml b/man/sd_readahead.xml
index ff7b355..978e453 100644
--- a/man/sd_readahead.xml
+++ b/man/sd_readahead.xml
@@ -130,7 +130,7 @@
<para>For details about the algorithm check the
liberally licensed reference implementation sources:
<ulink url="http://cgit.freedesktop.org/systemd/systemd/plain/src/readahead/sd-readahead.c"/>
- resp. <ulink
+ or <ulink
url="http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-readahead.h"/></para>
<para><function>sd_readahead()</function> is
diff --git a/man/systemd-ask-password-console.service.xml b/man/systemd-ask-password-console.service.xml
index 6ca9436..6c87feb 100644
--- a/man/systemd-ask-password-console.service.xml
+++ b/man/systemd-ask-password-console.service.xml
@@ -79,8 +79,8 @@
<para>Note that these services invoke
<citerefentry><refentrytitle>systemd-tty-ask-password-agent</refentrytitle><manvolnum>1</manvolnum></citerefentry>
- with the <command>--watch --console</command>
- resp. <command>--watch --wall</command> command line
+ with either the <command>--watch --console</command>
+ or <command>--watch --wall</command> command line
parameters.</para>
</refsect1>
diff --git a/man/systemd-cat.xml b/man/systemd-cat.xml
index 54e2872..cac275b 100644
--- a/man/systemd-cat.xml
+++ b/man/systemd-cat.xml
@@ -120,7 +120,7 @@
<literal>warning</literal>,
<literal>notice</literal>,
<literal>info</literal>,
- <literal>debug</literal>, resp. a
+ <literal>debug</literal>, or a
value between 0 and 7 (corresponding
to the same named levels). These
priority values are the same as
diff --git a/man/systemd-cgtop.xml b/man/systemd-cgtop.xml
index 112e5ff..7a34512 100644
--- a/man/systemd-cgtop.xml
+++ b/man/systemd-cgtop.xml
@@ -238,19 +238,19 @@
<term>m</term>
<term>i</term>
- <listitem><para>Change ordering of control groups
+ <listitem><para>Sort the control groups
by path, number of tasks, CPU load,
- memory usage resp. IO
- load.</para></listitem>
+ memory usage, or IO
+ load, respectively.</para></listitem>
</varlistentry>
<varlistentry>
<term>+</term>
<term>-</term>
- <listitem><para>Increase,
- resp. decrease refresh
- delay.</para></listitem>
+ <listitem><para>Increase
+ or decrease refresh
+ delay, respectively.</para></listitem>
</varlistentry>
</variablelist>
diff --git a/man/systemd-inhibit.xml b/man/systemd-inhibit.xml
index 1218836..5f26c96 100644
--- a/man/systemd-inhibit.xml
+++ b/man/systemd-inhibit.xml
@@ -114,9 +114,10 @@
for inhibiting
reboot/power-off/halt/kexec,
suspending/hibernating, the automatic
- idle detection, resp. the low-level
+ idle detection, or the low-level
handling of the power/sleep key and
- the lid switch. If omitted defaults to
+ the lid switch, respectively. If omitted,
+ defaults to
<literal>idle:sleep:shutdown</literal>.</para></listitem>
</varlistentry>
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index 7ab9b5c..7c9c6b5 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -75,7 +75,7 @@
for more information on the specific unit
configuration files. The execution specific
configuration options are configured in the [Service],
- [Socket], [Mount] resp. [Swap] section, depending on the unit
+ [Socket], [Mount], or [Swap] sections, depending on the unit
type.</para>
</refsect1>
@@ -117,10 +117,10 @@
<term><varname>Group=</varname></term>
<listitem><para>Sets the Unix user
- resp. group the processes are executed
- as. Takes a single user resp. group
+ or group that the processes are executed
+ as, respectively. Takes a single user or group
name or ID as argument. If no group is
- set the default group of the user is
+ set, the default group of the user is
chosen.</para></listitem>
</varlistentry>
@@ -868,8 +868,8 @@
the value is suffixed with K, M, G or
T the specified memory size is parsed
as Kilobytes, Megabytes, Gigabytes,
- resp. Terabytes (to the base
- 1024). This controls the
+ or Terabytes (to the base
+ 1024), respectively. This controls the
<literal>memory.limit_in_bytes</literal>
and
<literal>memory.soft_limit_in_bytes</literal>
@@ -889,9 +889,9 @@
path (such as
<filename>/dev/null</filename>)
followed by a combination of r, w, m
- to control reading, writing resp.
+ to control reading, writing, or
creating of the specific device node
- by the unit. This controls the
+ by the unit, respectively. This controls the
<literal>devices.allow</literal>
and
<literal>devices.deny</literal>
@@ -948,7 +948,7 @@
If the bandwidth is suffixed with K, M,
G, or T the specified bandwidth is
parsed as Kilobytes, Megabytes,
- Gigabytes, resp. Terabytes (Example:
+ Gigabytes, or Terabytes (Example:
"/dev/disk/by-path/pci-0000:00:1f.2-scsi-0:0:0:0
5M"). This controls the
<literal>blkio.read_bps_device</literal>
diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml
index d1cb40b..e212c81 100644
--- a/man/systemd.journal-fields.xml
+++ b/man/systemd.journal-fields.xml
@@ -298,8 +298,8 @@
journal protocol, for the
those read from a services'
standard output or error
- output, and for those read
- from the kernel, resp.
+ output, or for those read
+ from the kernel, respectively.
</para>
</listitem>
</varlistentry>
diff --git a/man/systemd.kill.xml b/man/systemd.kill.xml
index 3300534..c7b3503 100644
--- a/man/systemd.kill.xml
+++ b/man/systemd.kill.xml
@@ -75,7 +75,7 @@
for more information on the specific unit
configuration files. The execution specific
configuration options are configured in the [Service],
- [Socket], [Mount] resp. [Swap] section, depending on the unit
+ [Socket], [Mount] or [Swap] section, depending on the unit
type.</para>
</refsect1>
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 339dea9..dd6a5be 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -372,7 +372,7 @@
<term><varname>ExecStartPre=</varname></term>
<term><varname>ExecStartPost=</varname></term>
<listitem><para>Additional commands
- that are executed before (resp. after)
+ that are executed before (or after)
the command in
<varname>ExecStart=</varname>. Multiple
command lines may be concatenated in a
diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml
index 7885b07..1694779 100644
--- a/man/systemd.socket.xml
+++ b/man/systemd.socket.xml
@@ -150,9 +150,9 @@
<term><varname>ListenSequentialPacket=</varname></term>
<listitem><para>Specifies an address
to listen on for a stream
- (SOCK_STREAM), datagram (SOCK_DGRAM)
- resp. sequential packet
- (SOCK_SEQPACKET) socket. The address
+ (SOCK_STREAM), datagram (SOCK_DGRAM),
+ or sequential packet
+ (SOCK_SEQPACKET) socket, respectively. The address
can be written in various formats:</para>
<para>If the address starts with a
@@ -434,9 +434,9 @@
<term><varname>SendBuffer=</varname></term>
<listitem><para>Takes an integer
argument controlling the receive
- resp. send buffer sizes of this
+ or send buffer sizes of this
socket. This controls the SO_RCVBUF
- resp. SO_SNDBUF socket options (see
+ and SO_SNDBUF socket options (see
<citerefentry><refentrytitle>socket</refentrytitle><manvolnum>7</manvolnum></citerefentry>
for details.).</para></listitem>
</varlistentry>
@@ -499,7 +499,7 @@
<varname>MessageQueueMessageSize=</varname></term>
<listitem><para>These two settings
take integer values and control the
- mq_maxmsg resp. mq_msgsize field when
+ mq_maxmsg field or the mq_msgsize field when
creating the message queue. Note that
either none or both of these variables
need to be set. See
@@ -581,7 +581,7 @@
<term><varname>ExecStartPost=</varname></term>
<listitem><para>Takes one or more
command lines, which are executed
- before (resp. after) the listening
+ before (or after) the listening
sockets/FIFOs are created and
bound. The first token of the command
line must be an absolute file name,
@@ -597,7 +597,7 @@
<term><varname>ExecStopPre=</varname></term>
<term><varname>ExecStopPost=</varname></term>
<listitem><para>Additional commands
- that are executed before (resp. after)
+ that are executed before (or after)
the listening sockets/FIFOs are closed
and removed. Multiple command lines
may be specified following the same
diff --git a/man/systemd.swap.xml b/man/systemd.swap.xml
index 5eb008d..a80dccc 100644
--- a/man/systemd.swap.xml
+++ b/man/systemd.swap.xml
@@ -78,7 +78,7 @@
terminated.</para>
<para>Swap units must be named after the devices
- (resp. files) they control. Example: the swap device
+ (or files) they control. Example: the swap device
<filename>/dev/sda5</filename> must be configured in a
unit file <filename>dev-sda5.swap</filename>. For
details about the escaping logic used to convert a
@@ -86,7 +86,7 @@
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
<para>All swap units automatically get the appropriate
- dependencies on the devices (resp. on the mount points
+ dependencies on the devices (or on the mount points
of the files) they are activated from.</para>
<para>Swap units with
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 5556968..54714f1 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -77,7 +77,7 @@
<para>This man pages lists the common configuration
options of all the unit types. These options need to
- be configured in the [Unit] resp. [Install]
+ be configured in the [Unit] or [Install]
section of the unit files.</para>
<para>In addition to the generic [Unit] and [Install]
@@ -418,7 +418,7 @@
<listitem><para>Similar to
<varname>Requires=</varname>
- resp. <varname>RequiresOverridable=</varname>. However,
+ and <varname>RequiresOverridable=</varname>. However,
if a unit listed here is not started
already it will not be started and the
transaction fails
@@ -566,7 +566,7 @@
<varname>Before=</varname>. If two
units have no ordering dependencies
between them they are shut down
- resp. started up simultaneously, and
+ or started up simultaneously, and
no ordering takes
place. </para></listitem>
</varlistentry>
@@ -672,13 +672,13 @@
<listitem><para>Takes a boolean
argument. If <option>true</option>
this unit can only be activated
- (resp. deactivated) indirectly. In
+ (or deactivated) indirectly. In
this case explicit start-up
- (resp. termination) requested by the
+ (or termination) requested by the
user is denied, however if it is
- started (resp. stopped) as a
+ started (or stopped) as a
dependency of another unit, start-up
- (resp. termination) will succeed. This
+ (or termination) will succeed. This
is mostly a safety feature to ensure
that the user does not accidentally
activate units that are not intended
@@ -1023,8 +1023,8 @@
<listitem><para>Installs a symlink in
the <filename>.wants/</filename>
- resp. <filename>.requires/</filename>
- subdirectory for a unit. This has the
+ or <filename>.requires/</filename>
+ subdirectory for a unit, respectively. This has the
effect that when the listed unit name
is activated the unit listing it is
activated
diff --git a/man/systemd.xml b/man/systemd.xml
index 01833f6..b81ad96 100644
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -145,10 +145,10 @@
<term><option>--user</option></term>
<listitem><para>Tell systemd to run a
- system instance (resp. user
+ system instance (or user
instance), even if the process ID is
- not 1 (resp. is 1), i.e. systemd is
- not (resp. is) run as init process.
+ not 1 (or is 1), i.e. systemd is
+ not (or is) run as init process.
Normally it should not be necessary to
pass these options, as systemd
automatically detects the mode it is
@@ -251,11 +251,11 @@
<term><option>--default-standard-error=</option></term>
<listitem><para>Sets the default
- output resp. error output for all
+ output or error output for all
services and sockets, i.e. controls
the default for
<option>StandardOutput=</option>
- resp. <option>StandardError=</option>
+ and <option>StandardError=</option>
(see
<citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for details). Takes one of
@@ -495,12 +495,12 @@
Specification</ulink>.</para>
<para>Systems which invoke systemd in a container
- resp. initrd environment should implement the
+ or initrd environment should implement the
<ulink
url="http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface";>Container
- Interface</ulink> resp. <ulink
+ Interface</ulink> or <ulink
url="http://www.freedesktop.org/wiki/Software/systemd/InitrdInterface";>initrd
- Interface</ulink> specifications.</para>
+ Interface</ulink> specifications, respectively.</para>
</refsect1>
<refsect1>
@@ -825,11 +825,11 @@
<listitem><para>Sets the log level to
<literal>debug</literal>
- (resp. <literal>info</literal> on
+ (or <literal>info</literal> on
<literal>SIGRTMIN+23</literal>), as
controlled via
<varname>systemd.log_level=debug</varname>
- (resp. <varname>systemd.log_level=info</varname>
+ (or <varname>systemd.log_level=info</varname>
on <literal>SIGRTMIN+23</literal>) on
the kernel command
line.</para></listitem>
@@ -843,19 +843,19 @@
<listitem><para>Sets the log level to
<literal>journal-or-kmsg</literal>
- (resp. <literal>console</literal> on
- <literal>SIGRTMIN+27</literal>;
- resp. <literal>kmsg</literal> on
- <literal>SIGRTMIN+28</literal>;
- resp. <literal>syslog-or-kmsg</literal>
+ (or <literal>console</literal> on
+ <literal>SIGRTMIN+27</literal>,
+ <literal>kmsg</literal> on
+ <literal>SIGRTMIN+28</literal>,
+ or <literal>syslog-or-kmsg</literal>
on <literal>SIGRTMIN+29</literal>), as
controlled via
<varname>systemd.log_target=journal-or-kmsg</varname>
- (resp. <varname>systemd.log_target=console</varname>
- on <literal>SIGRTMIN+27</literal>;
- resp. <varname>systemd.log_target=kmsg</varname>
- on <literal>SIGRTMIN+28</literal>;
- resp
+ (or <varname>systemd.log_target=console</varname>
+ on <literal>SIGRTMIN+27</literal>,
+ <varname>systemd.log_target=kmsg</varname>
+ on <literal>SIGRTMIN+28</literal>,
+ or
<varname>systemd.log_target=syslog-or-kmsg</varname>
on <literal>SIGRTMIN+29</literal>) on
the kernel command
@@ -1076,7 +1076,7 @@
standard output/error output for
services, with the same effect as the
<option>--default-standard-output=</option>
- resp. <option>--default-standard-error=</option>
+ and <option>--default-standard-error=</option>
command line arguments described
above.</para></listitem>
</varlistentry>
@@ -1143,12 +1143,12 @@
<term><varname>5</varname></term>
<listitem><para>Boot into the
- specified legacy SysV runlevel. This
- is equivalent to
+ specified legacy SysV runlevel. These
+ are equivalent to
<varname>systemd.unit=runlevel2.target</varname>,
<varname>systemd.unit=runlevel3.target</varname>,
<varname>systemd.unit=runlevel4.target</varname>,
- resp. <varname>systemd.unit=runlevel5.target</varname>
+ and <varname>systemd.unit=runlevel5.target</varname>, respectively,
and provided for compatibility reasons
and to be easier to
type.</para></listitem>
_______________________________________________
systemd-devel mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/systemd-devel
