From: Jan Engelhardt Date: Tue, 2 Jul 2013 03:44:04 +0000 (+0200) Subject: man: more grammar improvements X-Git-Tag: v205~7 X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=409dee2e44e7dc73d6bf00d782938e4cb4105f5b man: more grammar improvements - place commas - expand contractions (this is written prose :) - add some missing words --- diff --git a/man/bootchart.conf.xml b/man/bootchart.conf.xml index 7fd47ebe9..68d10d441 100644 --- a/man/bootchart.conf.xml +++ b/man/bootchart.conf.xml @@ -72,7 +72,7 @@ Samples=500 Configure the amount of samples to - record total before bootchart exits. Each sample will + record in total before bootchart exits. Each sample will record at intervals defined by Frequency=. @@ -107,7 +107,7 @@ Output=[path] - Configures the output folder for writing + Configures the output directory for writing the graphs. By default, bootchart writes the graphs to /run/log. @@ -124,7 +124,7 @@ PlotMemoryUsage=no If set to yes, enables logging and graphing - of processes PSS memory consumption. + of processes' PSS memory consumption. diff --git a/man/bootup.xml b/man/bootup.xml index a596e85b7..65c2cee70 100644 --- a/man/bootup.xml +++ b/man/bootup.xml @@ -56,26 +56,27 @@ and hand control over to a boot loader stored on a persistent storage device. This boot loader will then invoke an OS kernel from disk (or the network). In the - Linux case this kernel (optionally) extracts and - executes an initial RAM disk image (initrd) such as - dracut8 + Linux case, this kernel (optionally) extracts and + executes an initial RAM disk image (initrd), such as + generated by + dracut8, which looks for the root file system (possibly using systemd1 for this). After the root file system is found and - mounted the initrd hands over control to the host's + mounted, the initrd hands over control to the host's system manager (such as systemd1) - stored on the OS image which is then responsible for + stored on the OS image, which is then responsible for probing all remaining hardware, mounting all necessary file systems and spawning all configured services. - On shutdown the system manager stops all + On shutdown, the system manager stops all services, unmounts all file systems (detaching the storage technologies backing them), and then (optionally) jumps back into the initrd code which unmounts/detaches the root file system and the storage - it resides on. As last step the system is powered down. + it resides on. As a last step, the system is powered down. Additional information about the system boot process may be found in @@ -90,7 +91,7 @@ systems, services and drivers that are necessary for operation of the system. On systemd1 - systems this process is split up in various discrete + systems, this process is split up in various discrete steps which are exposed as target units. (See systemd.target5 for detailed information about target units.) The @@ -99,17 +100,17 @@ deterministic, but still adheres to a limited amount of ordering structure. - When systemd starts up the system it will + When systemd starts up the system, it will activate all units that are dependencies of default.target (as well as recursively all dependencies of these - dependencies). Usually + dependencies). Usually, default.target is simply an alias of graphical.target or - multi-user.target depending on + multi-user.target, depending on whether the system is configured for a graphical UI or only for a text console. To enforce minimal ordering - between the units pulled in a number of well-known + between the units pulled in, a number of well-known target units are available, as listed on systemd.special7. @@ -178,7 +179,7 @@ Bootup in the Initial RAM Disk (initrd) The initial RAM disk implementation (initrd) can - be set up using systemd as well. In this case boot up + be set up using systemd as well. In this case, boot up inside the initrd follows the following structure. diff --git a/man/crypttab.xml b/man/crypttab.xml index 1063b46e0..e52b7e601 100644 --- a/man/crypttab.xml +++ b/man/crypttab.xml @@ -83,15 +83,15 @@ underlying block device, or a specification of a block device via UUID= followed by the UUID. If the block device contains a LUKS signature, - it is opened as a LUKS encrypted partition; otherwise + it is opened as a LUKS encrypted partition; otherwise, it is assumed to be a raw dm-crypt partition. The third field specifies the encryption password. If the field is not present or the password is set to none, the password has to be manually - entered during system boot. Otherwise the field is + entered during system boot. Otherwise, the field is interpreted as a path to a file containing the - encryption password. For swap encryption + encryption password. For swap encryption, /dev/urandom or the hardware device /dev/hw_random can be used as the password file; using @@ -239,7 +239,7 @@ The system will not wait for the device to show up and be unlocked at boot, and not fail the - boot if it doesn't show + boot if it does not show up. @@ -282,7 +282,7 @@ At early boot and when the system manager - configuration is reloaded this file is translated into + configuration is reloaded, this file is translated into native systemd units by systemd-cryptsetup-generator8. diff --git a/man/daemon.xml b/man/daemon.xml index 76ae832a4..7790420c6 100644 --- a/man/daemon.xml +++ b/man/daemon.xml @@ -79,7 +79,7 @@ descriptors 0, 1, 2). This ensures that no accidentally passed file descriptor stays around in the daemon - process. On Linux this is best + process. On Linux, this is best implemented by iterating through /proc/self/fd, with a fallback of iterating from file @@ -115,7 +115,7 @@ In the child, call fork() again, to - ensure the daemon can never re-acquire + ensure that the daemon can never re-acquire a terminal again. Call exit() in the @@ -150,15 +150,15 @@ getpid()) to a PID file, for example /var/run/foobar.pid - (for a hypothetical daemon "foobar"), + (for a hypothetical daemon "foobar") to ensure that the daemon cannot be started more than once. This must be implemented in race-free fashion so that the PID file is only updated when - at the same time it is verified that + it is verified at the same time that the PID previously stored in the PID file no longer exists or belongs to a - foreign process. Commonly some kind of + foreign process. Commonly, some kind of file locking is employed to implement this logic. @@ -167,7 +167,7 @@ applicable. From the daemon - process notify the original process + process, notify the original process started that initialization is complete. This can be implemented via an unnamed pipe or similar @@ -197,7 +197,7 @@ implement the scheme pointed out above. However, it is recommended to make this behavior optional and configurable via a - command line argument, to ease debugging as + command line argument to ease debugging as well as to simplify integration into systems using systemd. @@ -211,20 +211,20 @@ runtime and simplifies their implementation. - For developing a new-style daemon none + For developing a new-style daemon, none of the initialization steps recommended for SysV daemons need to be implemented. New-style init systems such as systemd make all of them redundant. Moreover, since some of these steps interfere with process monitoring, file descriptor passing and other functionality of - the init system it is recommended not to + the init system, it is recommended not to execute them when run as new-style service. Note that new-style init systems guarantee execution of daemon processes in - clean process contexts: it is guaranteed that + a clean process context: it is guaranteed that the environment block is sanitized, that the signal handlers and mask is reset and that no left-over file descriptors are passed. Daemons @@ -256,7 +256,7 @@ scripts. If possible and - applicable expose the daemon's control + applicable, expose the daemon's control interface via the D-Bus IPC system and grab a bus name as last step of initialization. @@ -274,7 +274,7 @@ rely on the init system's functionality to limit the access of the daemon to files, services and - other resources. i.e. in the case of + other resources, i.e. in the case of systemd, rely on systemd's resource limit control instead of implementing your own, rely on systemd's privilege @@ -285,7 +285,7 @@ controls. If D-Bus is used, make - your daemon bus-activatable, via + your daemon bus-activatable by supplying a D-Bus service activation configuration file. This has multiple advantages: your daemon may be started @@ -293,7 +293,7 @@ parallel to other daemons requiring it -- which maximizes parallelization and boot-up speed; your daemon can be - restarted on failure, without losing + restarted on failure without losing any bus requests, as the bus queues requests for activatable services. See below for details. @@ -304,17 +304,17 @@ socket, it should be made socket-activatable following the scheme pointed out below. Like D-Bus - activation this enables on-demand + activation, this enables on-demand starting of services as well as it allows improved parallelization of service start-up. Also, for state-less - protocols (such as syslog, DNS) a + protocols (such as syslog, DNS), a daemon implementing socket-based activation can be restarted without losing a single request. See below for details. - If applicable a daemon + If applicable, a daemon should notify the init system about startup completion or status updates via the @@ -327,7 +327,7 @@ choose to simply log to STDERR via fprintf(), which is then forwarded to syslog by the init system. If log - priorities are necessary these can be + priorities are necessary, these can be encoded by prefixing individual log lines with strings like "<4>" (for log priority 4 "WARNING" in the @@ -343,7 +343,7 @@ kind of logging may be enabled by setting StandardError=syslog - in the service unit file. For details + in the service unit file. For details, see sd-daemon3 and @@ -374,9 +374,9 @@ when a printer is plugged in, or when a file is queued in the printer spool directory. Even for services that are intended to be started on system bootup - unconditionally it is a good idea to implement some of + unconditionally, it is a good idea to implement some of the various activation schemes outlined below, in - order to maximize parallelization: if a daemon + order to maximize parallelization. If a daemon implements a D-Bus service or listening socket, implementing the full bus and socket activation scheme allows starting of the daemon with its clients in @@ -384,7 +384,7 @@ communication channels are established already, and no request is lost because client requests will be queued by the bus system (in case of D-Bus) or the kernel (in - case of sockets), until the activation is + case of sockets) until the activation is completed. @@ -399,7 +399,7 @@ Specification. This method of activation is supported ubiquitously on Linux init systems, both old-style and new-style - systems. Among other issues SysV init scripts + systems. Among other issues, SysV init scripts have the disadvantage of involving shell scripts in the boot process. New-style init systems generally employ updated versions of @@ -409,7 +409,7 @@ In systemd, if the developer or administrator wants to make sure a service or - other unit is activated automatically on boot + other unit is activated automatically on boot, it is recommended to place a symlink to the unit file in the .wants/ directory of either @@ -434,25 +434,25 @@ recommended for all new-style daemons that communicate via listening sockets to employ socket-based activation. In a socket-based - activation scheme the creation and binding of + activation scheme, the creation and binding of the listening socket as primary communication channel of daemons to local (and sometimes remote) clients is moved out of the daemon code and into the init system. Based on - per-daemon configuration the init system + per-daemon configuration, the init system installs the sockets and then hands them off to the spawned process as soon as the respective daemon is to be started. - Optionally activation of the service can be + Optionally, activation of the service can be delayed until the first inbound traffic - arrives at the socket, to implement on-demand + arrives at the socket to implement on-demand activation of daemons. However, the primary advantage of this scheme is that all providers and all consumers of the sockets can be started in parallel as soon as all sockets - are established. In addition to that daemons + are established. In addition to that, daemons can be restarted with losing only a minimal - number of client transactions or even any + number of client transactions, or even any client request at all (the latter is particularly true for state-less protocols, such as DNS or syslog), because the socket @@ -462,16 +462,16 @@ New-style daemons which support socket activation must be able to receive their - sockets from the init system, instead of + sockets from the init system instead of creating and binding them themselves. For details about the programming interfaces for - this scheme provided by systemd see + this scheme provided by systemd, see sd_listen_fds3 and sd-daemon3. For details about porting existing daemons to - socket-based activation see below. With - minimal effort it is possible to implement + socket-based activation, see below. With + minimal effort, it is possible to implement socket-based activation in addition to traditional internal socket creation in the same codebase in order to support both @@ -483,20 +483,20 @@ units, which are described in systemd.socket5. When configuring socket units for socket-based - activation it is essential that all listening + activation, it is essential that all listening sockets are pulled in by the special target unit sockets.target. It is recommended to place a WantedBy=sockets.target directive in the [Install] - section, to automatically add such a + section to automatically add such a dependency on installation of a socket unit. Unless DefaultDependencies=no is - set the necessary ordering dependencies are + set, the necessary ordering dependencies are implicitly created for all socket units. For more information about - sockets.target see + sockets.target, see systemd.special7. It is not necessary or recommended to place any additional dependencies on socket units (for @@ -518,16 +518,16 @@ service files (not to be confused with systemd service unit files!). To ensure that D-Bus uses systemd to start-up and maintain the - daemon use the + daemon, use the SystemdService= directive - in these service files, to configure the + in these service files to configure the matching systemd service for a D-Bus - service. e.g.: for a D-Bus service whose D-Bus + service. e.g.: For a D-Bus service whose D-Bus activation file is named org.freedesktop.RealtimeKit.service, make sure to set SystemdService=rtkit-daemon.service - in that file, to bind it to the systemd + in that file to bind it to the systemd service rtkit-daemon.service. This is needed to make sure that the daemon is @@ -542,23 +542,23 @@ type of hardware should be activated only when the hardware of the respective kind is plugged in or otherwise becomes available. In a - new-style init system it is possible to bind + new-style init system, it is possible to bind activation to hardware plug/unplug events. In systemd, kernel devices appearing in the sysfs/udev device tree can be exposed as units if they are tagged with the string systemd. Like any other - kind of unit they may then pull in other units - when activated (i.e. Plugged in) and thus - implement device-based activation. Systemd + kind of unit, they may then pull in other units + when activated (i.e. plugged in) and thus + implement device-based activation. systemd dependencies may be encoded in the udev database via the SYSTEMD_WANTS= property. See systemd.device5 - for details. Often it is nicer to pull in + for details. Often, it is nicer to pull in services from devices only indirectly via - dedicated targets. Example: instead of pulling + dedicated targets. Example: Instead of pulling in bluetoothd.service from all the various bluetooth dongles and other hardware available, pull in @@ -610,10 +610,10 @@ Other forms of activation have been suggested and implemented in some - systems. However, often there are simpler or + systems. However, there are often simpler or better alternatives, or they can be put together of combinations of the schemes - above. Example: sometimes it appears useful to + above. Example: Sometimes, it appears useful to start daemons or .socket units when a specific IP address is configured on a network interface, because network @@ -634,7 +634,7 @@ service activation is low system load. However, here too, a more convincing approach might be to make proper use of - features of the operating system: in + features of the operating system, in particular, the CPU or IO scheduler of Linux. Instead of scheduling jobs from userspace based on monitoring the OS @@ -668,7 +668,7 @@ suggestions: - If possible do not use + If possible, do not use the Type=forking setting in service files. But if you do, make sure to set the PID file path @@ -711,15 +711,15 @@ information for the unit file. See systemd.unit5 for details. To activate your service - on boot make sure to add a + on boot, make sure to add a WantedBy=multi-user.target or WantedBy=graphical.target directive. To activate your socket on boot, make sure to add - WantedBy=sockets.target. Usually + WantedBy=sockets.target. Usually, you also want to make sure that when - your service is installed your socket + your service is installed, your socket is installed too, hence add Also=foo.socket in your service file @@ -735,7 +735,7 @@ At the build installation time (e.g. make install during - package build) packages are recommended to + package build), packages are recommended to install their systemd unit files in the directory returned by pkg-config systemd @@ -748,12 +748,12 @@ request but not activate them automatically during boot. Optionally, during package installation (e.g. rpm -i - by the administrator) symlinks should be + by the administrator), symlinks should be created in the systemd configuration directories via the enable command of the systemctl1 - tool, to activate them automatically on + tool to activate them automatically on boot. Packages using @@ -801,7 +801,7 @@ endif In the rpm8 - .spec file use snippets + .spec file, use snippets like the following to enable/disable the service during installation/deinstallation. This makes use of @@ -827,7 +827,7 @@ endif %systemd_postun If the service shall be restarted during - upgrades replace the + upgrades, replace the %postun scriptlet above with the following: @@ -859,7 +859,7 @@ fi Where 0.47.11-1 is the first package version that includes the native unit file. This fragment will ensure that the first - time the unit file is installed it will be + time the unit file is installed, it will be enabled if and only if the SysV init script is enabled, thus making sure that the enable status is not changed. Note that @@ -875,13 +875,13 @@ fi Porting Existing Daemons Since new-style init systems such as systemd are - compatible with traditional SysV init systems it is + compatible with traditional SysV init systems, it is not strictly necessary to port existing daemons to the - new style. However doing so offers additional + new style. However, doing so offers additional functionality to the daemons as well as simplifying integration into new-style init systems. - To port an existing SysV compatible daemon the + To port an existing SysV compatible daemon, the following steps are recommended: @@ -896,7 +896,7 @@ fi interfaces to other software running on the local system via local AF_UNIX sockets, consider implementing socket-based activation - (see above). Usually a minimal patch is + (see above). Usually, a minimal patch is sufficient to implement this: Extend the socket creation in the daemon code so that sd_listen_fds3 diff --git a/man/halt.xml b/man/halt.xml index 847396519..2a13d3c63 100644 --- a/man/halt.xml +++ b/man/halt.xml @@ -114,7 +114,7 @@ Force immediate halt, - power-off, reboot. Don't contact the + power-off, reboot. Do not contact the init system. @@ -123,7 +123,7 @@ Only write wtmp - shutdown entry, don't actually halt, + shutdown entry, do not actually halt, power-off, reboot. @@ -131,14 +131,14 @@ - Don't write wtmp + Do not write wtmp shutdown entry. - Don't send wall + Do not send wall message before halt, power-off, reboot. diff --git a/man/hostname.xml b/man/hostname.xml index 5971ad434..a8648c529 100644 --- a/man/hostname.xml +++ b/man/hostname.xml @@ -56,7 +56,7 @@ The /etc/hostname file configures the name of the local system that is set - during boot, with the + during boot using the sethostname2 system call. It should contain a single newline-terminated hostname string. The diff --git a/man/hostnamectl.xml b/man/hostnamectl.xml index 28e875daf..f28e430a4 100644 --- a/man/hostnamectl.xml +++ b/man/hostnamectl.xml @@ -75,7 +75,7 @@ Note that the pretty hostname has little restrictions on the characters used, while the static and transient hostnames are limited to the usually - accepted characters of internet domain names. + accepted characters of Internet domain names. The static hostname is stored in /etc/hostname, see @@ -110,7 +110,7 @@ - Don't query the user + Do not query the user for authentication for privileged operations. diff --git a/man/journalctl.xml b/man/journalctl.xml index fa29c4103..8dbfb3f0f 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -64,11 +64,11 @@ journal as written by systemd-journald.service8. - If called without parameter it will show the full + If called without parameters, it will show the full contents of the journal, starting with the oldest entry collected. - If one or more match arguments are passed the + If one or more match arguments are passed, the output is filtered accordingly. A match is in the format FIELD=VALUE, e.g. _SYSTEMD_UNIT=httpd.service, @@ -76,7 +76,7 @@ entry. See systemd.journal-fields7 for a list of well-known fields. If multiple matches - are specified matching different fields the log + are specified matching different fields, the log entries are filtered by both, i.e. the resulting output will show only entries matching all the specified matches of this kind. If two matches apply to the same @@ -85,25 +85,25 @@ entries matching any of the specified matches for the same field. Finally, if the character + appears as separate word on the - command line all matches before and after are combined + command line, all matches before and after are combined in a disjunction (i.e. logical OR). As shortcuts for a few types of field/value - matches file paths may be specified. If a file path + matches, file paths may be specified. If a file path refers to an executable file, this is equivalent to an _EXE= match for the canonicalized - binary path. Similar, if a path refers to a device + binary path. Similarly, if a path refers to a device node, this is equivalent to a _KERNEL_DEVICE= match for the device. Output is interleaved from all accessible journal files, whether they are rotated or currently - being written, and regardless whether they belong to the + being written, and regardless of whether they belong to the system itself or are accessible user journals. All users are granted access to their private - per-user journals. However, by default only root and + per-user journals. However, by default, only root and users who are members of the adm group get access to the system journal and the journals of other users. @@ -173,7 +173,7 @@ the end of the journal inside the implied pager tool. This implies to guarantee - that the pager won't buffer logs of + that the pager will not buffer logs of unbounded size. This may be overridden with an explicit with some other numeric value on the @@ -230,7 +230,7 @@ cat. short is the default and generates an output that is mostly identical to the - formatting of classic syslog log + formatting of classic syslog files, showing one line per journal entry. short-monotonic is very similar but shows monotonic @@ -285,7 +285,7 @@ manuals. Note that help texts are not available for all messages, but only for selected ones. For more - information on the message catalog + information on the message catalog, please refer to the Message Catalog Developer @@ -386,10 +386,10 @@ notice (5), info (6), debug (7). If a - single log level is specified all + single log level is specified, all messages with this log level or a lower (hence more important) log level - are shown. If a range is specified all + are shown. If a range is specified, all messages within the range are shown, including both the start and the end value of the range. This will add @@ -468,7 +468,7 @@ Takes a directory path - as argument. If specified journalctl + as argument. If specified, journalctl will operate on the specified journal directory DIR instead @@ -480,7 +480,7 @@ Takes a file glob as - argument. If specified journalctl will + argument. If specified, journalctl will operate on the specified journal files matching GLOB instead of the default runtime and @@ -493,7 +493,7 @@ Takes a directory path - as argument. If specified journalctl + as argument. If specified, journalctl will operate on catalog file hierarchy underneath the specified directory instead of the root directory @@ -507,13 +507,13 @@ Instead of showing - journal contents generate a new 128 + journal contents, generate a new 128 bit ID suitable for identifying messages. This is intended for usage by developers who need a new identifier for a new message they introduce and want to make - recognizable. Will print the new ID in + recognizable. This will print the new ID in three different formats which can be copied into source code or similar. @@ -523,7 +523,7 @@ Instead of showing - journal contents show internal header + journal contents, show internal header information of the journal fields accessed. @@ -587,7 +587,7 @@ Instead of showing - journal contents generate a new key + journal contents, generate a new key pair for Forward Secure Sealing (FSS). This will generate a sealing key and a verification key. The @@ -604,7 +604,7 @@ Specifies the change - interval for the sealing key, when + interval for the sealing key when generating an FSS key pair with . Shorter intervals increase CPU consumption but @@ -620,9 +620,9 @@ Check the journal file for internal consistency. If the file has been generated with FSS - enabled, and the FSS verification key + enabled and the FSS verification key has been specified with - + , authenticity of the journal file is verified. @@ -642,7 +642,7 @@ Exit status - On success 0 is returned, a non-zero failure + On success, 0 is returned, a non-zero failure code otherwise. @@ -665,24 +665,24 @@ Examples - Without arguments all collected logs are shown + Without arguments, all collected logs are shown unfiltered: journalctl - With one match specified all entries with a field matching the expression are shown: + With one match specified, all entries with a field matching the expression are shown: journalctl _SYSTEMD_UNIT=avahi-daemon.service - If two different fields are matched only entries matching both expressions at the same time are shown: + If two different fields are matched, only entries matching both expressions at the same time are shown: journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 - If two matches refer to the same field all entries matching either expression are shown: + If two matches refer to the same field, all entries matching either expression are shown: journalctl _SYSTEMD_UNIT=avahi-daemon.service _SYSTEMD_UNIT=dbus.service - If the separator + is used + If the separator + is used, two expressions may be combined in a logical OR. The following will show all messages from the Avahi service process with the PID 28097 plus all messages diff --git a/man/journald.conf.xml b/man/journald.conf.xml index 6e43914f2..b161b34e4 100644 --- a/man/journald.conf.xml +++ b/man/journald.conf.xml @@ -54,8 +54,8 @@ Description - This files configures various parameters of the - systemd journal service + This file configures various parameters of the + systemd journal service, systemd-journald.service8. @@ -77,13 +77,13 @@ persistent, auto and none. If - volatile journal + volatile, journal log data will be stored only in memory, i.e. below the /run/log/journal hierarchy (which is created if needed). If - persistent data will + persistent, data will be stored preferably on disk, i.e. below the /var/log/journal @@ -112,7 +112,7 @@ Compress= Takes a boolean - value. If enabled (the default) data + value. If enabled (the default), data objects that shall be stored in the journal and are larger than a certain threshold are compressed with the XZ @@ -125,7 +125,7 @@ Seal= Takes a boolean - value. If enabled (the default) and a + value. If enabled (the default), and a sealing key is available (as created by journalctl1's @@ -149,23 +149,23 @@ of login, uid and none. If - login each logged - in user will get his own journal + login, each logged-in + user will get his own journal files, but systemd user IDs will log into the system journal. If - uid any user ID + uid, any user ID will get his own journal files regardless whether it belongs to a system service or refers to a real logged in user. If - none journal files - are not split up per-user and all - messages are stored in the single + none, journal files + are not split up by user and all + messages are instead stored in the single system journal. Note that splitting - up journal files per-user is only - available of journals are stored + up journal files by user is only + available for journals stored persistently. If journals are stored - on volatile storage (see above) only a + on volatile storage (see above), only a single journal file for all user IDs is kept. Defaults to login. @@ -177,14 +177,14 @@ Configures the rate limiting that is applied to all - messages generated on the system. If + messages generated on the system. If, in the time interval defined by - RateLimitInterval= + RateLimitInterval=, more messages than specified in RateLimitBurst= are - logged by a service all further + logged by a service, all further messages within the interval are - dropped, until the interval is over. A + dropped until the interval is over. A message about the number of dropped messages is generated. This rate limiting is applied per-service, so @@ -227,13 +227,13 @@ /run/log/journal. The former is used only when /var is mounted, - writable and the directory + writable, and the directory /var/log/journal - exists. Otherwise only the latter + exists. Otherwise, only the latter applies. Note that this means that during early boot and if the administrator disabled persistent - logging only the latter options apply, + logging, only the latter options apply, while the former apply if persistent logging is enabled and the system is fully booted @@ -293,23 +293,26 @@ The maximum time to store entries in a single journal - file, before rotating to the next - one. Normally time-based rotation + file before rotating to the next + one. Normally, time-based rotation should not be required as size-based rotation with options such as SystemMaxFileSize= should be sufficient to ensure that - journal files don't grow without + journal files do not grow without bounds. However, to ensure that not too much data is lost at once when old - journal files are deleted it might + journal files are deleted, it might make sense to change this value from the default of one month. Set to 0 to turn off this feature. This setting takes time values which may be - suffixed with the units year, month, - week, day, h, m to override the - default time unit of + suffixed with the units + year, + month, + week, day, + h or m + to override the default time unit of seconds. @@ -321,31 +324,34 @@ controls whether journal files containing entries older then the specified time span are - deleted. Normally time-based deletion + deleted. Normally, time-based deletion of old journal files should not be required as size-based deletion with options such as SystemMaxUse= should be sufficient to ensure that - journal files don't grow without + journal files do not grow without bounds. However, to enforce data - retention policies it might make sense + retention policies, it might make sense to change this value from the default of 0 (which turns off this feature). This setting also takes time values which may be suffixed with - the units year, month, week, day, h, m + the units year, + month, + week, day, + h or m to override the default time unit of - seconds. + seconds. SyncIntervalSec= - The timeout before syncing journal - data to disk. After syncing journal files have - OFFLINE state. Default timeout is 5 minutes. + The timeout before synchronizing journal + data to disk. After syncing, journal files have + the OFFLINE state. Default timeout is 5 minutes. @@ -362,8 +368,8 @@ system console. These options take boolean arguments. If forwarding to syslog is enabled but no syslog daemon - is running the respective option has - no effect. By default only forwarding + is running, the respective option has + no effect. By default, only forwarding to syslog is enabled. These settings may be overridden at boot time with the kernel command line options diff --git a/man/kernel-command-line.xml b/man/kernel-command-line.xml index db5d38a74..a4b7d13c8 100644 --- a/man/kernel-command-line.xml +++ b/man/kernel-command-line.xml @@ -59,7 +59,7 @@ kernel command line arguments. For command line parameters understood by the - kernel please see kernel-parameters.txt and bootparam7. @@ -93,7 +93,7 @@ Parameters understood by the system and service manager - to control system behavior. For details see + to control system behavior. For details, see systemd1. @@ -105,7 +105,7 @@ both the kernel and the system and service manager to control console log verbosity. For - details see + details, see systemd1. @@ -117,7 +117,7 @@ both the kernel and the system and service manager to control console log verbosity. For - details see + details, see systemd1. @@ -136,7 +136,7 @@ Parameters understood by the system and service manager, as compatibility - options. For details see + options. For details, see systemd1. @@ -160,7 +160,7 @@ Parameters understood by the system and service manager to control locale and language - settings. For details see + settings. For details, see systemd1. @@ -171,7 +171,7 @@ Parameter understood by the file system checker - services. For details see + services. For details, see systemd-fsck@.service8. @@ -182,7 +182,7 @@ Parameter understood by the file quota checker - service. For details see + service. For details, see systemd-quotacheck.service8. @@ -195,7 +195,7 @@ Parameters understood by the journal service. For - details see + details, see systemd-journald.service8. @@ -210,7 +210,7 @@ Parameters understood by the virtual console setup logic. For - details see + details, see systemd-vconsole-setup.service8. @@ -227,7 +227,7 @@ Parameters understood by the device event managing daemon. For - details see + details, see systemd-udevd.service8. @@ -238,7 +238,7 @@ May be used to disable the Plymouth boot splash. For - details see + details, see plymouth8. @@ -256,7 +256,7 @@ Configures the LUKS full-disk encryption logic at - boot. For details see + boot. For details, see systemd-cryptsetup-generator8. @@ -268,7 +268,7 @@ Configures the /etc/fstab - logic at boot. For details see + logic at boot. For details, see systemd-fstab-generator8. @@ -280,7 +280,7 @@ Load a specific kernel module early at boot. For - details see + details, see systemd-modules-load.service8. diff --git a/man/kernel-install.xml b/man/kernel-install.xml index d21d7579b..929ceef4a 100644 --- a/man/kernel-install.xml +++ b/man/kernel-install.xml @@ -73,7 +73,7 @@ along with systemd; If not, see . executables with a local file if needed; a symbolic link in /etc/kernel/install.d/ with the same name as an executable in /usr/lib/kernel/install.d/, pointing to /dev/null, disables the executable entirely. Executables must have the - extension .install; other extensions are ignored. + extension .install; other extensions are ignored. @@ -112,7 +112,7 @@ add KERNEL-VERSION /boot/MACHI remove KERNEL-VERSION - calls every executable /usr/lib/kernel/install.d/*.install + Calls every executable /usr/lib/kernel/install.d/*.install and /etc/kernel/install.d/*.install with the arguments remove KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/ @@ -145,7 +145,7 @@ remove KERNEL-VERSION /boot/MA /etc/kernel/install.d/*.install - Drop-in files, which are executed by kernel-install. + Drop-in files which are executed by kernel-install. diff --git a/man/locale.conf.xml b/man/locale.conf.xml index 42634feba..e97092102 100644 --- a/man/locale.conf.xml +++ b/man/locale.conf.xml @@ -64,7 +64,7 @@ newline-separated list of environment-like shell-compatible variable assignments. It is possible to source the configuration from shell scripts, - however, beyond mere variable assignments no shell + however, beyond mere variable assignments, no shell features are supported, allowing applications to read the file without implementing a shell compatible execution engine. @@ -92,7 +92,7 @@ overridden or unset by individual programs or individual users. - Depending on the operating system other + Depending on the operating system, other configuration files might be checked for locale configuration as well, however only as fallback. @@ -132,7 +132,7 @@ /etc/locale.conf: LANG=de_DE.UTF-8 -LC_MESSAGES=C +LC_MESSAGES=en_US.UTF-8 diff --git a/man/localectl.xml b/man/localectl.xml index f14393071..a3e07f650 100644 --- a/man/localectl.xml +++ b/man/localectl.xml @@ -105,7 +105,7 @@ - Don't query the user + Do not query the user for authentication for privileged operations. @@ -188,7 +188,7 @@ one to define a toggle keyboard mapping. Unless is - passed the selected setting is also + passed, the selected setting is also applied to the default keyboard mapping of X11, after converting it to the closest matching X11 keyboard @@ -218,7 +218,7 @@ kbd4 for details. Unless is - passed the selected setting is also + passed, the selected setting is also applied to the system console keyboard mapping, after converting it to the closest matching console keyboard @@ -249,7 +249,7 @@ Exit status - On success 0 is returned, a non-zero failure + On success, 0 is returned, a non-zero failure code otherwise. diff --git a/man/localtime.xml b/man/localtime.xml index b95c2ee6b..b7fd1ba15 100644 --- a/man/localtime.xml +++ b/man/localtime.xml @@ -74,9 +74,9 @@ tzfile5 timezone data for the configured timezone. - As the timezone identifier is extracted from + Because the timezone identifier is extracted from the symlink target name of - /etc/localtime this file may not + /etc/localtime, this file may not be a normal file or hardlink. The timezone may be overridden for individual diff --git a/man/loginctl.xml b/man/loginctl.xml index 790a3e4bf..b9db47598 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -91,11 +91,11 @@ session/user properties, limit display to certain properties as specified as argument. If not - specified all set properties are + specified, all set properties are shown. The argument should be a property name, such as Sessions. If - specified more than once all + specified more than once, all properties with the specified names are shown. @@ -129,7 +129,7 @@ - Don't query the user + Do not query the user for authentication for privileged operations. @@ -161,7 +161,7 @@ SIGTERM, SIGINT or SIGSTOP. If - omitted defaults to + omitted, defaults to SIGTERM. @@ -214,14 +214,14 @@ Show properties of one or more sessions or the manager - itself. If no argument is specified + itself. If no argument is specified, properties of the manager will be - shown. If a session ID is specified + shown. If a session ID is specified, properties of the session is 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 @@ -317,7 +317,7 @@ 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 @@ -337,7 +337,7 @@ enabled for a specific user, a user manager is spawned for him/her at boot and kept around after - logouts. This allows users who aren't + logouts. This allows users who are not logged in to run long-running services. @@ -455,7 +455,7 @@ Exit status - On success 0 is returned, a non-zero failure + On success, 0 is returned, a non-zero failure code otherwise. diff --git a/man/logind.conf.xml b/man/logind.conf.xml index b7109353c..74a100eb1 100644 --- a/man/logind.conf.xml +++ b/man/logind.conf.xml @@ -54,7 +54,7 @@ Description - This file configures various parameters of the systemd login manager systemd-logind.service8. + This file configures various parameters of the systemd login manager, systemd-logind.service8. @@ -81,7 +81,7 @@ autovt@.service for the respective VT TTY name, e.g. autovt@tty4.service. By - default + default, autovt@.service is linked to getty@.service, @@ -92,7 +92,7 @@ gettys are available on the VTs. If a VT is already used by some other subsystem - (for example a graphical login) this + (for example a graphical login), this kind of activation will not be attempted. Note that the VT configured in ReserveVT= is @@ -103,7 +103,7 @@ directive. Defaults to 6. When set to 0, automatic spawning of autovt services is - disabled. + disabled. @@ -120,10 +120,10 @@ other subsystem will allocate it. This functionality is useful to ensure that regardless how many VTs are allocated - by other subsystems one login + by other subsystems, one login getty is always available. Defaults to 6 (with other - words: there'll always be a + words: there will always be a getty available on Alt-F6.). When set to 0, VT reservation is @@ -304,7 +304,7 @@ 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=, @@ -330,7 +330,7 @@ Note that KillUserProcesses=1 is a weaker version of - kill-session-processes=1 which may + kill-session-processes=1, which may be configured per-service for pam_systemd8. The latter kills processes of a session as soon as it diff --git a/man/machine-id.xml b/man/machine-id.xml index d7a56cb54..b037e47c0 100644 --- a/man/machine-id.xml +++ b/man/machine-id.xml @@ -65,7 +65,7 @@ The machine ID is usually generated from a random source during system installation and stays constant for all subsequent boots. Optionally, for - stateless systems it is generated during runtime at + stateless systems, it is generated during runtime at boot if it is found to be empty. The machine ID does not change based on user @@ -113,7 +113,7 @@ id[8] = (id[8] & 0x3F) | 0x80; (This code is inspired by generate_random_uuid() of drivers/char/random.c from the - kernel sources.) + Linux kernel sources.) @@ -123,7 +123,7 @@ id[8] = (id[8] & 0x3F) | 0x80; The simple configuration file format of /etc/machine-id originates in the /var/lib/dbus/machine-id file - introduced by D-Bus. In fact this latter file might be a + introduced by D-Bus. In fact, this latter file might be a symlink to /etc/machine-id. diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 1fd609dc8..4f0bd64b1 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -797,7 +797,7 @@ highly recommended to leave this option enabled for the majority of common units. If set to - this option + , this option does not disable all implicit dependencies, just non-essential ones.