From e9dd9f9547350c7dc0473583b5c2228dc8f0ab76 Mon Sep 17 00:00:00 2001 From: "Jason St. John" Date: Thu, 27 Jun 2013 21:51:44 +0200 Subject: [PATCH] man: improve grammar and word formatting in numerous man pages Use proper grammar, word usage, adjective hyphenation, commas, capitalization, spelling, etc. To improve readability, some run-on sentences or sentence fragments were revised. [zj: remove the space from 'file name', 'host name', and 'time zone'.] --- catalog/systemd.catalog | 2 +- man/binfmt.d.xml | 4 +- man/hostname.xml | 14 ++--- man/hostnamectl.xml | 48 ++++++++-------- man/kernel-install.xml | 2 +- man/localtime.xml | 12 ++-- man/loginctl.xml | 30 +++++----- man/logind.conf.xml | 26 ++++----- man/machine-id.xml | 20 +++---- man/machine-info.xml | 4 +- man/modules-load.d.xml | 2 +- man/nss-myhostname.xml | 14 ++--- man/os-release.xml | 4 +- man/pam_systemd.xml | 34 +++++------ man/sd-id128.xml | 28 +++++----- man/sd_id128_get_machine.xml | 10 ++-- man/sd_id128_randomize.xml | 13 ++--- man/sd_id128_to_string.xml | 20 +++---- man/sd_is_fifo.xml | 20 +++---- man/sd_journal_get_cutoff_realtime_usec.xml | 6 +- man/sd_journal_get_realtime_usec.xml | 20 +++---- man/sd_journal_print.xml | 2 +- man/sd_journal_stream_fd.xml | 2 +- man/sysctl.d.xml | 4 +- man/systemctl.xml | 4 +- man/systemd-analyze.xml | 22 ++++---- man/systemd-hostnamed.service.xml | 8 +-- man/systemd-inhibit.xml | 16 +++--- man/systemd-journald.service.xml | 16 +++--- man/systemd-modules-load.service.xml | 4 +- man/systemd-nspawn.xml | 6 +- man/systemd-readahead-replay.service.xml | 26 ++++----- man/systemd-system.conf.xml | 15 +++-- man/systemd-timedated.service.xml | 4 +- man/systemd-tmpfiles.xml | 2 +- man/systemd.automount.xml | 2 +- man/systemd.exec.xml | 31 +++++------ man/systemd.journal-fields.xml | 40 ++++++------- man/systemd.mount.xml | 10 ++-- man/systemd.preset.xml | 14 ++--- man/systemd.service.xml | 2 +- man/systemd.socket.xml | 16 +++--- man/systemd.time.xml | 62 ++++++++++----------- man/systemd.timer.xml | 2 +- man/systemd.unit.xml | 26 ++++----- man/systemd.xml | 2 +- man/timedatectl.xml | 6 +- man/tmpfiles.d.xml | 2 +- man/udev.xml | 2 +- src/core/main.c | 4 +- src/shared/hwclock.c | 2 +- src/timedate/timedatectl.c | 2 +- src/timedate/timedated.c | 4 +- 53 files changed, 345 insertions(+), 348 deletions(-) diff --git a/catalog/systemd.catalog b/catalog/systemd.catalog index dbeadb7de..892b2adf7 100644 --- a/catalog/systemd.catalog +++ b/catalog/systemd.catalog @@ -138,7 +138,7 @@ Subject: Time zone change to @TIMEZONE@ Defined-By: systemd Support: http://lists.freedesktop.org/mailman/listinfo/systemd-devel -The system time zone has been changed to @TIMEZONE@. +The system timezone has been changed to @TIMEZONE@. -- b07a249cd024414a82dd00cd181378ff Subject: System start-up is now complete diff --git a/man/binfmt.d.xml b/man/binfmt.d.xml index 762d1fc66..7f31b76de 100644 --- a/man/binfmt.d.xml +++ b/man/binfmt.d.xml @@ -94,11 +94,11 @@ with an alphabetically later name. If the administrator wants to disable a - configuration file supplied by the vendor the + configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null in /etc/binfmt.d/ bearing the - same file name. + same filename. diff --git a/man/hostname.xml b/man/hostname.xml index f89332e98..5971ad434 100644 --- a/man/hostname.xml +++ b/man/hostname.xml @@ -44,7 +44,7 @@ hostname - Local host name configuration file + Local hostname configuration file @@ -59,17 +59,17 @@ during boot, with the sethostname2 system call. It should contain a single - newline-terminated host name string. The - host name may be a free-form string up to 64 characters - in length, however it is recommended that it consists - only of 7bit ASCII lower-case characters and no spaces or dots, + newline-terminated hostname string. The + hostname may be a free-form string up to 64 characters + in length; however, it is recommended that it consists + only of 7-bit ASCII lower-case characters and no spaces or dots, and limits itself to the format allowed for DNS domain name labels, even though this is not a strict requirement. - Depending on the operating system other + Depending on the operating system, other configuration files might be checked for configuration - of the host name as well, however only as fallback. + of the hostname as well, however only as fallback. You may use hostnamectl1 diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml index 801ab3a7b..d7a9e9287 100644 --- a/man/hostnamectl.xml +++ b/man/hostnamectl.xml @@ -60,9 +60,9 @@ query and change the system hostname and related settings. - This tool distinguishes three different host - names: the high-level "pretty" hostname which might - include all kinds of special characters + This tool distinguishes three different + hostnames: the high-level "pretty" hostname which + might include all kinds of special characters (e.g. "Lennart's Laptop"), the static hostname which is used to initialize the kernel hostname at boot (e.g. "lennarts-laptop"), and the transient hostname @@ -77,10 +77,10 @@ and transient hostnames are limited to the usually accepted characters of internet domain names. - The static host name is stored in + The static hostname is stored in /etc/hostname, see hostname5 - for more information. The pretty host name, chassis + for more information. The pretty hostname, chassis type and icon name are stored in /etc/machine-info, see machine-id5. @@ -143,8 +143,8 @@ If set-hostname is invoked and one or more of these - options are passed only the selected - hostnames is + options are passed, only the selected + hostname(s) is/are updated. @@ -164,34 +164,34 @@ set-hostname [NAME] Set the system - hostname. By default this will alter + hostname. By default, this will alter the pretty, the static, and the - transient hostname alike, however if + transient hostname alike; however, if one or more of , , - are used + are used, only the selected hostnames are changed. If the pretty hostname is being set, and static or transient are - being set as well the specified host - name will be simplified in regards to - the character set used before the + being set as well, the specified + hostname will be simplified in regards + to the character set used before the latter are updated. This is done by - replacing spaces by "-" and removing + replacing spaces with "-" and removing special characters. This ensures that - the pretty and the static hostname - are always closely related while still + the pretty and the static hostname are + always closely related while still following the validity rules of the specific name. This simplification of the hostname string is not done if - only the transient and/or static host - names are set, and the pretty host - name is left untouched. Pass the empty - string "" as hostname to reset the - selected hostnames to their default - (usually - "localhost"). + only the transient and/or static + hostnames are set, and the pretty + hostname is left untouched. Pass the + empty string "" as the hostname to + reset the selected hostnames to their + default (usually "localhost"). + @@ -206,7 +206,7 @@ Naming Specification. Pass an empty string to this operation to reset the icon name to the default - value which is determined from chassis + value, which is determined from chassis type (see below) and possibly other parameters. diff --git a/man/kernel-install.xml b/man/kernel-install.xml index 8c2abc747..d21d7579b 100644 --- a/man/kernel-install.xml +++ b/man/kernel-install.xml @@ -67,7 +67,7 @@ along with systemd; If not, see . located in the directory /usr/lib/kernel/install.d/ and the local administration directory /etc/kernel/install.d/. All files are collectively sorted and executed in lexical order, regardless of the directory in - which they live. However, files with identical file names replace each other. + which they live. However, files with identical filenames replace each other. Files in /etc/kernel/install.d/ take precedence over files with the same name in /usr/lib/kernel/install.d/. This can be used to override a system-supplied executables with a local file if needed; a symbolic link in /etc/kernel/install.d/ diff --git a/man/localtime.xml b/man/localtime.xml index d3da4ed27..b95c2ee6b 100644 --- a/man/localtime.xml +++ b/man/localtime.xml @@ -51,7 +51,7 @@ localtime - Local time zone configuration file + Local timezone configuration file @@ -62,24 +62,24 @@ Description The /etc/localtime file - configures the system-wide time zone of the local + configures the system-wide timezone of the local system that is used by applications for presentation to the user. It should be an absolute or relative symbolic link pointing to /usr/share/zoneinfo/, followed by - a time zone identifier such as + a timezone identifier such as Europe/Berlin or Etc/UTC. The resulting link should lead to the corresponding binary tzfile5 - time zone data for the configured time zone. + timezone data for the configured timezone. - As the time zone identifier is extracted from + As the timezone identifier is extracted from the symlink target name of /etc/localtime this file may not be a normal file or hardlink. - The time zone may be overridden for individual + The timezone may be overridden for individual programs by using the TZ environment variable. See environ7. diff --git a/man/loginctl.xml b/man/loginctl.xml index e76ee9590..f10ca030c 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -144,7 +144,7 @@ to select whether to kill only the leader process of the session or all processes of the - session. If omitted defaults to + session. If omitted, defaults to . @@ -157,8 +157,8 @@ kill-user, choose which signal to send to selected processes. Must be one of the well - known signal specifiers such as - SIGTERM, SIGINT or SIGSTOP. If omitted + known signal specifiers, such as + SIGTERM, SIGINT or SIGSTOP. If omitted, defaults to . @@ -308,10 +308,10 @@ Show properties of one or more users or the manager - itself. If no argument is specified + itself. If no argument is specified, properties of the manager will be - shown. If a user is specified - properties of the user is shown. By + shown. If a user is specified, + properties of the user are shown. By default, empty properties are suppressed. Use to show those too. To select specific @@ -332,9 +332,9 @@ Enable/disable user lingering for one or more users. If - enabled for a specific user a user + enabled for a specific user, a user manager is spawned for him/her at - boot, and kept around after + boot and kept around after logouts. This allows users who aren't logged in to run long-running services. @@ -386,14 +386,14 @@ Show properties of one or more seats or the manager - itself. If no argument is specified + itself. If no argument is specified, properties of the manager will be - shown. If a seat is specified + shown. If a seat is specified, properties of the seat are shown. By default, empty properties are suppressed. Use to show those too. To select specific - properties to show use + properties to show, use . This command is intended to be used whenever computer-parsable output is @@ -411,13 +411,13 @@ one or more devices to a seat. The devices should be specified via device paths in the /sys - file system. To create a new seat + file system. To create a new seat, attach at least one graphics card to a previously unused seat name. Seat names may consist only of a-z, A-Z, 0-9, "-" and "_" and must be prefixed with "seat". To drop assignment of a - device to a specific seat just + device to a specific seat, just reassign it to a different seat, or use flush-devices. @@ -429,8 +429,8 @@ Removes all device assignments previously created with attach. After this - call only automatically generated - seats will remain and all seat + call, only automatically generated + seats will remain, and all seat hardware is assigned to them. diff --git a/man/logind.conf.xml b/man/logind.conf.xml index 47ee0e73f..b7109353c 100644 --- a/man/logind.conf.xml +++ b/man/logind.conf.xml @@ -184,10 +184,10 @@ KillExcludeUsers= These settings take - space separated lists of user names + space-separated lists of usernames that influence the effect of KillUserProcesses=. If - not empty only processes of users + not empty, only processes of users listed in KillOnlyUsers will be killed when they log out @@ -210,12 +210,12 @@ users logging in are added to, in addition to the name=systemd named - hierarchy. These settings take space - separated lists of controller + hierarchy. These settings take + space-separated lists of controller names. Pass the empty string to ensure that logind does not touch any hierarchies but systemd's own. When - logging in user sessions will get + logging in, user sessions will get private control groups in all hierarchies listed in Controllers= and be @@ -228,8 +228,8 @@ cpu. Note that for all controllers that are not listed in either Controllers= - nor - ResetControllers= + or + ResetControllers=, newly created sessions will be part of the control groups of the system service that created the @@ -269,11 +269,11 @@ hibernate, hybrid-sleep and lock. If - ignore logind will + ignore, logind will never handle these keys. If - lock all running - sessions will be screen - locked. Otherwise the specified action + lock, all running + sessions will be screen-locked; otherwise, + the specified action will be taken in the respective event. Only input devices with the power-switch udev @@ -301,10 +301,10 @@ sleep keys and the lid switch are subject to inhibitor locks. These settings take boolean arguments. If - off the inhibitor + off, the inhibitor locks taken by applications in order to block the requested operation are - respected, if on + respected, if on, the requested operation is executed in any case. PowerKeyIgnoreInhibited=, diff --git a/man/machine-id.xml b/man/machine-id.xml index 1e558a617..d7a56cb54 100644 --- a/man/machine-id.xml +++ b/man/machine-id.xml @@ -55,12 +55,12 @@ Description The /etc/machine-id file - contains the unique machine id of the local system + contains the unique machine ID of the local system that is set during installation. The machine ID is a - single newline-terminated, hexadecimal, lowercase 32 - character machine ID string. (When decoded from - hexadecimal this corresponds with a 16 byte/128 bit - string.) + single newline-terminated, hexadecimal, 32-character, + lowercase machine ID string. When decoded from + hexadecimal, this corresponds with a 16-byte/128-bit + string. The machine ID is usually generated from a random source during system installation and stays @@ -69,7 +69,7 @@ boot if it is found to be empty. The machine ID does not change based on user - configuration, or when hardware is replaced. + configuration or when hardware is replaced. This machine ID adheres to the same format and logic as the D-Bus machine ID. @@ -77,10 +77,10 @@ Programs may use this ID to identify the host with a globally unique ID in the network, which does not change even if the local network configuration - changes. Due to this and its greater length it is + changes. Due to this and its greater length, it is a more useful replacement for the gethostid3 - call POSIX specifies. + call that POSIX specifies. The systemd-machine-id-setup1 @@ -94,8 +94,8 @@ Note that the machine ID historically is not an OSF UUID as defined by RFC - 4122, nor a Microsoft GUID. Starting with - systemd v30 newly generated machine IDs however do + 4122, nor a Microsoft GUID; however, starting with + systemd v30, newly generated machine IDs do qualify as v4 UUIDs. In order to maintain compatibility with existing diff --git a/man/machine-info.xml b/man/machine-info.xml index 1c3a21c64..7f396aafd 100644 --- a/man/machine-info.xml +++ b/man/machine-info.xml @@ -101,12 +101,12 @@ present to the user and does not suffer by the syntax limitations of internet domain names. If possible the - internet host name as configured in + internet hostname as configured in /etc/hostname should be kept similar to this one. Example: if this value is Lennart's Computer - an Internet host name of + an Internet hostname of lennarts-computer might be a good choice. If this parameter is not set an application diff --git a/man/modules-load.d.xml b/man/modules-load.d.xml index ce94bef7a..0d104c563 100644 --- a/man/modules-load.d.xml +++ b/man/modules-load.d.xml @@ -94,7 +94,7 @@ recommended way is to place a symlink to /dev/null in /etc/modules-load.d/ bearing the - same file name. + same filename. diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml index c0e2b828b..efbadac33 100644 --- a/man/nss-myhostname.xml +++ b/man/nss-myhostname.xml @@ -45,7 +45,7 @@ nss-myhostname - Provide host name resolution for the locally + Provide hostname resolution for the locally configured system hostname. @@ -58,17 +58,17 @@ nss-myhostname is a plugin for the GNU Name Service Switch (NSS) functionality of the GNU C Library (glibc) - providing host name resolution for the locally configured system + providing hostname resolution for the locally configured system hostname as returned by gethostname2. - Various software relies on an always resolvable local host name. When - using dynamic hostnames this is usually achieved by patching + Various software relies on an always-resolvable local hostname. When + using dynamic hostnames, this is usually achieved by patching /etc/hosts at the same time as changing the host name. This however is not ideal since it requires a writable /etc file system and is fragile because the file might be edited by the administrator at the same time. nss-myhostname - simply returns all locally configure public IP addresses, or -- if none - are configured -- the IPv4 address 127.0.0.2 (which is on the local + simply returns all locally configured public IP addresses, or, if none + are configured, the IPv4 address 127.0.0.2 (which is on the local loopback) and the IPv6 address ::1 (which is the local host) for whatever system hostname is configured locally. Patching /etc/hosts is thus no longer necessary. @@ -116,7 +116,7 @@ $ getent ahosts `hostname` 127.0.0.2 RAW - In this case the local host name is omega. + In this case the local hostname is omega. diff --git a/man/os-release.xml b/man/os-release.xml index 45babd61b..d714b51fb 100644 --- a/man/os-release.xml +++ b/man/os-release.xml @@ -142,7 +142,7 @@ identifying the operating system, excluding any version information and suitable for processing by scripts or - usage in generated file names. If not + usage in generated filenames. If not set defaults to ID=linux. Example: ID=fedora or @@ -199,7 +199,7 @@ system version, excluding any OS name information or release code name, and suitable for processing by scripts or - usage in generated file names. This + usage in generated filenames. This field is optional. Example: VERSION_ID=17 or VERSION_ID=11.04. diff --git a/man/pam_systemd.xml b/man/pam_systemd.xml index 035481197..4e5cdf248 100644 --- a/man/pam_systemd.xml +++ b/man/pam_systemd.xml @@ -131,13 +131,13 @@ - Takes a comma - separated list of user names or - numeric user ids as argument. If this - option is used the effect of the + Takes a comma-separated + list of usernames or + numeric user IDs as argument. If this + option is used, the effect of the options will apply only to the listed - users. If this option is not used the + users. If this option is not used, the option applies to all local users. Note that @@ -149,13 +149,13 @@ - Takes a comma - separated list of user names or - numeric user ids as argument. Users + Takes a comma-separated + list of usernames or + numeric user IDs as argument. Users listed in this argument will not be subject to the effect of - . Note - that this option takes precedence + . + Note that this option takes precedence over , and hence whatever is listed for @@ -169,8 +169,8 @@ - Takes a comma - separated list of control group + Takes a comma-separated + list of control group controllers in which hierarchies a user/session control group will be created by default for each user @@ -183,8 +183,8 @@ - Takes a comma - separated list of control group + Takes a comma-separated + list of control group controllers in which hierarchies the logged in processes will be reset to the root control @@ -222,7 +222,7 @@ configured system-wide in logind.conf5. The former kills processes of a session as soon as it - ends, the latter kills processes as soon as the last + ends; the latter kills processes as soon as the last session of the user ends. If the options are omitted they default to @@ -250,7 +250,7 @@ $XDG_SESSION_ID A session identifier, - suitable to be used in file names. The + suitable to be used in filenames. The string itself should be considered opaque, although often it is just the audit session ID as reported by @@ -281,7 +281,7 @@ applications should not rely on this behavior and must be able to deal with stale files. To store session-private - data in this directory the user should + data in this directory, the user should include the value of $XDG_SESSION_ID in the filename. This directory shall be used for runtime file system diff --git a/man/sd-id128.xml b/man/sd-id128.xml index c194f5745..02fb76b56 100644 --- a/man/sd-id128.xml +++ b/man/sd-id128.xml @@ -50,7 +50,7 @@ SD_ID128_FORMAT_STR SD_ID128_FORMAT_VAL sd_id128_equal - APIs for processing 128 bit IDs + APIs for processing 128-bit IDs @@ -68,12 +68,12 @@ Description sd-id128.h provides APIs to - process and generate 128 bit ID values. The 128 bit ID + process and generate 128-bit ID values. The 128-bit ID values processed and generated by these APIs are a generalization of OSF UUIDs as defined by RFC - 4122, though use a simpler string - formatting. These functions impose no structure on the + 4122 but use a simpler string + format. These functions impose no structure on the used IDs, much unlike OSF UUIDs or Microsoft GUIDs, but are fully compatible with those types of IDs. @@ -85,7 +85,7 @@ for more information about the implemented functions. - A 128 bit ID is implemented as the following + A 128-bit ID is implemented as the following union type: typedef union sd_id128 { @@ -93,26 +93,26 @@ uint64_t qwords[2]; } sd_id128_t; - This union type allows accessing the 128 bit ID - as 16 separate bytes or two 64 bit words. It is generally - safer to access the ID components by their 8 bit array + This union type allows accessing the 128-bit ID + as 16 separate bytes or two 64-bit words. It is generally + safer to access the ID components by their 8-bit array to avoid endianness issues. This union is intended to be passed call-by-value (as opposed to call-by-reference) and may be directly manipulated by clients. A couple of macros are defined to denote and - decode 128 bit IDs: + decode 128-bit IDs: SD_ID128_MAKE() may be used - to denote a constant 128 bit ID in source code. A - commonly used idiom is to assign a name to a 128 bit + to denote a constant 128-bit ID in source code. A + commonly used idiom is to assign a name to a 128-bit ID using this macro: #define SD_MESSAGE_COREDUMP SD_ID128_MAKE(fc,2e,22,bc,6e,e6,47,b6,b9,07,29,ab,34,a2,50,b1) SD_ID128_CONST_STR() may be - used to convert constant 128bit IDs into constant + used to convert constant 128-bit IDs into constant strings for output. The following example code will output the string "fc2e22bc6ee647b6b90729ab34a250b1": @@ -122,7 +122,7 @@ SD_ID128_FORMAT_STR and SD_ID128_FORMAT_VAL() may be used - to format a 128 bit ID in a + to format a 128-bit ID in a printf3 format string, as shown in the following example: @@ -134,7 +134,7 @@ return 0; } - Use sd_id128_equal() to compare two 128 bit IDs: + Use sd_id128_equal() to compare two 128-bit IDs: int main(int argc, char *argv[]) { sd_id128_t a, b, c; diff --git a/man/sd_id128_get_machine.xml b/man/sd_id128_get_machine.xml index 12887a240..6bee7ad9c 100644 --- a/man/sd_id128_get_machine.xml +++ b/man/sd_id128_get_machine.xml @@ -45,7 +45,7 @@ sd_id128_get_machine sd_id128_get_boot - Retrieve 128 bit IDs + Retrieve 128-bit IDs @@ -92,10 +92,10 @@ sd_id128_get_boot() always returns a UUID v4 compatible ID. sd_id128_get_machine() will - also return a UUID v4 compatible ID on new - installations, but might not on older. It is possible - to convert the machine ID into an UUID v4 compatible - one. For more information see + also return a UUID v4-compatible ID on new + installations but might not on older. It is possible + to convert the machine ID into a UUID v4-compatible + one. For more information, see machine-id5. For more information about the diff --git a/man/sd_id128_randomize.xml b/man/sd_id128_randomize.xml index 15e17619d..0b9580308 100644 --- a/man/sd_id128_randomize.xml +++ b/man/sd_id128_randomize.xml @@ -44,7 +44,7 @@ sd_id128_randomize - Generate 128 bit IDs + Generate 128-bit IDs @@ -63,7 +63,7 @@ Description sd_id128_randomize() - generates a new randomized 128 bit ID and returns it + generates a new randomized 128-bit ID and returns it in ret. Every invocation returns a new randomly generated ID. This uses the /dev/urandom kernel random number @@ -71,16 +71,15 @@ Note that sd_id128_randomize() always returns - a UUID v4 compatible - ID. + a UUID v4-compatible ID. For more information about the - sd_id128_t type see + sd_id128_t type, see sd-id1283. journalctl1's - option may be used as - command line front-end for + option may be used as a + command-line front-end for sd_id128_randomize(). diff --git a/man/sd_id128_to_string.xml b/man/sd_id128_to_string.xml index 6d5cf45f9..3da5b70f8 100644 --- a/man/sd_id128_to_string.xml +++ b/man/sd_id128_to_string.xml @@ -45,7 +45,7 @@ sd_id128_to_string sd_id128_from_string - Format or parse 128 bit IDs as strings + Format or parse 128-bit IDs as strings @@ -69,7 +69,7 @@ Description sd_id128_to_string() - formats a 128 bit ID as character string. It expects + formats a 128-bit ID as a character string. It expects the ID and a string array capable of storing 33 characters. The ID will be formatted as 32 lowercase hexadecimal digits and be terminated by a NUL @@ -78,10 +78,10 @@ sd_id128_from_string() implements the reverse operation: it takes a 33 character string with 32 hexadecimal digits - (either lowercase or uppercase, terminated by NUL) and parses them back into an 128 - bit ID returned in + (either lowercase or uppercase, terminated by NUL) and + parses them back into a 128-bit ID returned in ret. Alternatively, this call - can also parse a 37 character string with a 128bit ID + can also parse a 37-character string with a 128-bit ID formatted as RFC UUID. For more information about the @@ -89,9 +89,9 @@ sd-id1283. Note that these calls operate the same way on all architectures, i.e. the results do not depend on - endianess. + endianness. - When formatting a 128 bit ID into a string it is + When formatting a 128-bit ID into a string, it is often easier to use a format string for printf3. This is easily done using the @@ -106,9 +106,9 @@ sd_id128_to_string() always succeeds and returns a pointer to the string array - passed in. sd_id128_from_string - returns 0 on success (in which case - ret is filled in), or a negative + passed in. sd_id128_from_string + returns 0 on success, in which case + ret is filled in, or a negative errno-style error code. diff --git a/man/sd_is_fifo.xml b/man/sd_is_fifo.xml index 44b41abf8..c136b37d8 100644 --- a/man/sd_is_fifo.xml +++ b/man/sd_is_fifo.xml @@ -109,14 +109,14 @@ called to check whether the specified file descriptor refers to a socket. If the family parameter is not - AF_UNSPEC it is checked whether + AF_UNSPEC, it is checked whether the socket is of the specified family (AF_UNIX, AF_INET, ...). If the - type parameter is not 0 it is + type parameter is not 0, it is checked whether the socket is of the specified type (SOCK_STREAM, SOCK_DGRAM, ...). If the - listening parameter is positive + listening parameter is positive, it is checked whether the socket is in accepting mode, i.e. listen() has been called for it. If listening is 0, it is @@ -135,14 +135,14 @@ AF_INET6. sd_is_socket_unix() is - similar to sd_is_socket(), but + similar to sd_is_socket() but optionally checks the AF_UNIX path the socket is bound to, unless the path parameter - is NULL. For normal file system AF_UNIX sockets set - the length parameter to 0. For - Linux abstract namespace sockets set the + is NULL. For normal file system AF_UNIX sockets, + set the length parameter to 0. For + Linux abstract namespace sockets, set the length to the size of the - address, including the initial 0 byte and set + address, including the initial 0 byte, and set the path to the initial 0 byte of the socket address. @@ -170,7 +170,7 @@ These functions are provided by the reference implementation of APIs for new-style daemons and distributed with the systemd package. The algorithms - they implement are simple, and can easily be + they implement are simple, and they can easily be reimplemented in daemons if it is important to support this interface without using the reference implementation. @@ -180,7 +180,7 @@ getsockname() to check the file descriptor type and where it is bound to. - For details about the algorithms check the + For details about the algorithms, check the liberally licensed reference implementation sources: and CLOCK_REALTIME. Either one @@ -88,8 +88,8 @@ sd_journal_get_cutoff_monotonic_usec() gets the monotonic timestamps of the first and last entries accessible in the journal. It takes three - arguments: the journal context object, a 128 Bit - identifier for the boot, and two pointers to 64 Bit + arguments: the journal context object, a 128-bit + identifier for the boot, and two pointers to 64-bit unsigned integers to store the timestamps. The timestamps are in microseconds since boot-up of the specific boot, diff --git a/man/sd_journal_get_realtime_usec.xml b/man/sd_journal_get_realtime_usec.xml index e7e4e4e4d..8870c29e3 100644 --- a/man/sd_journal_get_realtime_usec.xml +++ b/man/sd_journal_get_realtime_usec.xml @@ -73,27 +73,27 @@ sd_journal_get_realtime_usec() gets the realtime (wallclock) timestamp of the - current journal entry. It takes two arguments: the - journal context object and a pointer to a 64 Bit + current journal entry. It takes two arguments: the + journal context object and a pointer to a 64-bit unsigned integer to store the timestamp in. The timestamp is in microseconds since the epoch, i.e. CLOCK_REALTIME. sd_journal_get_monotonic_usec() gets the monotonic timestamp of the current journal - entry. It takes three arguments: the journal context - object, a pointer to a 64 Bit unsigned integer to - store the timestamp in as well as a 128 Bit ID buffer - to store the boot ID of the monotonic timestamp - in. The timestamp is in microseconds since boot-up of + entry. It takes three arguments: the journal context + object, a pointer to a 64-bit unsigned integer to + store the timestamp in, as well as a 128-bit ID buffer + to store the boot ID of the monotonic timestamp. + The timestamp is in microseconds since boot-up of the specific boot, i.e. CLOCK_MONOTONIC. Since the - monotonic clock begins new with every reboot it only + monotonic clock begins new with every reboot, it only defines a well-defined point in time when used - together with an identifier identifying the boot, see + together with an identifier identifying the boot. See sd_id128_get_boot3 for more information. If the boot ID parameter is - passed NULL the function will + passed NULL, the function will fail if the monotonic timestamp of the current entry is not of the current system boot. diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml index 81900dbdf..1437342a5 100644 --- a/man/sd_journal_print.xml +++ b/man/sd_journal_print.xml @@ -202,7 +202,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid( chronological ordering between the two streams cannot be guaranteed. Using sd_journal_print() has the - benefit of logging source code line, file names, and + benefit of logging source code line, filenames, and functions as meta data along all entries, and guaranteeing chronological ordering with structured log entries that are generated via diff --git a/man/sd_journal_stream_fd.xml b/man/sd_journal_stream_fd.xml index 3577526f2..4bd0abc3b 100644 --- a/man/sd_journal_stream_fd.xml +++ b/man/sd_journal_stream_fd.xml @@ -67,7 +67,7 @@ sd_journal_stream_fd() may be used to create a log stream file descriptor. Log messages written to this file descriptor as simple - newline separated text strings are written to the + newline-separated text strings are written to the journal. This file descriptor can be used internally by applications or be made STDOUT/STDERR of other processes executed. diff --git a/man/sysctl.d.xml b/man/sysctl.d.xml index 759b8740f..69e96ee9e 100644 --- a/man/sysctl.d.xml +++ b/man/sysctl.d.xml @@ -96,11 +96,11 @@ contain the same variable setting. If the administrator wants to disable a - configuration file supplied by the vendor the + configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null in /etc/sysctl.d/ bearing the - same file name. + same filename. diff --git a/man/systemctl.xml b/man/systemctl.xml index 9ab5c8ba5..84a149c3d 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -92,7 +92,7 @@ along with systemd; If not, see . - The argument should be a comma separated list of unit + The argument should be a comma-separated list of unit types such as and , or unit load states such as and @@ -732,7 +732,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service names such as cpu.shares. This will output the current values of the specified attributes, separated by new-lines. For attributes that take list of - items the output will be new-line separated, too. This + items the output will be new-line-separated, too. This operation will always try to retrieve the data in question from the kernel first, and if that is not available use the configured values instead. Instead of low-level control diff --git a/man/systemd-analyze.xml b/man/systemd-analyze.xml index cecf1bf4d..f5a942424 100644 --- a/man/systemd-analyze.xml +++ b/man/systemd-analyze.xml @@ -95,7 +95,7 @@ prints the time spent in the kernel before userspace has been reached, the time spent in the initial RAM disk (initrd) before normal system - userspace has been reached and the time normal system + userspace has been reached, and the time normal system userspace took to initialize. Note that these measurements simply measure the time passed up to the point where all system services have been spawned, but @@ -111,7 +111,7 @@ of another service to complete. systemd-analyze critical-chain [UNIT...] - prints a tree of the time critical chain of units + prints a tree of the time-critical chain of units (for each of the specified UNITs or for the default target otherwise). The time after the unit is active or started is printed @@ -135,7 +135,7 @@ dot | dot -Tsvg > systemd.svg to generate a graphical dependency tree. Unless or - is passed the generated graph will show both ordering + is passed, the generated graph will show both ordering and requirement dependencies. Optional pattern globbing style specifications (e.g. *.target) may be given at @@ -143,7 +143,7 @@ any of these patterns match either the origin or destination node. - If no command is passed systemd-analyze + If no command is passed, systemd-analyze time is implied. @@ -191,7 +191,7 @@ RequisiteOverridable=, Wants= and Conflicts= are - shown. If neither is passed, shows + shown. If neither is passed, this shows dependencies of all these types. @@ -203,16 +203,16 @@ When used in conjunction with the dot command (see - above), selects which relationships + above), this selects which relationships are shown in the dependency graph. They both require glob7 patterns as arguments, which are - matched against lefthand and - righthand, respectively, nodes of a + matched against left-hand and + right-hand, respectively, nodes of a relationship. Each of these can be - used more than once which means a - unit name must match one of given + used more than once, which means a + unit name must match one of the given values. @@ -226,7 +226,7 @@ latest unit in the same level. The unit of timespan is seconds unless specified with a different unit, - i.e. "50ms". + e.g. "50ms". diff --git a/man/systemd-hostnamed.service.xml b/man/systemd-hostnamed.service.xml index fe64a62fb..bdd3a51cc 100644 --- a/man/systemd-hostnamed.service.xml +++ b/man/systemd-hostnamed.service.xml @@ -45,7 +45,7 @@ systemd-hostnamed.service systemd-hostnamed - Hostname bus mechanism + Host name bus mechanism @@ -57,14 +57,14 @@ Description systemd-hostnamed is a system - service that may be used as mechanism to change the - system hostname. systemd-hostnamed is + service that may be used as a mechanism to change the + system's hostname. systemd-hostnamed is automatically activated on request and terminates itself when it is unused. The tool hostnamectl1 - is a command line client to this service. + is a command-line client to this service. See the diff --git a/man/systemd-inhibit.xml b/man/systemd-inhibit.xml index 6f63c8c73..de2f26414 100644 --- a/man/systemd-inhibit.xml +++ b/man/systemd-inhibit.xml @@ -101,8 +101,8 @@ - Takes a colon - separated list of one or more + Takes a colon-separated + list of one or more operations to inhibit: shutdown, sleep, @@ -124,9 +124,9 @@ - Takes a short human - readable descriptive string for the - program taking the lock. If not passed + Takes a short, + human-readable descriptive string for the + program taking the lock. If not passed, defaults to the command line string. @@ -134,8 +134,8 @@ - Takes a short human - readable descriptive string for the + Takes a short, + human-readable descriptive string for the reason for taking the lock. Defaults to "Unknown reason". @@ -155,7 +155,7 @@ delay is used, the lock can only delay the requested operations for a limited time. If the - time elapses the lock is ignored and + time elapses, the lock is ignored and the operation executed. The time limit may be specified in systemd-logind.conf5. Note diff --git a/man/systemd-journald.service.xml b/man/systemd-journald.service.xml index 2860ae976..d751f9b85 100644 --- a/man/systemd-journald.service.xml +++ b/man/systemd-journald.service.xml @@ -73,14 +73,14 @@ Log data collected by the journal is primarily - text based but can also include binary data where + text-based but can also include binary data where necessary. All objects stored in the journal can be up to 2^64-1 bytes in size. By default the journal stores log data in /run/log/journal/. Since - /run/ is volatile log data is - lost at reboot. To make the data persistent it + /run/ is volatile, log data is + lost at reboot. To make the data persistent, it is sufficient to create /var/log/journal/ where systemd-journald will then store @@ -89,8 +89,8 @@ systemd-journald will forward all received log messages to the AF_UNIX SOCK_DGRAM socket - /run/systemd/journal/syslog (if it exists) which - may be used by UNIX syslog daemons to process the data + /run/systemd/journal/syslog, if it exists, which + may be used by Unix syslog daemons to process the data further. See @@ -161,15 +161,15 @@ Access Control - Journal files are by default owned and readable + Journal files are, by default, owned and readable by the systemd-journal system group - (but not writable). Adding a user to this group thus + but are not writable. Adding a user to this group thus enables her/him to read the journal files. By default, each logged in user will get her/his own set of journal files in /var/log/journal/. These files - will not be owned by the user however, in order to + will not be owned by the user, however, in order to avoid that the user can write to them directly. Instead, file system ACLs are used to ensure the user gets read access only. diff --git a/man/systemd-modules-load.service.xml b/man/systemd-modules-load.service.xml index 1d33b8eec..f8dfab351 100644 --- a/man/systemd-modules-load.service.xml +++ b/man/systemd-modules-load.service.xml @@ -77,8 +77,8 @@ modules-load= rd.modules-load= - Takes a comma - separated list of kernel modules to + Takes a comma-separated + list of kernel modules to statically load during early boot. The option prefixed with rd. is read by the diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index ca21f2e6d..feafb31bc 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -242,7 +242,7 @@ - Set the specified uuid + Set the specified UUID for the container. The init system will initialize /etc/machine-id @@ -274,7 +274,7 @@ Mount the root file - system read only for the + system read-only for the container. @@ -283,7 +283,7 @@ List one or more additional capabilities to grant the - container. Takes a comma separated + container. Takes a comma-separated list of capability names, see capabilities7 for more information. Note that the diff --git a/man/systemd-readahead-replay.service.xml b/man/systemd-readahead-replay.service.xml index a00f7e589..806d46093 100644 --- a/man/systemd-readahead-replay.service.xml +++ b/man/systemd-readahead-replay.service.xml @@ -72,7 +72,7 @@ time. systemd-readahead-replay.service is a service that replays this access data collected at the subsequent boot. Since disks tend to be - magnitudes slower than RAM this is intended to improve + magnitudes slower than RAM, this is intended to improve boot speeds by pre-loading early at boot all data on disk that is known to be read for the complete boot process. @@ -80,9 +80,9 @@ systemd-readahead-done.service is executed a short while after boot completed and signals systemd-readahead-collect.service - to end data collection. On this signal this service + to end data collection. On this signal, this service will then sort the collected disk accesses and store - information about them disk in + information about them in /.readahead. Normally, both @@ -92,17 +92,17 @@ are activated at boot so that access patterns from the preceding boot are replayed and new data collected for the subsequent boot. However, on read-only media - where the collected data cannot be stored it might + where the collected data cannot be stored, it might be a good idea to disable systemd-readahead-collect.service. On rotating media, when replaying disk accesses - at early boot + at early boot, systemd-readahead-replay.service will order read requests by their location on disk. On non-rotating media, they will be ordered by their original access timestamp. If the file system supports - it + it, systemd-readahead-collect.service will also defragment and rearrange files on disk to optimize subsequent boot times. @@ -136,7 +136,7 @@ Maximum size of files - (in bytes) to read ahead. Only valid + in bytes to read ahead. Only valid for the collect and replay commands. @@ -145,8 +145,8 @@ - Maximum time (in usec) - to to spend collecting data. Only valid + Maximum time in microseconds + to spend collecting data. Only valid for the collect command. @@ -164,7 +164,7 @@ [DIRECTORY] Collect read-ahead data on - early boot. When terminating it will + early boot. When terminating, it will write out a pack file to the indicated directory containing the read-ahead data. @@ -186,9 +186,9 @@ Dumps the content of the read-ahead pack file to the - terminal. The output lists - approximately for each file - how much will be read-ahead by + terminal. For each file, the + output lists approximately how + much will be read ahead by the replay command. diff --git a/man/systemd-system.conf.xml b/man/systemd-system.conf.xml index 48d02269c..a67b15899 100644 --- a/man/systemd-system.conf.xml +++ b/man/systemd-system.conf.xml @@ -112,8 +112,8 @@ addition to the name=systemd named hierarchy. Defaults to - cpu. Takes a space - separated list of controller + cpu. Takes a + space-separated list of controller names. Pass the empty string to ensure that systemd does not touch any hierarchies but its own. @@ -138,8 +138,8 @@ enabled in the kernel in individual hierarchies, with the exception of those listed in this setting. Takes a - space separated list of comma - separated controller names, in order + space-separated list of comma-separated + controller names, in order to allow multiple joined hierarchies. Defaults to 'cpu,cpuacct'. Pass an empty string to @@ -150,7 +150,7 @@ Note that this option is only applied once, at very early boot. If you use an initial RAM disk (initrd) - that uses systemd it might hence be + that uses systemd, it might hence be necessary to rebuild the initrd if this option is changed, and make sure the new configuration file is included @@ -214,9 +214,8 @@ capability bounding set for PID 1 and its children. See capabilities7 - for details. Takes a whitespace - separated list of capability names as - read by + for details. Takes a whitespace-separated + list of capability names as read by cap_from_name3. Capabilities listed will be included in the bounding set, all others are diff --git a/man/systemd-timedated.service.xml b/man/systemd-timedated.service.xml index c82c0ff43..4f17bccc6 100644 --- a/man/systemd-timedated.service.xml +++ b/man/systemd-timedated.service.xml @@ -57,7 +57,7 @@ Description systemd-timedated is a - system service that may be used as mechanism to change + system service that may be used as a mechanism to change the system clock and timezone, as well as to enable/disable NTP time synchronization. systemd-timedated @@ -66,7 +66,7 @@ The tool timedatectl1 - is a command line client to this service. + is a command-line client to this service. See the diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml index 0d2d65d59..405a9f178 100644 --- a/man/systemd-tmpfiles.xml +++ b/man/systemd-tmpfiles.xml @@ -76,7 +76,7 @@ If invoked with no arguments, it applies all directives from all configuration files. If one or - more file names are passed on the command line, only + more filenames are passed on the command line, only the directives in these files are applied. If only the basename of a configuration file is specified, all configuration directories as specified in diff --git a/man/systemd.automount.xml b/man/systemd.automount.xml index e01cac7bc..2a310d3ec 100644 --- a/man/systemd.automount.xml +++ b/man/systemd.automount.xml @@ -133,7 +133,7 @@ existing at time that the automount point is installed it is created. This string must be reflected in the unit - file name. (See above.) This option is + filename. (See above.) This option is mandatory. diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index 2ccc470e2..d6fc324b5 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -129,7 +129,7 @@ Sets the supplementary Unix groups the processes are executed - as. This takes a space separated list + as. This takes a space-separated list of group names or IDs. This option may be specified more than once in which case all listed groups are set as @@ -312,7 +312,7 @@ Environment= but reads the environment variables from a text file. The text file should - contain new-line separated variable + contain new-line-separated variable assignments. Empty lines and lines starting with ; or # will be ignored, which may be used for commenting. A line @@ -324,7 +324,7 @@ double quotes ("). The argument passed should be an - absolute file name or wildcard + absolute filename or wildcard expression, optionally prefixed with "-", which indicates that if the file does not exist it won't be read and no @@ -717,9 +717,8 @@ capability bounding set for the executed process. See capabilities7 - for details. Takes a whitespace - separated list of capability names as - read by + for details. Takes a whitespace-separated + list of capability names as read by cap_from_name3, e.g. CAP_SYS_ADMIN, CAP_DAC_OVERRIDE, @@ -986,7 +985,7 @@ Control access to specific device nodes by the executed processes. Takes two - space separated strings: a device node + space-separated strings: a device node path (such as /dev/null) followed by a combination of r, w, m @@ -1011,7 +1010,7 @@ processes. Takes either a single weight value (between 10 and 1000) to set the default block IO weight, or a - space separated pair of a file path + space-separated pair of a file path and a weight value to specify the device specific weight value (Example: "/dev/sda 500"). The file path may be @@ -1037,8 +1036,8 @@ Set the per-device overall block IO bandwidth limit for - the executed processes. Takes a space - separated pair of a file path and a + the executed processes. Takes a + space-separated pair of a file path and a bandwidth value (in bytes per second) to specify the device specific bandwidth. The file path may be @@ -1185,9 +1184,9 @@ IgnoreSIGPIPE= Takes a boolean - argument. If true causes SIGPIPE to be + argument. If true, causes SIGPIPE to be ignored in the executed - process. Defaults to true, since + process. Defaults to true because SIGPIPE generally is useful only in shell pipelines. @@ -1196,7 +1195,7 @@ NoNewPrivileges= Takes a boolean - argument. If true ensures that the + argument. If true, ensures that the service process and all its children can never gain new privileges. This option is more powerful than the respective @@ -1211,9 +1210,9 @@ SystemCallFilter= - Takes a space - separated list of system call - names. If this setting is used all + Takes a space-separated + list of system call + names. If this setting is used, all system calls executed by the unit process except for the listed ones will result in immediate process diff --git a/man/systemd.journal-fields.xml b/man/systemd.journal-fields.xml index fe65078f7..bced51d63 100644 --- a/man/systemd.journal-fields.xml +++ b/man/systemd.journal-fields.xml @@ -72,7 +72,7 @@ MESSAGE= - The human readable + The human-readable message string for this entry. This is supposed to be the primary text shown to the @@ -87,16 +87,16 @@ MESSAGE_ID= - A 128bit message + A 128-bit message identifier ID for recognizing certain message types, if this is desirable. This should - contain a 128bit id formatted - as lower-case hexadecimal + contain a 128-bit ID formatted + as a lower-case hexadecimal string, without any separating dashes or suchlike. This is - recommended to be a UUID - compatible ID, but this is not + recommended to be a + UUID-compatible ID, but this is not enforced, and formatted differently. Developers can generate a new ID for this @@ -113,7 +113,7 @@ 0 (emerg) and 7 (debug) - formatted as decimal + formatted as a decimal string. This field is compatible with syslog's priority concept. @@ -128,7 +128,7 @@ The code location generating this message, if known. Contains the source - file name, the line number and + filename, the line number and the function name. @@ -141,7 +141,7 @@ any. Contains the numeric value of errno3 - formatted as decimal + formatted as a decimal string. @@ -179,7 +179,7 @@ The process, user and group ID of the process the journal entry originates from - formatted as decimal + formatted as a decimal string. @@ -246,8 +246,8 @@ any is known that is different from the reception time of the journal. This is the time in - usec since the epoch UTC - formatted as decimal + microseconds since the epoch UTC, + formatted as a decimal string. @@ -258,7 +258,7 @@ The kernel boot ID for the boot the message was generated in, formatted as - 128bit hexadecimal + a 128-bit hexadecimal string. @@ -457,7 +457,7 @@ JSON Format, the addresses of journal entries are serialized into fields prefixed with double underscores. Note that these aren't proper fields when - stored in the journal, but addressing meta data of + 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 sd_journal_send3. They @@ -486,11 +486,11 @@ (CLOCK_REALTIME) at the point in time the entry was received by the journal, - in usec since the epoch UTC - formatted as decimal + in microseconds since the epoch + UTC, formatted as a decimal string. This has different properties from - _SOURCE_REALTIME_TIMESTAMP= + _SOURCE_REALTIME_TIMESTAMP=, as it is usually a bit later but more likely to be monotonic. @@ -504,10 +504,10 @@ (CLOCK_MONOTONIC) at the point in time the entry was received by the journal in - usec formatted as decimal + microseconds, formatted as a decimal string. To be useful as an - address for the entry this - should be combined with with + address for the entry, this + should be combined with with the boot ID in _BOOT_ID=. diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml index 21177a262..d47fb9366 100644 --- a/man/systemd.mount.xml +++ b/man/systemd.mount.xml @@ -206,14 +206,14 @@ the mount point does not exist at the time of mounting, it is created. This string must be reflected in the unit - file name. (See above.) This option is + filename. (See above.) This option is mandatory. Type= Takes a string for the - filesystem type. See + file system type. See mount8 for details. This setting is optional. @@ -223,8 +223,8 @@ Options= Mount options to use - when mounting. This takes a comma - separated list of options. This + when mounting. This takes a + comma-separated list of options. This setting is optional. @@ -245,7 +245,7 @@ Configures the time to wait for the mount command to finish. If a command does not exit - within the configured time the mount + within the configured time, the mount will be considered failed and be shut down again. All commands still running will be terminated forcibly via diff --git a/man/systemd.preset.xml b/man/systemd.preset.xml index a69205387..1ba927239 100644 --- a/man/systemd.preset.xml +++ b/man/systemd.preset.xml @@ -109,7 +109,7 @@ by default, disable to disable units by default. - If multiple lines apply to a unit name the + If multiple lines apply to a unit name, the first matching one takes precedence over all others. @@ -131,14 +131,14 @@ precedence over another file with an alphabetically earlier name, if both files contain lines that apply to the same unit names. It is recommended to prefix - all file names with two-digit number, to simplify + all filenames with two-digit number, to simplify ordering. If the administrator wants to disable a preset - file supplied by the vendor the recommended way is to + file supplied by the vendor, the recommended way is to place a symlink to /dev/null in /etc/systemd/system-preset/ - bearing the same file name. + bearing the same filename. @@ -150,8 +150,8 @@ disable * - This disables all units. Due to the file name - prefix 99- it will be read last and + This disables all units. Due to the filename + prefix 99-, it will be read last and hence can easily be overridden by spin or administrator preset policy or suchlike. @@ -187,7 +187,7 @@ disable * This enables three specific services and disables all others. This is useful for administrators to specifically select the units to enable, and - disable all others. Due to the file name prefix + disable all others. Due to the filename prefix 00- it will be read early and hence overrides all other preset policy files. diff --git a/man/systemd.service.xml b/man/systemd.service.xml index dcf57c30b..fab0c4de2 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -375,7 +375,7 @@ argv[0] to the executed process, followed by the further arguments specified. If the - absolute file name is prefixed with + absolute filename is prefixed with - an exit code of the command normally considered a failure (i.e. non-zero exit status or diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml index 0d5652b83..0ff3ca22a 100644 --- a/man/systemd.socket.xml +++ b/man/systemd.socket.xml @@ -387,8 +387,8 @@ close2 on the received socket before exiting. However, it must not unlink - the socket from a filesystem. It - should note invoke + the socket from a file system. It + should not invoke shutdown2 on sockets it got with Accept=false, but @@ -412,7 +412,7 @@ are coming in, they will be refused until at least one existing connection is terminated. This setting has no - effect for sockets configured with + effect on sockets configured with or datagram sockets. Defaults to 64. @@ -516,7 +516,7 @@ respectively, i.e. the security label of the FIFO, or the security label for the incoming or outgoing connections - of the socket, respectively. See + of the socket, respectively. See Smack.txt for details. @@ -527,7 +527,7 @@ Takes an integer value. Controls the pipe buffer size of FIFOs configured in this socket - unit. See + unit. See fcntl2 for details. @@ -598,7 +598,7 @@ socket option, which allows AF_UNIX sockets to receive the security context of the sending process in an - ancillary message. Defaults to + ancillary message. Defaults to . @@ -622,7 +622,7 @@ before or after the listening sockets/FIFOs are created and bound, respectively. The first token of the command - line must be an absolute file name, + line must be an absolute filename, then followed by arguments for the process. Multiple command lines may be specified following the same scheme as @@ -701,7 +701,7 @@ - For more extensive descriptions see the "Systemd for Developers" series: + For more extensive descriptions see the "systemd for Developers" series: Socket Activation, Socket Activation, part II, Converting inetd Services, diff --git a/man/systemd.time.xml b/man/systemd.time.xml index a9318bb78..79ebdc5df 100644 --- a/man/systemd.time.xml +++ b/man/systemd.time.xml @@ -50,16 +50,16 @@ Description - In systemd timestamps, timespans, and calendar + In systemd, timestamps, time spans, and calendar events are displayed and may be specified in closely related syntaxes. - Displaying Timespans + Displaying Time Spans - Timespans refer to time durations. On display - systemd will present timespans as a space separated + Time spans refer to time durations. On display, + systemd will present time spans as a space-separated series of time values each suffixed by a time unit. @@ -70,10 +70,10 @@ - Parsing Timespans + Parsing Time Spans - When parsing systemd will accept the same - timespan syntax. Separating spaces may be omitted. The + When parsing, systemd will accept the same + time span syntax. Separating spaces may be omitted. The following time units are understood: @@ -92,9 +92,9 @@ are assumed, but some exceptions exist and are marked as such. In a few cases ns, nsec is accepted too, where the - granularity of the timespan allows for this. + granularity of the time span allows for this. - Examples for valid timespan specifications: + Examples for valid time span specifications: 2 h 2hours @@ -108,12 +108,12 @@ Displaying Timestamps Timestamps refer to specific, unique points in - time. On display systemd will format these in the + time. On display, systemd will format these in the local timezone as follows: Fri 2012-11-23 23:02:15 CET - The week day is printed according to the locale + The weekday is printed according to the locale choice of the user. @@ -123,10 +123,10 @@ When parsing systemd will accept a similar timestamp syntax, but excluding any timezone specification (this limitation might be removed - eventually). The week day specification is optional, - but when the week day is specified it must either be + eventually). The weekday specification is optional, + but when the weekday is specified it must either be in the abbreviated (Wed) or - non-abbreviated (Wednesday) english + non-abbreviated (Wednesday) English language form (case doesn't 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 @@ -136,11 +136,11 @@ specified in full or may be abbreviated (omitting the century). - A timestamp is considered invalid if a week day + A timestamp is considered invalid if a weekday is specified and the date does not actually match the specified day of the week. - When parsing systemd will also accept a few + When parsing, systemd will also accept a few special placeholders instead of timestamps: now may be used to refer to the current time (or of the invocation of the command @@ -150,14 +150,14 @@ current day, the day before or the next day, respectively. - When parsing systemd will also accept relative - time specifications. A timespan (see above) that is + When parsing, systemd will also accept relative + time specifications. A time span (see above) that is prefixed with + is evaluated to the current time plus the specified - timespan. Correspondingly a timespan that is prefix + time span. Correspondingly, a time span that is prefixed with - is evaluated to the current - time minus the specified timespan. Instead of - prefixing the timespan with - it + time minus the specified time span. Instead of + prefixing the time span with - it may also be suffixed with a space and the word ago. @@ -182,10 +182,10 @@ Note that timestamps printed by systemd will not be parsed correctly by systemd, as the timezone specification is not accepted, and printing timestamps - is subject to locale settings for the week day while - parsing only accepts english week day names. + is subject to locale settings for the weekday while + parsing only accepts English weekday names. - In some cases systemd will display a relative + In some cases, systemd will display a relative timestamp (relative to the current time, or the time of invocation of the command) instead or in addition to an absolute timestamp as described above. A @@ -208,17 +208,17 @@ The above refers to 11:12:13 of the first or fifth day of any month of the year 2012, given that it - is a thursday or friday. + is a Thursday or Friday. The weekday specification is optional. If - specified it should consist of one or more english - language week day names, either in the abbreviated + specified, it should consist of one or more English + language weekday names, either in the abbreviated (Wed) or non-abbreviated (Wednesday) form (case does - not matter), separated by commas. Specifying two week - days separated by "-" refers to a range of continuous - week days. "," and "-" may be combined freely. + not matter), separated by commas. Specifying two weekdays + separated by "-" refers to a range of continuous + weekdays. "," and "-" may be combined freely. - In the date and time specifications any + In the date and time specifications, any component may be specified as "*" in which case any value will match. Alternatively, each component can be specified as list of values separated by diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml index 2b9d91a60..1f0aac2ee 100644 --- a/man/systemd.timer.xml +++ b/man/systemd.timer.xml @@ -160,7 +160,7 @@ monotonic clock stops too. If the empty string is assigned - to any of these options the list of + to any of these options, the list of timers is reset, and all prior assignments will have no effect. diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 1cfdac926..552c74769 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -182,7 +182,7 @@ directive. If a line starts with - followed by a file name, the specified file will be + followed by a filename, the specified file will be parsed at this point. Make sure that the file that is included has the appropriate section headers before any directives. @@ -200,7 +200,7 @@ with the device node /dev/sda in the file system namespace. If this applies a special way to escape the path name is used, so that the - result is usable as part of a file name. Basically, + result is usable as part of a filename. Basically, given a path, "/" is replaced by "-", and all unprintable characters and the "-" are replaced by C-style "\x20" escapes. The root directory "/" is @@ -382,7 +382,7 @@ Documentation= - A space separated list + A space-separated list of URIs referencing documentation for this unit or its configuration. Accepted are only URIs @@ -393,7 +393,7 @@ info:, man:. For more information about the syntax of these - URIs see + URIs, see uri7. The URIs should be listed in order of relevance, starting with the most @@ -405,7 +405,7 @@ option may be specified more than once in which case the specified list of URIs is merged. If the empty string is - assigned to this option the list is + assigned to this option, the list is reset and all prior assignments will have no effect. @@ -669,8 +669,8 @@ RequiresMountsFor= - Takes a space - separated list of absolute paths. Automatically + Takes a space-separated + list of absolute paths. Automatically adds dependencies of type Requires= and After= for all @@ -1007,11 +1007,11 @@ ConditionHost= may be used to match against the - host name or machine ID of the - host. This either takes a host name + hostname or machine ID of the + host. This either takes a hostname string (optionally with shell style globs) which is tested against the - locally set host name as returned by + locally set hostname as returned by gethostname2, or a machine ID formatted as string (see @@ -1108,7 +1108,7 @@ time, systemctl enable will create symlinks from these names - to the unit file name. + to the unit filename. @@ -1207,7 +1207,7 @@ %f - Unescaped file name + Unescaped filename This is either the unescaped instance name (if applicable) with / prepended (if applicable), or the prefix name similarly prepended with /. @@ -1263,7 +1263,7 @@ %H Host name - The host name of the running system. + The hostname of the running system. %% diff --git a/man/systemd.xml b/man/systemd.xml index ef9564138..5f941e5f9 100644 --- a/man/systemd.xml +++ b/man/systemd.xml @@ -473,7 +473,7 @@ Systemd contains native implementations of various tasks that need to be executed as part of the - boot process. For example, it sets the host name or + boot process. For example, it sets the hostname or configures the loopback network device. It also sets up and mounts various API file systems, such as /sys or diff --git a/man/timedatectl.xml b/man/timedatectl.xml index e291f04e1..77af2ad46 100644 --- a/man/timedatectl.xml +++ b/man/timedatectl.xml @@ -158,7 +158,7 @@ Set the system time zone to the specified value. Available - time zones can be listed with + timezones can be listed with list-timezones. If the RTC is configured to be in the local time this will also update the @@ -176,7 +176,7 @@ List available time zones, one per line. Entries from the list can be set as the system - time zone with + timezone with set-timezone. @@ -190,7 +190,7 @@ 1 it will maintain the RTC in local time instead. Note that maintaining the RTC in the local - time zone is not fully supported and + timezone is not fully supported and will create various problems with time zone changes and daylight saving adjustments. If at all possible use diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 519f9bc61..6a2193d67 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -89,7 +89,7 @@ recommended way is to place a symlink to /dev/null in /etc/tmpfiles.d/ bearing the - same file name. + same filename. The configuration format is one line per path containing action, path, mode, ownership, age and argument diff --git a/man/udev.xml b/man/udev.xml index 2353b1002..553bbfd05 100644 --- a/man/udev.xml +++ b/man/udev.xml @@ -61,7 +61,7 @@ and the local administration directory /etc/udev/rules.d. All rules files are collectively sorted and processed in lexical order, regardless of the directories in which they live. However, files with - identical file names replace each other. Files in /etc + 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 system-supplied rules file with a local file if needed; diff --git a/src/core/main.c b/src/core/main.c index 2bd1efd5d..8b8e110f2 100644 --- a/src/core/main.c +++ b/src/core/main.c @@ -1345,10 +1345,10 @@ int main(int argc, char *argv[]) { */ hwclock_reset_timezone(); - /* Tell the kernel our time zone */ + /* Tell the kernel our timezone */ r = hwclock_set_timezone(NULL); if (r < 0) - log_error("Failed to set the kernel's time zone, ignoring: %s", strerror(-r)); + log_error("Failed to set the kernel's timezone, ignoring: %s", strerror(-r)); } } diff --git a/src/shared/hwclock.c b/src/shared/hwclock.c index cc11faa6c..17f12de51 100644 --- a/src/shared/hwclock.c +++ b/src/shared/hwclock.c @@ -151,7 +151,7 @@ int hwclock_reset_timezone(void) { /* * The very first time we set the kernel's timezone, it will warp * the clock. Do a dummy call here, so the time warping is sealed - * and we set only the time zone with next call. + * and we set only the timezone with next call. */ if (settimeofday(tv_null, &tz) < 0) return -errno; diff --git a/src/timedate/timedatectl.c b/src/timedate/timedatectl.c index d2b483efa..141180c39 100644 --- a/src/timedate/timedatectl.c +++ b/src/timedate/timedatectl.c @@ -198,7 +198,7 @@ static void print_status_info(StatusInfo *i) { if (i->local_rtc) fputs("\n" ANSI_HIGHLIGHT_ON - "Warning: The RTC is configured to maintain time in the local time zone. This\n" + "Warning: The RTC is configured to maintain time in the local timezone. This\n" " mode is not fully supported and will create various problems with time\n" " zone changes and daylight saving adjustments. If at all possible use\n" " RTC in UTC, by calling 'timedatectl set-local-rtc 0'" ANSI_HIGHLIGHT_OFF ".\n", stdout); diff --git a/src/timedate/timedated.c b/src/timedate/timedated.c index cdb6e5b16..525c72e49 100644 --- a/src/timedate/timedated.c +++ b/src/timedate/timedated.c @@ -662,7 +662,7 @@ static DBusHandlerResult timedate_message_handler( return bus_send_error_reply(connection, message, NULL, r); } - /* 2. Tell the kernel our time zone */ + /* 2. Tell the kernel our timezone */ hwclock_set_timezone(NULL); if (tz.local_rtc) { @@ -719,7 +719,7 @@ static DBusHandlerResult timedate_message_handler( return bus_send_error_reply(connection, message, NULL, r); } - /* 2. Tell the kernel our time zone */ + /* 2. Tell the kernel our timezone */ hwclock_set_timezone(NULL); /* 3. Synchronize clocks */ -- 2.30.2