From 6b4991cfde6c0a0b62e836ca75ae362779c474d4 Mon Sep 17 00:00:00 2001 From: Jan Engelhardt Date: Sun, 25 Aug 2013 09:01:45 +0200 Subject: [PATCH] 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) --- man/journalctl.xml | 2 +- man/sd_journal_get_cursor.xml | 2 +- man/sd_journal_get_fd.xml | 14 +++++++------- man/sd_notify.xml | 2 +- man/shutdown.xml | 4 ++-- man/systemd-backlight@.service.xml | 4 ++-- man/systemd-cgls.xml | 2 +- man/systemd-efi-boot-generator.xml | 4 ++-- man/systemd-nspawn.xml | 2 +- man/systemd.exec.xml | 9 ++++----- man/systemd.journal-fields.xml | 2 +- man/systemd.mount.xml | 2 +- man/systemd.service.xml | 4 ++-- man/systemd.special.xml | 2 +- man/systemd.time.xml | 2 +- man/systemd.xml | 2 +- man/telinit.xml | 2 +- man/timedatectl.xml | 2 +- man/tmpfiles.d.xml | 12 ++++++------ 19 files changed, 37 insertions(+), 38 deletions(-) diff --git a/man/journalctl.xml b/man/journalctl.xml index b52caa47b..a5778bf36 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -281,7 +281,7 @@ - is very similar + is very similar, but shows monotonic timestamps instead of wallclock timestamps. diff --git a/man/sd_journal_get_cursor.xml b/man/sd_journal_get_cursor.xml index 861927e2e..4cee7d5b6 100644 --- a/man/sd_journal_get_cursor.xml +++ b/man/sd_journal_get_cursor.xml @@ -120,7 +120,7 @@ returns 0 on success or a negative errno-style error code. sd_journal_test_cursor() 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. diff --git a/man/sd_journal_get_fd.xml b/man/sd_journal_get_fd.xml index 1c6f25005..c4387b085 100644 --- a/man/sd_journal_get_fd.xml +++ b/man/sd_journal_get_fd.xml @@ -232,15 +232,15 @@ else { SD_JOURNAL_APPEND or SD_JOURNAL_INVALIDATE on success or a negative errno-style error code. If - SD_JOURNAL_NOP is returned the - journal didn't change since the last invocation. If - SD_JOURNAL_APPEND is returned new + SD_JOURNAL_NOP is returned, the + journal did not change since the last invocation. If + SD_JOURNAL_APPEND is returned, new entries have been appended to the end of the - journal. If SD_JOURNAL_INVALIDATE + journal. If SD_JOURNAL_INVALIDATE, 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 SD_JOURNAL_APPEND it is + rotation). In the latter event, live-view UIs should + probably refresh their entire display, while in the + case of SD_JOURNAL_APPEND, it is sufficient to simply continue reading at the previous end of the journal. diff --git a/man/sd_notify.xml b/man/sd_notify.xml index 7d9689039..fc0f2f692 100644 --- a/man/sd_notify.xml +++ b/man/sd_notify.xml @@ -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. diff --git a/man/shutdown.xml b/man/shutdown.xml index af799c664..795fb6632 100644 --- a/man/shutdown.xml +++ b/man/shutdown.xml @@ -133,7 +133,7 @@ - Don't halt, power-off, + Do not halt, power-off, reboot, just write wall message. @@ -141,7 +141,7 @@ - Don't send wall + Do not send wall message before halt, power-off, reboot. diff --git a/man/systemd-backlight@.service.xml b/man/systemd-backlight@.service.xml index f2f54728a..2b73625e9 100644 --- a/man/systemd-backlight@.service.xml +++ b/man/systemd-backlight@.service.xml @@ -57,9 +57,9 @@ systemd-backlight@.service 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 /var/lib/backlight/. Note that by - default only firmware backlight devices are + default, only firmware backlight devices are saved/restored. diff --git a/man/systemd-cgls.xml b/man/systemd-cgls.xml index 53e7f7ddd..2877f2212 100644 --- a/man/systemd-cgls.xml +++ b/man/systemd-cgls.xml @@ -107,7 +107,7 @@ - Don't hide empty + Do not hide empty control groups in the output. diff --git a/man/systemd-efi-boot-generator.xml b/man/systemd-efi-boot-generator.xml index 03a4fdd0b..3a79dfb8d 100644 --- a/man/systemd-efi-boot-generator.xml +++ b/man/systemd-efi-boot-generator.xml @@ -56,7 +56,7 @@ systemd-efi-boot-generator 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 /boot. Note that this generator will execute no operation on non-EFI systems, on systems where the boot loader does not @@ -64,7 +64,7 @@ /boot is an explicitly configured mount (for example, listed in fstab5) or where the /boot 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. systemd-efi-boot-generator diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index e55933d06..6264e48db 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -334,7 +334,7 @@ /var/log/journal 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 guest or diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index b761832ed..2c673a2a9 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -1,4 +1,3 @@ - @@ -327,8 +326,8 @@ absolute filename or wildcard expression, optionally prefixed with -, 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 @@ InaccessibleDirectories= may be prefixed with -, in which case - they will be ignored when they don't + they will be ignored when they do not exist. @@ -972,7 +971,7 @@ sigreturn, exit_group, exit 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 diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml index 452406c67..cffcccb53 100644 --- a/man/systemd.journal-fields.xml +++ b/man/systemd.journal-fields.xml @@ -525,7 +525,7 @@ url="http://www.freedesktop.org/wiki/Software/systemd/json">Journal JSON Format, 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 diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml index 214f40c74..9aac94e1a 100644 --- a/man/systemd.mount.xml +++ b/man/systemd.mount.xml @@ -84,7 +84,7 @@ using configuration not specified in /etc/fstab; mount8 - will refuse options that aren't listed in + will refuse options that are not listed in /etc/fstab if it is not run as UID 0. diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 238a49a25..5df554ca1 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -483,7 +483,7 @@ was stopped. This includes cases where the commands configured in ExecStop= were used, - where the service doesn't have any + where the service does not have any ExecStop= defined, or where the service exited unexpectedly. This argument takes multiple command lines, @@ -823,7 +823,7 @@ in other words: the Service= setting of .socket units - doesn't have to match the inverse of + does not have to match the inverse of the Sockets= setting of the .service it diff --git a/man/systemd.special.xml b/man/systemd.special.xml index 2900808ef..4d0660714 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -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. diff --git a/man/systemd.time.xml b/man/systemd.time.xml index 4f6dd0f08..3d13b573f 100644 --- a/man/systemd.time.xml +++ b/man/systemd.time.xml @@ -127,7 +127,7 @@ but when the weekday is specified it must either be in the abbreviated (Wed) or non-abbreviated (Wednesday) 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 diff --git a/man/systemd.xml b/man/systemd.xml index 9f58bc2f8..47d643893 100644 --- a/man/systemd.xml +++ b/man/systemd.xml @@ -1022,7 +1022,7 @@ option prefixed with rd. 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. diff --git a/man/telinit.xml b/man/telinit.xml index 4c6064f54..bb8093914 100644 --- a/man/telinit.xml +++ b/man/telinit.xml @@ -80,7 +80,7 @@ - Don't send wall + Do not send wall message before reboot/halt/power-off. diff --git a/man/timedatectl.xml b/man/timedatectl.xml index 16ee3df4b..9aade29a7 100644 --- a/man/timedatectl.xml +++ b/man/timedatectl.xml @@ -92,7 +92,7 @@ - Don't query the user + Do not query the user for authentication for privileged operations. diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 6a2193d67..025c8018d 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -104,7 +104,7 @@ L /tmp/foobar - - - - /dev/null f - Create a file if it doesn't exist yet (optionally writing a short string into it, if the argument parameter is passed) + Create a file if it does not exist yet (optionally writing a short string into it, if the argument parameter is passed) @@ -122,7 +122,7 @@ L /tmp/foobar - - - - /dev/null d - Create a directory if it doesn't exist yet + Create a directory if it does not exist yet @@ -132,22 +132,22 @@ L /tmp/foobar - - - - /dev/null p - Create a named pipe (FIFO) if it doesn't exist yet + Create a named pipe (FIFO) if it does not exist yet L - Create a symlink if it doesn't exist yet + Create a symlink if it does not exist yet c - Create a character device node if it doesn't exist yet + Create a character device node if it does not exist yet b - Create a block device node if it doesn't exist yet + Create a block device node if it does not exist yet -- 2.30.2