From e0e009c067aa7237f9683c46e5845bbb11ec67c2 Mon Sep 17 00:00:00 2001 From: Jan Engelhardt Date: Thu, 26 Dec 2013 02:47:45 +0100 Subject: [PATCH] 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. --- man/daemon.xml | 2 +- man/journalctl.xml | 4 ++-- man/sd_bus_message_get_cookie.xml | 6 +++--- man/sd_bus_request_name.xml | 20 ++++++++++---------- man/sd_is_fifo.xml | 2 +- man/systemctl.xml | 8 ++++---- man/systemd-networkd.service.xml | 8 ++++---- man/systemd.device.xml | 2 +- man/systemd.exec.xml | 4 ++-- man/systemd.service.xml | 2 +- man/systemd.timer.xml | 10 +++++----- man/systemd.unit.xml | 2 +- man/udev.xml | 12 ++++++------ 13 files changed, 41 insertions(+), 41 deletions(-) diff --git a/man/daemon.xml b/man/daemon.xml index 7790420c6..1fe4546f0 100644 --- a/man/daemon.xml +++ b/man/daemon.xml @@ -408,7 +408,7 @@ description files. 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 .wants/ diff --git a/man/journalctl.xml b/man/journalctl.xml index 6a972109c..55474c53d 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -119,7 +119,7 @@ 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. @@ -232,7 +232,7 @@ - Reverse output so the newest + Reverse output so that the newest entries are displayed first. diff --git a/man/sd_bus_message_get_cookie.xml b/man/sd_bus_message_get_cookie.xml index 0e3c4ba72..bf403a222 100644 --- a/man/sd_bus_message_get_cookie.xml +++ b/man/sd_bus_message_get_cookie.xml @@ -85,7 +85,7 @@ field. 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. @@ -97,7 +97,7 @@ errno-style error code. On success, the cookie/reply cookie is returned - in the specified 64bit unsigned integer variable. + in the specified 64-bit unsigned integer variable. @@ -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. diff --git a/man/sd_bus_request_name.xml b/man/sd_bus_request_name.xml index c84b0b62f..7393fdd90 100644 --- a/man/sd_bus_request_name.xml +++ b/man/sd_bus_request_name.xml @@ -81,7 +81,7 @@ SD_BUS_NAME_ALLOW_REPLACEMENT 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 SD_BUS_NAME_REPLACE_EXISTING @@ -95,10 +95,10 @@ SD_BUS_NAME_REPLACE_EXISTING - Take over a the name - if it is already acquired by a another - peer, and that other peer permitted - taking it over by setting + Take over the name + if it is already acquired by another + peer, and that other peer has permitted + takeover by setting SD_BUS_NAME_ALLOW_REPLACEMENT while acquiring it. @@ -106,8 +106,8 @@ SD_BUS_NAME_QUEUE - Queue name - acquisition when the name is already + Queue the acquisition + of the name when the name is already taken. @@ -165,7 +165,7 @@ -ESRCH - It was attemted to + It was attempted to release a name that is currently not registered on the bus. @@ -174,7 +174,7 @@ -EADDRINUSE - It was attemted to + It was attempted to release a name that is owned by a different peer on the bus. @@ -199,7 +199,7 @@ The bus connection has been created in a different process - than the current. + than the current one. diff --git a/man/sd_is_fifo.xml b/man/sd_is_fifo.xml index 4bb2236fc..58cd1c91b 100644 --- a/man/sd_is_fifo.xml +++ b/man/sd_is_fifo.xml @@ -165,7 +165,7 @@ called to check whether the specified file descriptor refers to a special file. If the path parameter is not - NULL, it is checked whether file + NULL, 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 /proc diff --git a/man/systemctl.xml b/man/systemctl.xml index 7c9ffc81a..250866a87 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -194,8 +194,8 @@ along with systemd; If not, see . - When queuing a new job, control how to deal with already - queued jobs. Takes one of fail, + When queuing a new job, this option controls how to deal with + already queued jobs. It takes one of fail, replace, replace-irreversibly, isolate, @@ -543,7 +543,7 @@ along with systemd; If not, see . list-sockets PATTERN... - List socket units ordered by the listening address. + List socket units ordered by listening address. If one or more PATTERNs 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 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 + active, or non-zero otherwise. Unless is specified, this will also print the current unit state to STDOUT. diff --git a/man/systemd-networkd.service.xml b/man/systemd-networkd.service.xml index 6c65fbaef..908354c58 100644 --- a/man/systemd-networkd.service.xml +++ b/man/systemd-networkd.service.xml @@ -64,8 +64,8 @@ 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. @@ -80,10 +80,10 @@ identical filenames replace each other. Files in /etc have the highest priority, files in /run take precedence over files with the same - name in /lib. This can be used to override a + name in /usr/lib. This can be used to override a system-supplied configuration file with a local file if needed; a symlink in /etc with the same name as a configuration file in - /lib, pointing to /dev/null, + /usr/lib, pointing to /dev/null, disables the configuration file entirely. Virtual Network Devices diff --git a/man/systemd.device.xml b/man/systemd.device.xml index fa7074aaf..619fe1968 100644 --- a/man/systemd.device.xml +++ b/man/systemd.device.xml @@ -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 diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index 277849764..17748d406 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -847,7 +847,7 @@ processes and mounts private /tmp and /var/tmp - 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 @@ /var/tmp 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 /tmp and diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 8e6c20550..5afeffa23 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -427,7 +427,7 @@ ExecStart=/bin/sh -c 'dmesg | tac' - Only select environment variables + Only select environment variables that are set for executed commands. See systemd.exec5. diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml index 7143f9f93..bb3a6d138 100644 --- a/man/systemd.timer.xml +++ b/man/systemd.timer.xml @@ -165,8 +165,8 @@ assignments will have no effect. - Note that timers are not - necessarily expired at the precise + Note that timers do not + necessarily expire at the precise time configured with these settings, as they are subject to the AccuracySec= @@ -187,8 +187,8 @@ OnActiveSec= and related settings. - Note that timers are not - necessarily expired at the precise + Note that timers do not + necessarily expire at the precise time configured with this setting, as it is subject to the AccuracySec= @@ -201,7 +201,7 @@ 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 OnCalendar=, OnActiveSec=, diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 024457036..487827cdd 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -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. diff --git a/man/udev.xml b/man/udev.xml index bd071e177..32a520e7b 100644 --- a/man/udev.xml +++ b/man/udev.xml @@ -63,10 +63,10 @@ regardless of the directories in which they live. However, files with identical filenames replace each other. Files in /etc have the highest priority, files in /run take precedence - over files with the same name in /lib. This can be + over files with the same name in /usr/lib. This can be used to override a system-supplied rules file with a local file if needed; a symlink in /etc with the same name as a rules file in - /lib, pointing to /dev/null, + /usr/lib, pointing to /dev/null, disables the rules file entirely. Rule files must have the extension .rules; other extensions are ignored. @@ -715,10 +715,10 @@ regardless of the directories in which they live. However, files with identical filenames replace each other. Files in /etc have the highest priority, files in /run take precedence - over files with the same name in /lib. This can be + over files with the same name in /usr/lib. This can be used to override a system-supplied hwdb file with a local file if needed; a symlink in /etc with the same name as a hwdb file in - /lib, pointing to /dev/null, + /usr/lib, pointing to /dev/null, disables the hwdb file entirely. hwdb files must have the extension .hwdb; other extensions are ignored. @@ -754,10 +754,10 @@ regardless of the directories in which they live. However, files with identical filenames replace each other. Files in /etc have the highest priority, files in /run take precedence - over files with the same name in /lib. This can be + over files with the same name in /usr/lib. This can be used to override a system-supplied link file with a local file if needed; a symlink in /etc with the same name as a link file in - /lib, pointing to /dev/null, + /usr/lib, pointing to /dev/null, disables the link file entirely. The link file contains a [Match] section, which -- 2.30.2