From: Jan Engelhardt Date: Wed, 7 May 2014 23:28:45 +0000 (+0200) Subject: doc: comma placement corrections and word order X-Git-Tag: v213~224 X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=b8bde11658366290521e3d03316378b482600323 doc: comma placement corrections and word order Set commas where there should be some. Some improvements to word order. --- diff --git a/NEWS b/NEWS index 1b548f503..f90d7f840 100644 --- a/NEWS +++ b/NEWS @@ -60,9 +60,9 @@ CHANGES WITH 212: users who are logged out cannot continue to consume IPC resources. This covers SysV memory, semaphores and message queues as well as POSIX shared memory and message - queues. Traditionally SysV and POSIX IPC had no life-cycle - limits, with this functionality this is corrected. This may - be turned off using the RemoveIPC= switch of logind.conf. + queues. Traditionally, SysV and POSIX IPC had no life-cycle + limits. With this functionality, that is corrected. This may + be turned off by using the RemoveIPC= switch of logind.conf. * The systemd-machine-id-setup and tmpfiles tools gained a --root= switch to operate on a specific root directory, @@ -95,7 +95,7 @@ CHANGES WITH 212: this is appropriate. * systemd-udevd will now run in a disassociated mount - namespace. To mount directories from udev rules make sure to + namespace. To mount directories from udev rules, make sure to pull in mount units via SYSTEMD_WANTS properties. * The kdbus support gained support for uploading policy into @@ -118,12 +118,12 @@ CHANGES WITH 212: DefaultTimerAccuracySec= has been added that controls the default AccuracySec= setting of .timer units. - * Timer units gained a new WakeSystem= switch. If enabled + * Timer units gained a new WakeSystem= switch. If enabled, timers configured this way will cause the system to resume from system suspend (if the system supports that, which most do these days). - * Timer units gained a new Persistent= switch. If enabled + * Timer units gained a new Persistent= switch. If enabled, timers configured this way will save to disk when they have been last triggered. This information is then used on next reboot to possible execute overdue timer events, that @@ -181,12 +181,12 @@ CHANGES WITH 211: * systemd-gpt-auto-generator is now able to discover /srv and root partitions in addition to /home and swap partitions. It also supports LUKS-encrypted partitions now. With this in - place automatic discovery of partitions to mount following + place, automatic discovery of partitions to mount following the Discoverable Partitions Specification (http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec) is now a lot more complete. This allows booting without /etc/fstab and without root= on the kernel command line on - appropriately prepared systems. + systems prepared appropriately. * systemd-nspawn gained a new --image= switch which allows booting up disk images and Linux installations on any block @@ -291,11 +291,11 @@ CHANGES WITH 210: * logind is now a lot more aggressive when suspending the machine due to a closed laptop lid. Instead of acting only - on the lid close action it will continuously watch the lid + on the lid close action, it will continuously watch the lid status and act on it. This is useful for laptops where the power button is on the outside of the chassis so that it can be reached without opening the lid (such as the Lenovo - Yoga). On those machines logind will now immediately + Yoga). On those machines, logind will now immediately re-suspend the machine if the power button has been accidentally pressed while the laptop was suspended and in a backpack or similar. @@ -332,7 +332,7 @@ CHANGES WITH 210: * The DeviceAllow= setting in unit files now supports a syntax to whitelist an entire group of devices node majors at once, based on the /proc/devices listing. For example, with the - string "char-pts" it is now possible to whitelist all + string "char-pts", it is now possible to whitelist all current and future pseudo-TTYs at once. * sd-event learned a new "post" event source. Event sources of @@ -346,20 +346,20 @@ CHANGES WITH 210: enabled/disabled using systemctl. It still is enabled by default however. - * When creating a veth interface pair with systemd-nspawn the + * When creating a veth interface pair with systemd-nspawn, the host side will now be prefixed with "vb-" if --network-bridge= is used, and with "ve-" if --network-veth - is used. This way it is easy to distinguish these cases on + is used. This way, it is easy to distinguish these cases on the host, for example to apply different configuration to them with systemd-networkd. * The compatibility libraries for libsystemd-journal.so, libsystem-id128.so, libsystemd-login.so and libsystemd-daemon.so do not make use of IFUNC - anymore. Instead we now build libsystemd.so multiple times + anymore. Instead, we now build libsystemd.so multiple times under these alternative names. This means that the footprint is drastically increased, but given that these are - transitional compatibility libraries this should not matter + transitional compatibility libraries, this should not matter much. This change has been made necessary to support the ARM platform for these compatibility libraries, as the ARM toolchain is not really at the same level as the toolchain @@ -770,8 +770,8 @@ CHANGES WITH 209: * systemd-nspawn gained a new --personality= switch for setting the kernel personality for the container. This is useful when running a 32-bit container on a 64-bit host. A - similar option Personality= is now also available in service - units. + similar option Personality= is now also available for service + units to use. * logind will now also track a "Desktop" identifier for each session which encodes the desktop environment of it. This is @@ -795,8 +795,8 @@ CHANGES WITH 209: * For usage together with SystemCallFilter=, a new SystemCallErrorNumber= setting has been introduced that - allows configuration of a system error number to return on - filtered system calls, instead of immediately killing the + allows configuration of a system error number to be returned + on filtered system calls, instead of immediately killing the process. Also, SystemCallArchitectures= has been added to limit access to system calls of a particular architecture (in order to turn off support for unused secondary diff --git a/README b/README index ef8c6201f..4358cd7d7 100644 --- a/README +++ b/README @@ -200,7 +200,7 @@ WARNINGS: supported anymore by the basic set of Linux OS components. systemd requires that the /run mount point exists. systemd also - requires that /var/run is a a symlink → /run. + requires that /var/run is a a symlink to /run. For more information on this issue consult http://freedesktop.org/wiki/Software/systemd/separate-usr-is-broken diff --git a/man/logind.conf.xml b/man/logind.conf.xml index 99140917a..1293e71aa 100644 --- a/man/logind.conf.xml +++ b/man/logind.conf.xml @@ -312,7 +312,7 @@ physical RAM. Defaults to 10%. Note that this size is a safety limit only. As each runtime directory is a - tmpfs file system it will only consume + tmpfs file system, it will only consume as much memory as it is filled up to. @@ -324,7 +324,7 @@ System V and POSIX IPC objects belonging to the user shall be removed when she or he fully logs out. Takes a - boolean argument. If enabled the user + boolean argument. If enabled, the user may not consume IPC resources after the last of his sessions terminated. This covers System V diff --git a/man/sd_bus_error.xml b/man/sd_bus_error.xml index 68f1d7b47..9be474764 100644 --- a/man/sd_bus_error.xml +++ b/man/sd_bus_error.xml @@ -232,8 +232,8 @@ along with systemd; If not, see . Description The sd_bus_error structure carries - information for a sd-bus error. - Functions described below can be used to set and query fields in + information for a sd-bus error. The + functions described below can be used to set and query fields in this structure. The name field contains a short identifier of an error. It should follow the rules for error names described in the D-Bus specification, subsection . Description - Function sd_bus_message_append appends + The sd_bus_message_append function appends a sequence of items to message m. The format string types describes the types of arguments that follow. diff --git a/man/sd_bus_message_append_array.xml b/man/sd_bus_message_append_array.xml index fe84671f3..455e1bb3a 100644 --- a/man/sd_bus_message_append_array.xml +++ b/man/sd_bus_message_append_array.xml @@ -91,7 +91,7 @@ along with systemd; If not, see . Description - Function sd_bus_message_append_array + The sd_bus_message_append_array functionc appends items to message m as the single array. A container will be opened, items appended, and the container closed. Parameter type determines @@ -116,19 +116,19 @@ along with systemd; If not, see . into the memory area containing the message and may be changed after this call. - Function - sd_bus_message_append_array_memfd appends + The + sd_bus_message_append_array_memfd function appends items to message m, similarly to sd_bus_message_append_array. Contents of the memory file descriptor memfd are used as the contents of the array. Their size must be a multiple of the size of the type type. - Descriptor memfd will be sealed - and cannot be modified after this call. + The descriptor specified with memfd + will be sealed and cannot be modified after this call. - Function - sd_bus_message_append_array_iovec appends + The + sd_bus_message_append_array_iovec function appends items to message m, similarly to sd_bus_message_append_array. Contents of the iovec iov are used as the contents of the @@ -136,7 +136,7 @@ along with systemd; If not, see . sum of iov_len fields) must be a multiple of the size of the type type. - Pointer iov must point to + The iov argument must point to n struct iovec structures. Each structure may have the iov_base field set, in which case the @@ -146,8 +146,8 @@ along with systemd; If not, see . memory pointed at by iov may be changed after this call. - Function - sd_bus_message_append_array_space appends + The + sd_bus_message_append_array_space function appends space for an array of items to message m. It behaves the same as sd_bus_message_append_array, but instead @@ -159,7 +159,7 @@ along with systemd; If not, see . Return Value - On success, those calls return 0 or a positive integer. On + On success, these calls return 0 or a positive integer. On failure, they returns a negative errno-style error code. diff --git a/man/sd_bus_message_append_basic.xml b/man/sd_bus_message_append_basic.xml index a8e91f9e9..68e119160 100644 --- a/man/sd_bus_message_append_basic.xml +++ b/man/sd_bus_message_append_basic.xml @@ -198,7 +198,7 @@ along with systemd; If not, see . character sequence. As a special case, a NULL pointer is interpreted as an empty string. The string should be valid Unicode string encoded as UTF-8. In case of the two latter - types, additionally the requirements for a D-Bus object path or + types, the additional requirements for a D-Bus object path or type signature should be satisfied. Those requirements should be verified by the recepient of the message. @@ -257,7 +257,7 @@ along with systemd; If not, see . Notes - sd_bus_append_basic() function + The sd_bus_append_basic() function described here is available as a shared library, which can be compiled and linked to with the libsystemd pkg-config1 diff --git a/man/sd_bus_message_append_string_memfd.xml b/man/sd_bus_message_append_string_memfd.xml index bf185ef6d..b44c482f2 100644 --- a/man/sd_bus_message_append_string_memfd.xml +++ b/man/sd_bus_message_append_string_memfd.xml @@ -80,27 +80,27 @@ along with systemd; If not, see . Description - Functions + The functions sd_bus_message_append_string_memfd and sd_bus_message_append_string_iovec can be used to append a single string (item of type s) to message m. In case of - sd_bus_message_append_string_memfd the + sd_bus_message_append_string_memfd, the contents of memfd are the string. They must satisfy the same constraints as described for the s type in sd_bus_message_append_basic3. In case of - sd_bus_message_append_string_iovec the + sd_bus_message_append_string_iovec, the payload of iov is the string. It must satisfy the same constraints as described for the s type in sd_bus_message_append_basic3. - Pointer iov must point to + The iov argument must point to n struct iovec structures. Each structure may have the iov_base field set, in which case the @@ -110,10 +110,10 @@ along with systemd; If not, see . memory pointed at by iov may be changed after this call. - Function - sd_bus_message_append_string_space appends - space for a string to message m. If behaves - similarly to sd_bus_message_append_basic with + The + sd_bus_message_append_string_space function appends + space for a string to message m. It behaves + similar to sd_bus_message_append_basic with type s, but instead of copying a string into the message, it returns a pointer to the destination area to the caller in pointer p. Space for the string @@ -133,7 +133,7 @@ along with systemd; If not, see . Notes - Functions described here are available as a shared library, + The functions described here are available as a shared library, which can be compiled and linked to with the libsystemd pkg-config1 file. diff --git a/man/sd_bus_message_append_strv.xml b/man/sd_bus_message_append_strv.xml index 4fb1390df..a4e8350f3 100644 --- a/man/sd_bus_message_append_strv.xml +++ b/man/sd_bus_message_append_strv.xml @@ -64,10 +64,10 @@ along with systemd; If not, see . Description - Function sd_bus_message_append can be + The sd_bus_message_append function can be used to append an array of strings to message - m. Parameter l - points to a NULL-terminated array of pointers + m. The parameter l + shall point to a NULL-terminated array of pointers to NUL-terminated strings. Each string must satisfy the same constraints as described for the s type in @@ -94,7 +94,7 @@ along with systemd; If not, see . Notes - sd_bus_append_append_strv() function + The sd_bus_append_append_strv() function described here is available as a shared library, which can be compiled and linked to with the libsystemd pkg-config1 diff --git a/man/sd_bus_negotiate_fds.xml b/man/sd_bus_negotiate_fds.xml index c2061941a..09563f8f7 100644 --- a/man/sd_bus_negotiate_fds.xml +++ b/man/sd_bus_negotiate_fds.xml @@ -79,35 +79,35 @@ along with systemd; If not, see . sd_bus_negotiate_fds() controls whether file descriptor passing shall be negotiated for the specified bus - connection. Takes a bus object and a boolean, which when true - enables file descriptor passing, and when false disables it. Note + connection. It takes a bus object and a boolean, which, when true, + enables file descriptor passing, and, when false, disables it. Note that not all transports and servers support file descriptor passing. To find out whether file descriptor passing is available - after negotiation use + after negotiation, use sd_bus_can_send3 and pass SD_BUS_TYPE_UNIX_FD. Note that file descriptor passing is always enabled for both sending and receiving or for neither, but never only in one direction. By - default file descriptor passing is negotiated for all + default, file descriptor passing is negotiated for all connections. - Note that when bus activation is used it is highly + Note that when bus activation is used, it is highly recommended to set the setting in the .busname unit file to the same setting as negotiated by the program ultimately activated. By - default file descriptor passing is enabled for both. + default, file descriptor passing is enabled for both. sd_bus_negotiate_timestamps() controls whether implicit sender timestamps shall be attached automatically - to all incoming messages. Takes a bus object and a boolean, which - when true enables timestamping, and when false disables it. If + to all incoming messages. Takes a bus object and a boolean, which, + when true, enables timestamping, and, when false, disables it. If this is disabled, sd_bus_message_get_monotonic_usec3, sd_bus_message_get_realtime_usec3, sd_bus_message_get_seqno3 fail with -ENODATA on incoming messages. Note that not all transports support timestamping of messages. On local - transports the timestamping is applied by the kernel and cannot be + transports, the timestamping is applied by the kernel and cannot be manipulated by userspace. sd_bus_negotiate_creds() controls @@ -119,9 +119,9 @@ along with systemd; If not, see . fails with -ENODATA on incoming messages. Note that not all transports support attaching sender credentials to messages, or do not support all types of sender - credential parameters. On local transports the sender credentials + credential parameters. On local transports, the sender credentials are attached by the kernel and cannot be manipulated by - userspace. By default no sender credentials are attached. + userspace. By default, no sender credentials are attached. These functions may be called only before the connection has been started with diff --git a/man/sd_bus_path_encode.xml b/man/sd_bus_path_encode.xml index 7e1190687..5849127be 100644 --- a/man/sd_bus_path_encode.xml +++ b/man/sd_bus_path_encode.xml @@ -82,16 +82,16 @@ along with systemd; If not, see . prefix and an external identifier string as arguments, plus a place to store the returned bus path string. The bus path prefix must be a valid bus path, starting with a slash - /, but not ending in one. The external - identifier string may be in any format, may be the empty string - and no restrictions on the charset are made - however it must + /, and not ending in one. The external + identifier string may be in any format, may be the empty string, + and has no restrictions on the charset — however, it must always be NUL-terminated. The returned string will be the concatenation of the bus path prefix plus an escaped version of the external identifier string. This operation may be reversed with sd_bus_decode(). It is - recommended to only use external identifiers here that generally + recommended to only use external identifiers that generally require little escaping to be turned into valid bus path - identifiers (for example by sticking to a 7-bit ASCII character + identifiers (for example, by sticking to a 7-bit ASCII character set), in order to ensure the resulting bus path is still short and easily processed. @@ -101,12 +101,12 @@ along with systemd; If not, see . takes a bus path and a prefix string, plus a place to store the returned external identifier string. If the bus path does not start with the specified prefix, 0 is returned and the returned - string is set to NULL. Otherwise the + string is set to NULL. Otherwise, the string following the prefix is unescaped and returned in the external identifier string. The escaping used will replace all characters which are - invalid in a bus object path by _ followed by a + invalid in a bus object path by _, followed by a hexadecimal value. As a special case, the empty string will be replaced by a lone _. @@ -118,8 +118,8 @@ along with systemd; If not, see . returns positive or 0, and a valid bus path in the return argument. On success, sd_bus_path_decode() returns a positive value if the prefixed matched, or 0 if it - did not. If the prefix matched the external identifier is returned - in the return parameter. If it did not match NULL is returned in + did not. If the prefix matched, the external identifier is returned + in the return parameter. If it did not match, NULL is returned in the return parameter. On failure, a negative errno-style error number is returned by either function. The returned strings must be diff --git a/man/sd_event_add_time.xml b/man/sd_event_add_time.xml index 9af8bb9c4..983e48656 100644 --- a/man/sd_event_add_time.xml +++ b/man/sd_event_add_time.xml @@ -121,7 +121,7 @@ along with systemd; If not, see . accuracy value in microseconds specifying a time the timer event may be delayed. Specify 0 for selecting the default accuracy (250ms). Specify 1 for most accurate timers. Consider specifying - 60000000 or larger (1h) for long running events that may be + 60000000 or larger (1h) for long-running events that may be delayed substantially. Picking higher accuracy values allows the system to coalesce timer events more aggressively, thus improving power efficiency. The handler shall @@ -132,10 +132,10 @@ along with systemd; If not, see . actually have been called at a slightly later time, subject to the specified accuracy value, the kernel timer slack (see prctl2) - and additional scheduling latencies. By default the timer will + and additional scheduling latencies. By default, the timer will elapse once (SD_EVENT_ONESHOT), but this may be changed with sd_event_source_set_enabled3. If - the handler function returns a negative error code it will be + the handler function returns a negative error code, it will be disabled after the invocation, even if SD_EVENT_ON mode is set. diff --git a/man/sd_event_new.xml b/man/sd_event_new.xml index f25631f9c..35e58ea75 100644 --- a/man/sd_event_new.xml +++ b/man/sd_event_new.xml @@ -83,24 +83,24 @@ along with systemd; If not, see . sd_event_new() allocates a new event loop object. The event loop object is returned in the - event parameter. After use drop + event parameter. After use, drop the returned reference with sd_event_unref(). When the last reference is - dropped the event loop is freed. + dropped, the event loop is freed. sd_event_default() acquires a reference to the default event loop object of the calling thread, possibly allocating a new object if no default event loop object has been - allocated yet for the thread. After use drop the returned + allocated yet for the thread. After use, drop the returned reference with sd_event_unref(). When the - last reference is dropped the event loop is freed. If this + last reference is dropped, the event loop is freed. If this function is called while the object returned from a previous call from the same thread is still referenced, the same object is returned again, but the reference is increased by one. It is recommended to use this call instead of sd_event_new() in order to share event loop objects between various components that are dispatched in the same - thread. All threads either have no or one default event loops + thread. All threads either have exactly zero or one default event loop associated, but never more. sd_event_ref() increases the reference @@ -108,13 +108,13 @@ along with systemd; If not, see . sd_event_unref() decreases the reference counter of the specified event loop object by one. If - the counter hits zero the event loop object is freed. Note that it + the counter hits zero, the event loop object is freed. Note that it is freed regardless of whether it is the default event loop object for a thread or not. This means that allocating an event loop with - sd_event_default(), then releasing it and + sd_event_default(), then releasing it, and then acquiring a new one with sd_event_default() will result in two - distinct objects. Note that in order to free an event loop object + distinct objects. Note that, in order to free an event loop object, all remaining event sources of the event loop also need to be freed as they each keep a reference to it. diff --git a/man/systemctl.xml b/man/systemctl.xml index 28a7cca0e..181de4fcd 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -385,17 +385,17 @@ along with systemd; If not, see . control processes. Note that there is only one control process per unit at a time, as only one state change is executed at a time. For services of type - Type=forking the initial process started + Type=forking, the initial process started by the manager for ExecStart= is a control process, while the process ultimately forked off by that one is then considered the main process of the unit (if it can be determined). This is different for service units of other types, where the process forked off by the manager for ExecStart= is always the main process - itself. A service unit consists of no or one main process, - no or one control process plus any number of additional + itself. A service unit consists of zero or one main process, + zero or one control process plus any number of additional processes. Not all unit types manage processes of these - types however. For example for mount units control processes + types however. For example, for mount units, control processes are defined (which are the invocations of /usr/bin/mount and /usr/bin/umount), but no main process @@ -724,7 +724,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service Show terse runtime status information about one or more units, followed by most recent log data from the journal. If no units are specified, show system status. If - combined with also show the status of + combined with , also show the status of all units (subject to limitations specified with ). If a PID is passed, show information about the unit the process belongs to. diff --git a/man/systemd-gpt-auto-generator.xml b/man/systemd-gpt-auto-generator.xml index 41b83dd38..68fe2705f 100644 --- a/man/systemd-gpt-auto-generator.xml +++ b/man/systemd-gpt-auto-generator.xml @@ -106,22 +106,22 @@ 44479540-f297-41b2-9af7-d131d5f0458a Root Partition (x86) - On 32-bit x86 systems the first x86 root partition on the disk the EFI ESP is located on is mounted to the root directory /. + On 32-bit x86 systems, the first x86 root partition on the disk the EFI ESP is located on is mounted to the root directory /. 4f68bce3-e8cd-4db1-96e7-fbcaf984b709 Root Partition (x86-64) - On 64-bit x86 systems the first x86-64 root partition on the disk the EFI ESP is located on is mounted to the root directory /. + On 64-bit x86 systems, the first x86-64 root partition on the disk the EFI ESP is located on is mounted to the root directory /. 69dad710-2ce4-4e3c-b16c-21a1d49abed3 Root Partition (32-bit ARM) - On 32-bit ARM systems the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory /. + On 32-bit ARM systems, the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory /. b921b045-1df0-41c3-af44-4c6f280d3fae Root Partition (64-bit ARM) - On 64-bit ARM systems the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory /. + On 64-bit ARM systems, the first ARM root partition on the disk the EFI ESP is located on is mounted to the root directory /. 933ac7e1-2eb4-4f13-b844-0e14e2aef915 @@ -158,7 +158,7 @@ /boot if not otherwise mounted. When using this generator in conjunction with - btrfs file systems make sure to set the correct + btrfs file systems, make sure to set the correct default subvolumes on them, using btrfs subvolume set-default. diff --git a/man/systemd-journal-remote.xml b/man/systemd-journal-remote.xml index 1f0d93e2f..972c3227e 100644 --- a/man/systemd-journal-remote.xml +++ b/man/systemd-journal-remote.xml @@ -86,7 +86,7 @@ along with systemd; If not, see . systemd-journal-remote can read more than one event stream at a time. They will be interleaved in the output file. In case of "active" connections, each "source" is one - stream, and in case of "passive" connections each connection can + stream, and in case of "passive" connections, each connection can result in a separate stream. Sockets can be configured in "accept" mode (i.e. only one connection), or "listen" mode (i.e. multiple connections, each resulting in a stream). @@ -153,7 +153,7 @@ along with systemd; If not, see . $LISTEN_FDS/$LISTEN_PID. In the second case, an HTTP or HTTPS server will be spawned on this port, respectively for and - . Currenntly Only POST requests + . Currenntly, only POST requests to /upload with Content-Type: application/vnd.fdo.journal are supported. @@ -171,7 +171,7 @@ along with systemd; If not, see . or - above. In this later case, an HTTP or HTTPS server will be + above. In the latter case, an HTTP or HTTPS server will be spawned using this descriptor and connections must be made over the HTTP protocol. @@ -193,8 +193,8 @@ along with systemd; If not, see . Will write to this journal. The filename must end with .journal. The file will be - created if it does not exist. When necessary (journal file - full, or corrupted) the file will be renamed following normal + created if it does not exist. If necessary (journal file + full, or corrupted), the file will be renamed following normal journald rules and a new journal file will be created in its stead. @@ -203,15 +203,15 @@ along with systemd; If not, see . Will create journal files underneath directory - DIR. The directory must exist. When - necessary (journal files over size, or corrupted) journal + DIR. The directory must exist. If + necessary (journal files over size, or corrupted), journal files will be rotated following normal journald rules. Names of files underneath DIR will be generated using the rules described below. - If is not used, output directory + If is not used, the output directory /var/log/journal/machine-id/ will be used, where machine-id is the identifier of the current system (see @@ -223,7 +223,7 @@ along with systemd; If not, see . based on what passive and active sources are specified. It is recommended to give a full output filename. - In case of "active" sources, if the hostname is known it + In case of "active" sources, if the hostname is known, it will be used in the variable part. Otherwise, local address and port number will be used, or stdin for events passed over standard @@ -272,7 +272,7 @@ along with systemd; If not, see . - Program to invoke to retrieve data. Journal + Program to invoke to retrieve data. The journal event stream must be generated on standard output. Examples: diff --git a/man/systemd-networkd-wait-online.service.xml b/man/systemd-networkd-wait-online.service.xml index 1d368a23f..3083588a3 100644 --- a/man/systemd-networkd-wait-online.service.xml +++ b/man/systemd-networkd-wait-online.service.xml @@ -58,8 +58,8 @@ systemd-networkd-wait-online is a one-shot system service that waits for the network to be configured. - By default it will wait for all links it is aware of that are managed by - systemd-networkd.service8, + By default, it will wait for all links it is aware of and which are managed by + systemd-networkd.service8 to be fully configured or failed, and for at least one link to gain a carrier. diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index 1ad8e6ec0..ccd3436d4 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -358,7 +358,7 @@ implies . If - this option is used the host side of + this option is used, the host side of the Ethernet link will use the vb- prefix instead of ve-. @@ -601,7 +601,7 @@ x86-64 are supported. This is useful when running a 32-bit container on a 64-bit - host. If this setting is not used + host. If this setting is not used, the personality reported in the container is the same as the one reported on the diff --git a/man/systemd-run.xml b/man/systemd-run.xml index 9ca17df55..e3c006a2e 100644 --- a/man/systemd-run.xml +++ b/man/systemd-run.xml @@ -123,7 +123,7 @@ along with systemd; If not, see . Provide a description for the service or scope unit. If not specified, the command itself will be used as a - description. See Description= in + description. See Description= in systemd.unit5. @@ -244,7 +244,7 @@ Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3.11.0-0.rc5.git6.2.fc20. The following command invokes the updatedb8 - tool but lowers the block IO weight for it to 10. See + tool, but lowers the block IO weight for it to 10. See systemd.resource-control5 for more information on the BlockIOWeight= property. diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index f79489494..22f076870 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -845,7 +845,7 @@ processes via /tmp or /var/tmp - impossible. If this is enabled all + impossible. If this is enabled, all temporary files created by a service in these directories will be removed after the service is stopped. Defaults @@ -1208,18 +1208,18 @@ correctly on x86-64). If running in user mode and this option is used, NoNewPrivileges=yes - is implied. By default no + is implied. By default, no restriction applies, all address families are accessible to processes. If assigned the empty - string any previous list changes are + string, any previous list changes are undone. Use this option to limit exposure of processes to remote systems, in particular via exotic network protocols. Note that in most - cases the local + cases, the local AF_UNIX address family should be included in the configured whitelist as it is @@ -1240,7 +1240,7 @@ x86 and x86-64. This is useful when running 32-bit services on - a 64-bit host system. If not specified + a 64-bit host system. If not specified, the personality is left unmodified and thus reflects the personality of the host system's @@ -1252,14 +1252,14 @@ RuntimeDirectoryMode= Takes a list of - directory names. If set one or more + directory names. If set, one or more directories by the specified names will be created below /run (for system services) or below $XDG_RUNTIME_DIR (for user services) when the unit is - started and removed when the unit is + started, and removed when the unit is stopped. The directories will have the access mode specified in RuntimeDirectoryMode=, diff --git a/man/systemd.link.xml b/man/systemd.link.xml index 1bee07cf1..f73182aca 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -101,7 +101,7 @@ The driver currently bound to the device, as exposed by the udev property DRIVER - of its parent device, or if that is not set the + of its parent device, or if that is not set, the driver as exposed by ethtool -i of the device itself. diff --git a/man/systemd.network.xml b/man/systemd.network.xml index c4e5055d9..efe6ce755 100644 --- a/man/systemd.network.xml +++ b/man/systemd.network.xml @@ -299,7 +299,7 @@ Destination= The destination prefix of the route. Possibly followed by a slash and the - prefixlength, if ommitted a full-length host route is assumed. + prefixlength. If ommitted, a full-length host route is assumed. diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml index 44f55e05e..d82b9bdc9 100644 --- a/man/systemd.timer.xml +++ b/man/systemd.timer.xml @@ -274,7 +274,7 @@ WakeSystem= Takes a boolean - argument. If true an elapsing timer + argument. If true, an elapsing timer will cause the system to resume from suspend, should it be suspended and if the system supports this. Note that diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 30b6ea16e..157530be3 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -1019,7 +1019,7 @@ case the kernel command line is searched for the word appearing as is, or as left hand side of an - assignment. In the latter case the + assignment. In the latter case, the exact assignment is looked for with right and left hand side matching. diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 343fad163..e54f1ba5c 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -73,7 +73,7 @@ System daemons frequently require private runtime directories below /run to - place communication sockets and similar in. For these + place communication sockets and similar in. For these, consider declaring them in their unit files using RuntimeDirectory= (see systemd.exec5 for details),