aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDavid Bryant <david@davidcbryant.net>2023-01-25 13:10:44 -0600
committerDavid Bryant <david@davidcbryant.net>2023-01-25 13:10:44 -0600
commit69854d2a873d74a7956e34d3f29f28aafa5c07f7 (patch)
tree8b0d43767d0e2288f4633eeacb29c8dd2fefc6e4
parentb74c128bc9bf9adeaf5d5e5a11e760bbfa60d640 (diff)
Edit systemd chapters for grammar and idiom.
-rw-r--r--chapter08/dbus.xml4
-rw-r--r--chapter08/markupsafe.xml2
-rw-r--r--chapter08/systemd.xml62
3 files changed, 34 insertions, 34 deletions
diff --git a/chapter08/dbus.xml b/chapter08/dbus.xml
index 71a93e5cb..8f3c80f7a 100644
--- a/chapter08/dbus.xml
+++ b/chapter08/dbus.xml
@@ -67,9 +67,9 @@
<parameter>--with-system-socket=/run/dbus/system_bus_socket</parameter>
</term>
<listitem>
- <para>These set the location of the PID file and the system bus socket
+ <para>These cause the PID file and the system bus socket
to be in <filename class="directory">/run</filename>, instead of
- deprecated <filename class="directory">/var/run</filename>.</para>
+ the deprecated <filename class="directory">/var/run</filename>.</para>
</listitem>
</varlistentry>
diff --git a/chapter08/markupsafe.xml b/chapter08/markupsafe.xml
index 9481a194a..27fdb1627 100644
--- a/chapter08/markupsafe.xml
+++ b/chapter08/markupsafe.xml
@@ -23,7 +23,7 @@
<sect2 role="package">
<title/>
- <para>MarkupSafe is a Python module that implements a XML/HTML/XHTML Markup
+ <para>MarkupSafe is a Python module that implements an XML/HTML/XHTML Markup
safe string.</para>
<segmentedlist>
diff --git a/chapter08/systemd.xml b/chapter08/systemd.xml
index 2c5c0e11b..60b5f3605 100644
--- a/chapter08/systemd.xml
+++ b/chapter08/systemd.xml
@@ -60,7 +60,7 @@
cd build
meson --prefix=/usr \
- --buildtype=release \
+ --buildtype=release \location of the
-Ddefault-dnssec=no \
-Dfirstboot=false \
-Dinstall-tests=false \
@@ -82,7 +82,7 @@ meson --prefix=/usr \
<term><parameter>--buildtype=release</parameter></term>
<listitem>
<para>This switch overrides the default buildtype
- (<quote>debug</quote>), which would produce unoptimized
+ (<quote>debug</quote>), which produces unoptimized
binaries.</para>
</listitem>
</varlistentry>
@@ -99,7 +99,7 @@ meson --prefix=/usr \
<listitem>
<para>This switch prevents installation of systemd
services responsible for setting up the system for
- the first time. They are not useful for LFS because
+ the first time. These are not useful in LFS, because
everything is done manually.</para>
</listitem>
</varlistentry>
@@ -115,9 +115,9 @@ meson --prefix=/usr \
<term><parameter>-Dldconfig=false</parameter></term>
<listitem>
<para>This switch prevents installation of a systemd unit that runs
- <command>ldconfig</command> at boot, which is not useful for source
- distributions such as LFS and makes the boot time longer. Remove it
- if the described feature is desired.</para>
+ <command>ldconfig</command> at boot; this is not useful for source
+ distributions such as LFS, and makes the boot time longer. Remove
+ this option to enable running <command>ldconfig</command> at boot.</para>
</listitem>
</varlistentry>
@@ -137,15 +137,15 @@ meson --prefix=/usr \
<term><parameter>-Drpmmacrosdir=no</parameter></term>
<listitem>
<para>This switch disables installation of RPM Macros
- for use with systemd because LFS does not support RPM.</para>
+ for use with systemd, because LFS does not support RPM.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>-D{userdb,homed}=false</parameter></term>
<listitem>
- <para>Remove two daemons that have dependencies that do not fit
- the scope of LFS.</para>
+ <para>Remove two daemons with dependencies that do not fit
+ within the scope of LFS.</para>
</listitem>
</varlistentry>
@@ -154,7 +154,7 @@ meson --prefix=/usr \
<listitem>
<para>Prevent the generation of man pages to avoid extra
dependencies. We will install pre-generated man pages for systemd
- from a tarball later.</para>
+ from a tarball.</para>
</listitem>
</varlistentry>
@@ -194,12 +194,12 @@ meson --prefix=/usr \
<screen><userinput remap="adjust">systemd-machine-id-setup</userinput></screen>
- <para>Setup the basic target structure:</para>
+ <para>Set up the basic target structure:</para>
<screen><userinput remap="adjust">systemctl preset-all</userinput></screen>
<para>Disable two services for upgrading binary distros. They are useless for
- a basic Linux system built from source, and both will report an error if
+ a basic Linux system built from source, and each one will report an error if
it's enabled but not configured:</para>
<screen><userinput remap="adjust">systemctl disable systemd-sysupdate{,-reboot}</userinput></screen>
@@ -244,7 +244,7 @@ meson --prefix=/usr \
libnss_resolve.so.2, libnss_systemd.so.2,
libsystemd.so, libsystemd-shared-&systemd-version;.so (in /usr/lib/systemd),
and libudev.so</seg>
- <seg>/etc/binfmt.d, /etc/init.d, /etc/kernel, /etc/modules-load.d,
+ <seg>/etc/binfmt.d, /etc/init.d, /etc/kernel, /etc/modules-load.d,both
/etc/sysctl.d, /etc/systemd, /etc/tmpfiles.d, /etc/udev,
/etc/xdg/systemd, /usr/lib/systemd, /usr/lib/udev, /usr/include/systemd,
/usr/lib/binfmt.d, /usr/lib/environment.d, /usr/lib/kernel,
@@ -285,7 +285,7 @@ meson --prefix=/usr \
<listitem>
<para>Normally invokes <command>shutdown</command> with the
<parameter>-h</parameter> option, except when already in run-level 0,
- then it tells the kernel to halt the system; it notes in the
+ when it tells the kernel to halt the system; it notes in the
file <filename>/var/log/wtmp</filename> that the system is being
brought down</para>
<indexterm zone="ch-system-systemd halt">
@@ -308,9 +308,9 @@ meson --prefix=/usr \
<varlistentry id="init">
<term><command>init</command></term>
<listitem>
- <para>Is the first process to be started when the kernel has initialized
- the hardware which takes over the boot process and starts all
- processes according to its configuration files. In this case, it starts
+ <para>Is the first process to be started after the kernel has initialized
+ the hardware; <command>init</command> takes over the boot process and starts the
+ processes specified by its configuration files; in this case, it starts
systemd</para>
<indexterm zone="ch-system-systemd init">
<primary sortas="b-init">init</primary>
@@ -332,7 +332,7 @@ meson --prefix=/usr \
<term><command>kernel-install</command></term>
<listitem>
<para>Is used to add and remove kernel and initramfs images to and
- from /boot. In LFS, this is done manually</para>
+ from /boot; in LFS, this is done manually</para>
<indexterm zone="ch-system-systemd kernel-install">
<primary sortas="b-kernel-install">kernel-install</primary>
</indexterm>
@@ -485,8 +485,8 @@ meson --prefix=/usr \
<varlistentry id="systemd-analyze">
<term><command>systemd-analyze</command></term>
<listitem>
- <para>Is used to determine system startup performance of the current
- boot, as well as identify troublesome systemd units</para>
+ <para>Is used to analyze system startup performance,
+ as well as identify troublesome systemd units</para>
<indexterm zone="ch-system-systemd systemd-analyze">
<primary sortas="b-systemd-analyze">systemd-analyze</primary>
</indexterm>
@@ -497,7 +497,7 @@ meson --prefix=/usr \
<term><command>systemd-ask-password</command></term>
<listitem>
<para>Is used to query a system password or passphrase from the user,
- using a question message specified on the command line</para>
+ using a message specified on the Linux command line</para>
<indexterm zone="ch-system-systemd systemd-ask-password">
<primary sortas="b-systemd-ask-password">systemd-ask-password</primary>
</indexterm>
@@ -531,7 +531,7 @@ meson --prefix=/usr \
<term><command>systemd-cgtop</command></term>
<listitem>
<para>Shows the top control groups of the local Linux control group
- hierarchy, ordered by their CPU, memory and disk I/O load</para>
+ hierarchy, ordered by their CPU, memory and disk I/O loads</para>
<indexterm zone="ch-system-systemd systemd-cgtop">
<primary sortas="b-systemd-cgtop">systemd-cgtop</primary>
</indexterm>
@@ -552,8 +552,8 @@ meson --prefix=/usr \
<term><command>systemd-delta</command></term>
<listitem>
<para>Is used to identify and compare configuration files in
- <filename class="directory">/etc</filename> that override default
- counterparts in <filename class="directory">/usr</filename></para>
+ <filename class="directory">/etc</filename> that override the defaults
+ in <filename class="directory">/usr</filename></para>
<indexterm zone="ch-system-systemd systemd-delta">
<primary sortas="b-systemd-delta">systemd-delta</primary>
</indexterm>
@@ -605,7 +605,7 @@ meson --prefix=/usr \
<varlistentry id="systemd-id128">
<term><command>systemd-id128</command></term>
<listitem>
- <para>Generates and prints id128 strings</para>
+ <para>Generates and prints id128 (UUID) strings</para>
<indexterm zone="ch-system-systemd systemd-id128">
<primary sortas="b-systemd-id128">systemd-id128</primary>
</indexterm>
@@ -649,7 +649,7 @@ meson --prefix=/usr \
<varlistentry id="systemd-notify">
<term><command>systemd-notify</command></term>
<listitem>
- <para>Is used by daemon scripts to notify the init system about status
+ <para>Is used by daemon scripts to notify the init system of status
changes</para>
<indexterm zone="ch-system-systemd systemd-notify">
<primary sortas="b-systemd-notify">systemd-notify</primary>
@@ -660,7 +660,7 @@ meson --prefix=/usr \
<varlistentry id="systemd-nspawn">
<term><command>systemd-nspawn</command></term>
<listitem>
- <para>Is used to run a command or OS in a light-weight namespace
+ <para>Is used to run a command, or an entire OS, in a light-weight namespace
container</para>
<indexterm zone="ch-system-systemd systemd-nspawn">
<primary sortas="b-systemd-nspawn">systemd-nspawn</primary>
@@ -682,7 +682,7 @@ meson --prefix=/usr \
<term><command>systemd-repart</command></term>
<listitem>
<para>Is used to grow and add partitions to a partition table when
- systemd is used in an OS image (e.g. a container)</para>
+ systemd is used with an OS image (e.g. a container)</para>
<indexterm zone="ch-system-systemd systemd-repart">
<primary sortas="b-systemd-repart">systemd-repart</primary>
</indexterm>
@@ -704,7 +704,7 @@ meson --prefix=/usr \
<term><command>systemd-run</command></term>
<listitem>
<para>Is used to create and start a transient .service or a .scope
- unit and run the specified command in it. This is useful for
+ unit and run the specified command in it; this is useful for
validating systemd units</para>
<indexterm zone="ch-system-systemd systemd-run">
<primary sortas="b-systemd-run">systemd-run</primary>
@@ -736,7 +736,7 @@ meson --prefix=/usr \
<varlistentry id="systemd-tmpfiles">
<term><command>systemd-tmpfiles</command></term>
<listitem>
- <para>Creates, deletes and cleans up volatile and temporary files and
+ <para>Creates, deletes, and cleans up volatile and temporary files and
directories, based on the configuration file format and location
specified in
<filename class="directory">tmpfiles.d</filename> directories</para>
@@ -793,7 +793,7 @@ meson --prefix=/usr \
<term><command>udevadm</command></term>
<listitem>
<para>Is a generic udev administration tool which controls the udevd
- daemon, provides info from the Udev hardware database, monitors
+ daemon, provides info from the udev hardware database, monitors
uevents, waits for uevents to finish, tests udev configuration, and
triggers uevents for a given device</para>
<indexterm zone="ch-system-systemd udevadm">