From 63ba209d8bc64137ff1585d5878328c93cb81b61 Mon Sep 17 00:00:00 2001 From: Jan Engelhardt Date: Thu, 7 Nov 2013 01:17:48 +0100 Subject: [PATCH] man: wording and grammar updates This is a recurring submission and includes corrections to various issue spotted: comma setting, missing words/preposition choice. --- man/hostnamectl.xml | 2 +- man/localectl.xml | 2 +- man/loginctl.xml | 2 +- man/machinectl.xml | 6 +++--- man/systemctl.xml | 8 ++++---- man/systemd-analyze.xml | 4 ++-- man/systemd-halt.service.xml | 4 ++-- man/systemd-run.xml | 4 ++-- man/systemd-socket-proxyd.xml | 2 +- man/systemd-system.conf.xml | 6 +++--- man/systemd.mount.xml | 4 ++-- man/systemd.service.xml | 6 +++--- man/systemd.socket.xml | 2 +- man/systemd.swap.xml | 2 +- man/timedatectl.xml | 2 +- 15 files changed, 28 insertions(+), 28 deletions(-) diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml index b39fb5502..29914b8c8 100644 --- a/man/hostnamectl.xml +++ b/man/hostnamectl.xml @@ -133,7 +133,7 @@ remotely. Specify a hostname, or username and hostname separated by @, to connect to. This will use SSH to - talk to a remote + talk to the remote system. diff --git a/man/localectl.xml b/man/localectl.xml index ad4f3d41f..0950cce97 100644 --- a/man/localectl.xml +++ b/man/localectl.xml @@ -126,7 +126,7 @@ remotely. Specify a hostname, or username and hostname separated by @, to connect to. This will use SSH to - talk to a remote + talk to the remote system. diff --git a/man/loginctl.xml b/man/loginctl.xml index 1b54ff7dc..7d4f26a3e 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -172,7 +172,7 @@ - Execute operation + Execute the operation remotely. Specify a hostname, or username and hostname separated by @, to connect to. This will use SSH to diff --git a/man/machinectl.xml b/man/machinectl.xml index c06d0c7ab..ec2aaa56d 100644 --- a/man/machinectl.xml +++ b/man/machinectl.xml @@ -105,7 +105,7 @@ - Execute operation + Execute the operation remotely. Specify a hostname, or username and hostname separated by @, to connect to. This will use SSH to @@ -117,7 +117,7 @@ - Execute operation on a + Execute the operation on a local container. Specify a container name to connect to. @@ -270,7 +270,7 @@ Open a terminal login session to a container. This will create a TTY connection to a specific - container and asks for execution of a + container and asks for the execution of a getty on it. Note that this is only supported for containers running systemd1 diff --git a/man/systemctl.xml b/man/systemctl.xml index 605b7869b..c7313edcc 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -64,15 +64,15 @@ along with systemd; If not, see . systemd1 system and service manager. - For Unit Commands the NAME represents full name of unit. + For unit commands, the NAME represents full name of the unit. systemctl start foo.service - For Unit File Commands the NAME represents full name of the unit file, or absolute path to the unit file. + For unit file commands, the NAME represents the full name of the unit file, or the absolute path to the unit file. systemctl start /path/to/foo.service - While working with services/service files, systemctl is able to append .service suffix when it is missing. + While working with services/service files, systemctl implicitly appends the ".service" suffix when it is missing. systemctl start foo @@ -457,7 +457,7 @@ systemctl start foo - Execute operation remotely. Specify a hostname, or + Execute the operation remotely. Specify a hostname, or username and hostname separated by @, to connect to. This will use SSH to talk to the remote systemd instance. diff --git a/man/systemd-analyze.xml b/man/systemd-analyze.xml index 3141361e5..1898ca6fb 100644 --- a/man/systemd-analyze.xml +++ b/man/systemd-analyze.xml @@ -209,7 +209,7 @@ - Execute operation + Execute the operation remotely. Specify a hostname, or username and hostname separated by @, to connect @@ -222,7 +222,7 @@ - Execute operation on a + Execute the operation on a local container. Specify a container name to connect to. diff --git a/man/systemd-halt.service.xml b/man/systemd-halt.service.xml index 812281e60..2fd7b8bf8 100644 --- a/man/systemd-halt.service.xml +++ b/man/systemd-halt.service.xml @@ -74,11 +74,11 @@ kexec.target to execute the respective actions. - When these services are run they ensure that PID + When these services are run, they ensure that PID 1 is replaced by the /usr/lib/systemd/systemd-shutdown tool which is then responsible for the actual - shutdown. Before shutting down this binary will try to + shutdown. Before shutting down, this binary will try to unmount all remaining file systems, disable all remaining swap devices, detach all remaining storage devices and kill all remaining processes. diff --git a/man/systemd-run.xml b/man/systemd-run.xml index 031c207cc..daf2bdcbb 100644 --- a/man/systemd-run.xml +++ b/man/systemd-run.xml @@ -125,7 +125,7 @@ along with systemd; If not, see . - Execute operation + Execute the operation remotely. Specify a hostname, or username and hostname separated by @, to connect to. This will use SSH to @@ -137,7 +137,7 @@ along with systemd; If not, see . - Execute operation on a + Execute the operation on a local container. Specify a container name to connect to. diff --git a/man/systemd-socket-proxyd.xml b/man/systemd-socket-proxyd.xml index fcf4aafd6..698334639 100644 --- a/man/systemd-socket-proxyd.xml +++ b/man/systemd-socket-proxyd.xml @@ -64,7 +64,7 @@ local or remote destination socket. One use of this tool is to provide - socket-activation support for services that do not + socket activation support for services that do not natively support socket activation. On behalf of the service to activate, the proxy inherits the socket from systemd, accepts each client connection, opens a diff --git a/man/systemd-system.conf.xml b/man/systemd-system.conf.xml index c1f26484e..2a0a10c05 100644 --- a/man/systemd-system.conf.xml +++ b/man/systemd-system.conf.xml @@ -101,15 +101,15 @@ Configures the default time-outs for starting and stopping of units, as well as the default time to - sleep between automatic restarts of a + sleep between automatic restarts of units, as configured per-unit in TimeoutStartSec=, TimeoutStopSec= and RestartSec= (for - service units see + service units, see systemd.service5 for details on the per-unit - settings). For non-service units + settings). For non-service units, DefaultTimeoutStartSec= sets the default TimeoutSec= value. diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml index daf118918..bd50f352e 100644 --- a/man/systemd.mount.xml +++ b/man/systemd.mount.xml @@ -260,8 +260,8 @@ Takes a unit-less value in seconds, or a time span value such as "5min 20s". Pass 0 to disable the timeout - logic. Default value is setted up in manager configuration - file via DefaultTimeoutStart=. + logic. The default value is set from the manager configuration + file's DefaultTimeoutStart= variable. diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 0cb3d9e35..d1f4a2d7d 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -524,10 +524,10 @@ Takes a unit-less value in seconds, or a time span value such as "5min 20s". Pass 0 to disable the timeout - logic. Defaults to TimeoutStartSec= in + logic. Defaults to TimeoutStartSec= from the manager configuration file, except when Type=oneshot is - used in which case the timeout + used, in which case the timeout is disabled by default. @@ -546,7 +546,7 @@ Takes a unit-less value in seconds, or a time span value such as "5min 20s". Pass 0 to disable the timeout - logic. Defaults to TimeoutStartSec= in + logic. Defaults to TimeoutStartSec= from the manager configuration file. diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml index 1c78562e8..7c10c5858 100644 --- a/man/systemd.socket.xml +++ b/man/systemd.socket.xml @@ -679,7 +679,7 @@ Takes a unit-less value in seconds, or a time span value such as "5min 20s". Pass 0 to disable the timeout - logic. Defaults to TimeoutStartSec= in + logic. Defaults to TimeoutStartSec= from the manager configuration file. diff --git a/man/systemd.swap.xml b/man/systemd.swap.xml index 13f6c8441..041123285 100644 --- a/man/systemd.swap.xml +++ b/man/systemd.swap.xml @@ -186,7 +186,7 @@ Takes a unit-less value in seconds, or a time span value such as "5min 20s". Pass 0 to disable the timeout - logic. Defaults to TimeoutStartSec= in + logic. Defaults to TimeoutStartSec= from the manager configuration file. diff --git a/man/timedatectl.xml b/man/timedatectl.xml index 2dd6beb96..afcb716e4 100644 --- a/man/timedatectl.xml +++ b/man/timedatectl.xml @@ -101,7 +101,7 @@ - Execute operation + Execute the operation remotely. Specify a hostname, or username and hostname separated by @, to connect to. This will use SSH to -- 2.30.2