Updates to chapter09 for systemd

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/cross2@11929 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

2 files changed, 69 insertions, 98 deletions

diff --git a/chapter08/dbus.xml b/chapter08/dbus.xml
index 0b06ad3e0..211399207 100644
--- a/chapter08/dbus.xml
+++ b/chapter08/dbus.xml
@@ -63,7 +63,7 @@
       <varlistentry>
         <term><parameter>--with-console-auth-dir=/run/console</parameter></term>
         <listitem>
-          <para>This specifies the location of the ConsoleKit auth
+          <para>This specifies the location of the ConsoleKit authorization
           directory.</para>
         </listitem>
       </varlistentry>
@@ -91,7 +91,7 @@
 <screen><userinput remap="install">mv -v /usr/lib/libdbus-1.so.* /lib
 ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</userinput></screen>
 
-    <para>Create a symlink, so that D-Bus and systemd can use the same
+    <para>Create a symlink so that D-Bus and systemd can use the same
     <filename>machine-id</filename> file:</para>
 
 <screen><userinput remap="install">ln -sfv /etc/machine-id /var/lib/dbus</userinput></screen>
@@ -130,7 +130,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri
       <varlistentry id="dbus-cleanup-sockets">
         <term><command>dbus-cleanup-sockets</command></term>
         <listitem>
-          <para>Used to clean up leftover sockets in a directory</para>
+          <para>is used to remove leftover sockets in a directory</para>
           <indexterm zone="ch-system-dbus dbus-cleanup-sockets">
             <primary sortas="b-dbus-cleanup-sockets">dbus-cleanup-sockets</primary>
           </indexterm>
@@ -140,7 +140,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri
       <varlistentry id="dbus-daemon">
         <term><command>dbus-daemon</command></term>
         <listitem>
-          <para>The D-Bus message bus daemon</para>
+          <para>Is the D-Bus message bus daemon</para>
           <indexterm zone="ch-system-dbus dbus-daemon">
             <primary sortas="b-dbus-daemon">dbus-daemon</primary>
           </indexterm>
@@ -193,7 +193,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libdbus-1.so) /usr/lib/libdbus-1.so</useri
       <varlistentry id="dbus-test-tool">
         <term><command>dbus-test-tool</command></term>
         <listitem>
-          <para>A tool to help packages test
+          <para>Is a tool to help packages test
           <application>D-Bus</application></para>
           <indexterm zone="ch-system-dbus dbus-test-tool">
             <primary sortas="b-dbus-test-tool">dbus-test-tool</primary>
diff --git a/chapter08/systemd.xml b/chapter08/systemd.xml
index 319f107a1..4049d726d 100644
--- a/chapter08/systemd.xml
+++ b/chapter08/systemd.xml
@@ -44,8 +44,7 @@
 
 <screen><userinput remap="pre">patch -Np1 -i ../systemd-&systemd-version;-gcc_10-fixes-1.patch</userinput></screen>
 
-
-    <para>Create a symlink to work around missing xsltproc:</para>
+    <para>Create a symlink to work around the xsltproc command not being installed:</para>
 
 <screen><userinput remap="pre">ln -sf /bin/true /usr/bin/xsltproc</userinput></screen>
 
@@ -96,22 +95,10 @@ meson --prefix=/usr                 \
     <variablelist>
       <title>The meaning of the meson options:</title>
 
-<!--
-      <varlistentry>
-        <term><parameter>-Dc_args=-Wno-format-overflow</parameter></term>
-        <listitem>
-          <para>The defaults flags passed to gcc contain
-          <parameter>-Werror=format-overflow</parameter>, which generates
-	  an error with GCC 10. Passing this parameter prevents the error
-	  from occuring.</para>
-        </listitem>
-      </varlistentry>
--->
-
       <varlistentry>
         <term><parameter>-D*-path=*</parameter></term>
         <listitem>
-          <para>These switches provide location of binaries needed by
+          <para>These switches provide the location of binaries needed by
           systemd at runtime that have not yet been installed.</para>
         </listitem>
       </varlistentry>
@@ -154,7 +141,7 @@ meson --prefix=/usr                 \
         <term><parameter>-Droot*</parameter></term>
         <listitem>
           <para>These switches ensure that core programs and
-          shared libraries are installed in the subdirectories
+          shared libraries are installed in subdirectories
           of the root partition.</para>
         </listitem>
       </varlistentry>
@@ -200,11 +187,7 @@ meson --prefix=/usr                 \
     <para>Compile the package:</para>
 
 <screen><userinput remap="make">LANG=en_US.UTF-8 ninja</userinput></screen>
-<!--
-    <para>To test the package, execute the following command:</para>
 
-<screen><userinput remap="test">LANG=en_US.UTF-8 ninja test</userinput></screen>
--->
     <para>Install the package:</para>
 
 <screen><userinput remap="install">LANG=en_US.UTF-8 ninja install</userinput></screen>
@@ -232,16 +215,8 @@ meson --prefix=/usr                 \
     <para>Prevent systemd from resetting the maximum PID value which causes
     some problems with packages and units in BLFS:</para>
     
-
 <screen><userinput remap="adjust">rm -f /usr/lib/sysctl.d/50-pid-max.conf</userinput></screen>
 
-    <!--
-    <para>Prevent systemd from creating <filename>/run/nologin</filename>
-    to allow unprivileged user logins without
-    <application>systemd-logind</application>:</para>
-
-<screen><userinput remap="adjust">rm -f /usr/lib/tmpfiles.d/systemd-nologin.conf</userinput></screen>
-    -->
   </sect2>
 
   <sect2 id="contents-systemd" role="content">
@@ -290,7 +265,7 @@ meson --prefix=/usr                 \
       <varlistentry id="bootctl">
         <term><command>bootctl</command></term>
         <listitem>
-          <para>Used to query the firmware and boot manager settings</para>
+          <para>Is used to query the firmware and boot manager settings</para>
           <indexterm zone="ch-system-systemd bootctl">
             <primary sortas="b-bootctl">bootctl</primary>
           </indexterm>
@@ -300,7 +275,7 @@ meson --prefix=/usr                 \
       <varlistentry id="busctl">
         <term><command>busctl</command></term>
         <listitem>
-          <para>Used to introspect and monitor the D-Bus bus</para>
+          <para>Is used to introspect and monitor the D-Bus bus</para>
           <indexterm zone="ch-system-systemd busctl">
             <primary sortas="b-busctl">busctl</primary>
           </indexterm>
@@ -310,7 +285,7 @@ meson --prefix=/usr                 \
       <varlistentry id="coredumpctl">
         <term><command>coredumpctl</command></term>
         <listitem>
-          <para>Used to retrieve coredumps from the systemd journal</para>
+          <para>Is used to retrieve coredumps from the systemd journal</para>
           <indexterm zone="ch-system-systemd coredumpctl">
             <primary sortas="b-coredumpctl">coredumpctl</primary>
           </indexterm>
@@ -334,7 +309,7 @@ meson --prefix=/usr                 \
       <varlistentry id="hostnamectl">
         <term><command>hostnamectl</command></term>
         <listitem>
-          <para>Used to query and change the system hostname and related
+          <para>Is used to query and change the system hostname and related
           settings</para>
           <indexterm zone="ch-system-systemd hostnamectl">
             <primary sortas="b-hostnamectl">hostnamectl</primary>
@@ -345,9 +320,10 @@ meson --prefix=/usr                 \
       <varlistentry id="init">
         <term><command>init</command></term>
         <listitem>
-          <para>The first process to be started when the kernel has initialized
+          <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</para>
+          processes according to its configuration files. In this case, it starts
+          systemd.</para>
           <indexterm zone="ch-system-systemd init">
             <primary sortas="b-init">init</primary>
           </indexterm>
@@ -357,7 +333,7 @@ meson --prefix=/usr                 \
       <varlistentry id="journalctl">
         <term><command>journalctl</command></term>
         <listitem>
-          <para>Used to query the contents of the systemd journal</para>
+          <para>Is used to query the contents of the systemd journal</para>
           <indexterm zone="ch-system-systemd journalctl">
             <primary sortas="b-journalctl">journalctl</primary>
           </indexterm>
@@ -367,8 +343,8 @@ meson --prefix=/usr                 \
       <varlistentry id="kernel-install">
         <term><command>kernel-install</command></term>
         <listitem>
-          <para>Used to add and remove kernel and initramfs images to and
-          from /boot</para>
+          <para>Is used to add and remove kernel and initramfs images to and
+          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>
@@ -378,7 +354,7 @@ meson --prefix=/usr                 \
       <varlistentry id="localectl">
         <term><command>localectl</command></term>
         <listitem>
-          <para>Used to query and change the system locale and keyboard layout
+          <para>Is used to query and change the system locale and keyboard layout
           settings</para>
           <indexterm zone="ch-system-systemd localectl">
             <primary sortas="b-localectl">localectl</primary>
@@ -389,7 +365,7 @@ meson --prefix=/usr                 \
       <varlistentry id="loginctl">
         <term><command>loginctl</command></term>
         <listitem>
-          <para>Used to introspect and control the state of the systemd Login
+          <para>Is used to introspect and control the state of the systemd Login
           Manager</para>
           <indexterm zone="ch-system-systemd loginctl">
             <primary sortas="b-loginctl">loginctl</primary>
@@ -400,7 +376,7 @@ meson --prefix=/usr                 \
       <varlistentry id="machinectl">
         <term><command>machinectl</command></term>
         <listitem>
-          <para>Used to introspect and control the state of the systemd Virtual
+          <para>Is used to introspect and control the state of the systemd Virtual
           Machine and Container Registration Manager</para>
           <indexterm zone="ch-system-systemd machinectl">
             <primary sortas="b-machinectl">machinectl</primary>
@@ -411,8 +387,8 @@ meson --prefix=/usr                 \
       <varlistentry id="networkctl">
         <term><command>networkctl</command></term>
         <listitem>
-          <para>Used to introspect the state of the network links as seen by
-          systemd-networkd</para>
+          <para>Is used to introspect and configure the state of the network 
+          links configured by systemd-networkd</para>
           <indexterm zone="ch-system-systemd networkctl">
             <primary sortas="b-networkctl">networkctl</primary>
           </indexterm>
@@ -422,7 +398,7 @@ meson --prefix=/usr                 \
       <varlistentry id="portablectl">
         <term><command>portablectl</command></term>
         <listitem>
-          <para>Used to attach or detach portable services from the local
+          <para>Is used to attach or detach portable services from the local
           system</para>
           <indexterm zone="ch-system-systemd portablectl">
             <primary sortas="b-portablectl">portablectl</primary>
@@ -433,7 +409,7 @@ meson --prefix=/usr                 \
       <varlistentry id="poweroff">
         <term><command>poweroff</command></term>
         <listitem>
-          <para>Tells the kernel to halt the system and switch off the computer
+          <para>Instructs the kernel to halt the system and switch off the computer
           (see <command>halt</command>)</para>
           <indexterm zone="ch-system-systemd poweroff">
             <primary sortas="b-poweroff">poweroff</primary>
@@ -444,7 +420,7 @@ meson --prefix=/usr                 \
       <varlistentry id="reboot">
         <term><command>reboot</command></term>
         <listitem>
-          <para>Tells the kernel to reboot the system (see
+          <para>Instructs the kernel to reboot the system (see
           <command>halt</command>)</para>
           <indexterm zone="ch-system-systemd reboot">
             <primary sortas="b-reboot">reboot</primary>
@@ -455,7 +431,7 @@ meson --prefix=/usr                 \
       <varlistentry id="resolvconf">
         <term><command>resolvconf</command></term>
         <listitem>
-          <para>Register DNS server and domain configuration with
+          <para>Registers DNS server and domain configuration with
           <command>systemd-resolved</command></para>
           <indexterm zone="ch-system-systemd resolvconf">
             <primary sortas="b-resolvconf">resolvconf</primary>
@@ -466,8 +442,8 @@ meson --prefix=/usr                 \
       <varlistentry id="resolvectl">
         <term><command>resolvectl</command></term>
         <listitem>
-          <para>Send control commands to the network name resolution
-          manager, or resolve domain names, IPv4 and IPv6 addresses,
+          <para>Sends control commands to the network name resolution
+          manager, or resolves domain names, IPv4 and IPv6 addresses,
           DNS records, and services.</para>
           <indexterm zone="ch-system-systemd resolvectl">
             <primary sortas="b-resolvectl">resolvectl</primary>
@@ -478,7 +454,7 @@ meson --prefix=/usr                 \
       <varlistentry id="runlevel">
         <term><command>runlevel</command></term>
         <listitem>
-          <para>Reports the previous and the current run-level, as noted in the
+          <para>Outputs the previous and the current run-level, as noted in the
           last run-level record in <filename>/var/run/utmp</filename></para>
           <indexterm zone="ch-system-systemd runlevel">
             <primary sortas="b-runlevel">runlevel</primary>
@@ -489,8 +465,8 @@ meson --prefix=/usr                 \
       <varlistentry id="shutdown">
         <term><command>shutdown</command></term>
         <listitem>
-          <para>Brings the system down in a secure way, signaling all processes
-          and notifying all logged-in users</para>
+          <para>Brings the system down in a safe and secure manner, signaling 
+          all processes and notifying all logged-in users</para>
           <indexterm zone="ch-system-systemd shutdown">
             <primary sortas="b-shutdown">shutdown</primary>
           </indexterm>
@@ -500,7 +476,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemctl">
         <term><command>systemctl</command></term>
         <listitem>
-          <para>Used to introspect and control the state of the systemd system
+          <para>Is used to introspect and control the state of the systemd system
           and service manager</para>
           <indexterm zone="ch-system-systemd systemctl">
             <primary sortas="b-systemctl">systemctl</primary>
@@ -511,8 +487,8 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-analyze">
         <term><command>systemd-analyze</command></term>
         <listitem>
-          <para>Used to determine system boot-up performance of the current
-          boot</para>
+          <para>Is used to determine system startup performance of the current
+          boot, as well as identify troublesome systemd units</para>
           <indexterm zone="ch-system-systemd systemd-analyze">
             <primary sortas="b-systemd-analyze">systemd-analyze</primary>
           </indexterm>
@@ -522,7 +498,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-ask-password">
         <term><command>systemd-ask-password</command></term>
         <listitem>
-          <para>Used to query a system password or passphrase from the user,
+          <para>Is used to query a system password or passphrase from the user,
           using a question message specified on the command line</para>
           <indexterm zone="ch-system-systemd systemd-ask-password">
             <primary sortas="b-systemd-ask-password">systemd-ask-password</primary>
@@ -533,7 +509,8 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-cat">
         <term><command>systemd-cat</command></term>
         <listitem>
-          <para>Used to connect STDOUT and STDERR of a process with the Journal
+          <para>Is used to connect the STDOUT and STDERR outputs of a process
+          with the systemd journal.
           </para>
           <indexterm zone="ch-system-systemd systemd-cat">
             <primary sortas="b-systemd-cat">systemd-cat</primary>
@@ -566,7 +543,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-delta">
         <term><command>systemd-delta</command></term>
         <listitem>
-          <para>Used to identify and compare configuration files in
+          <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>
           <indexterm zone="ch-system-systemd systemd-delta">
@@ -578,7 +555,8 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-detect-virt">
         <term><command>systemd-detect-virt</command></term>
         <listitem>
-          <para>Detects execution in a virtualized environment</para>
+          <para>Detects whether the system is being run in a virtual
+          environment, and adjusts udev accordingly.</para>
           <indexterm zone="ch-system-systemd systemd-detect-virt">
             <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary>
           </indexterm>
@@ -588,7 +566,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-escape">
         <term><command>systemd-escape</command></term>
         <listitem>
-          <para>Used to escape strings for inclusion in systemd unit
+          <para>Is used to escape strings for inclusion in systemd unit
           names</para>
           <indexterm zone="ch-system-systemd systemd-escape">
             <primary sortas="b-systemd-escape">systemd-escape</primary>
@@ -599,7 +577,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-hwdb">
         <term><command>systemd-hwdb</command></term>
         <listitem>
-          <para>Used to manage hardware database (hwdb)</para>
+          <para>Is used to manage the hardware database (hwdb)</para>
           <indexterm zone="ch-system-systemd systemd-hwdb">
             <primary sortas="b-systemd-hwdb">systemd-hwdb</primary>
           </indexterm>
@@ -609,7 +587,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-id128">
         <term><command>systemd-id128</command></term>
         <listitem>
-          <para>Generate and print id128 strings</para>
+          <para>Generates and prints id128 strings</para>
           <indexterm zone="ch-system-systemd systemd-id128">
             <primary sortas="b-systemd-id128">systemd-id128</primary>
           </indexterm>
@@ -619,8 +597,9 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-inhibit">
         <term><command>systemd-inhibit</command></term>
         <listitem>
-          <para>Used to execute a program with a shutdown, sleep or idle
-          inhibitor lock taken</para>
+          <para>Is used to execute a program with a shutdown, sleep or idle
+          inhibitor lock taken, preventing an action such as a system shutdown
+          until the process is completed.</para>
           <indexterm zone="ch-system-systemd systemd-inhibit">
             <primary sortas="b-systemd-inhibit">systemd-inhibit</primary>
           </indexterm>
@@ -630,7 +609,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-machine-id-setup">
         <term><command>systemd-machine-id-setup</command></term>
         <listitem>
-          <para>Used by system installer tools to initialize the machine ID
+          <para>Is used by system installer tools to initialize the machine ID
           stored in <filename>/etc/machine-id</filename> at install time with a
           randomly generated ID</para>
           <indexterm zone="ch-system-systemd systemd-machine-id-setup">
@@ -642,7 +621,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-mount">
         <term><command>systemd-mount</command></term>
         <listitem>
-          <para>A tool to temporarily mount or auto-mount a drive.</para>
+          <para>Is used to temporarily mount or automount disks.</para>
           <indexterm zone="ch-system-systemd systemd-mount">
             <primary sortas="b-systemd-mount">systemd-mount</primary>
           </indexterm>
@@ -652,7 +631,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-notify">
         <term><command>systemd-notify</command></term>
         <listitem>
-          <para>Used by daemon scripts to notify the init system about status
+          <para>Is used by daemon scripts to notify the init system about status
           changes</para>
           <indexterm zone="ch-system-systemd systemd-notify">
             <primary sortas="b-systemd-notify">systemd-notify</primary>
@@ -663,7 +642,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-nspawn">
         <term><command>systemd-nspawn</command></term>
         <listitem>
-          <para>Used to run a command or OS in a light-weight namespace
+          <para>Is used to run a command or OS in a light-weight namespace
           container</para>
           <indexterm zone="ch-system-systemd systemd-nspawn">
             <primary sortas="b-systemd-nspawn">systemd-nspawn</primary>
@@ -674,7 +653,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-path">
         <term><command>systemd-path</command></term>
         <listitem>
-          <para>Used to query system and user paths</para>
+          <para>Is used to query system and user paths</para>
           <indexterm zone="ch-system-systemd systemd-path">
             <primary sortas="b-systemd-path">systemd-path</primary>
           </indexterm>
@@ -684,7 +663,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-repart">
         <term><command>systemd-repart</command></term>
         <listitem>
-          <para>Used go grow and add partitions to a partition table when
+          <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>
           <indexterm zone="ch-system-systemd systemd-repart">
             <primary sortas="b-systemd-repart">systemd-repart</primary>
@@ -695,7 +674,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-resolve">
         <term><command>systemd-resolve</command></term>
         <listitem>
-          <para>Used to resolve domain names, IPV4 and IPv6 addresses, DNS
+          <para>Is used to resolve domain names, IPV4 and IPv6 addresses, DNS
           resource records, and services</para>
           <indexterm zone="ch-system-systemd systemd-resolve">
             <primary sortas="b-systemd-resolve">systemd-resolve</primary>
@@ -706,29 +685,20 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-run">
         <term><command>systemd-run</command></term>
         <listitem>
-          <para>Used to create and start a transient .service or a .scope unit
-          and run the specified command in it</para>
+          <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
+          validating systemd units.</para>
           <indexterm zone="ch-system-systemd systemd-run">
             <primary sortas="b-systemd-run">systemd-run</primary>
           </indexterm>
         </listitem>
       </varlistentry>
 
-      <!-- <varlistentry id="systemd-stdio-bridge">
-        <term><command>systemd-stdio-bridge</command></term>
-        <listitem>
-          <para>To be completed</para>
-          <indexterm zone="ch-system-systemd systemd-stdio-bridge">
-            <primary sortas="b-systemd-stdio-bridge">systemd-stdio-bridge</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry> -->
-
       <varlistentry id="systemd-socket-activate">
         <term><command>systemd-socket-activate</command></term>
         <listitem>
-          <para>A tool to listen on socket devices and launch a process upon
-          connection.</para>
+          <para>Is used to listen on socket devices and launch a process upon
+          a successful connection to the socket.</para>
           <indexterm zone="ch-system-systemd systemd-socket-activate">
             <primary sortas="b-systemd-socket-activate">systemd-socket-activate</primary>
           </indexterm>
@@ -751,7 +721,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-umount">
         <term><command>systemd-umount</command></term>
         <listitem>
-          <para>Unmount mount points</para>
+          <para>Unmounts mount points</para>
           <indexterm zone="ch-system-systemd systemd-umount">
             <primary sortas="b-systemd-umount">systemd-umount</primary>
           </indexterm>
@@ -761,7 +731,8 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-tty-ask-password-agent">
         <term><command>systemd-tty-ask-password-agent</command></term>
         <listitem>
-          <para>Used to list or process pending systemd password requests</para>
+          <para>Is used to list and/or process pending systemd password 
+          requests</para>
           <indexterm zone="ch-system-systemd systemd-tty-ask-password-agent">
             <primary sortas="b-systemd-tty-ask-password-agent">systemd-tty-ask-password-agent</primary>
           </indexterm>
@@ -782,7 +753,7 @@ meson --prefix=/usr                 \
       <varlistentry id="timedatectl">
         <term><command>timedatectl</command></term>
         <listitem>
-          <para>Used to query and change the system clock and its settings
+          <para>Is used to query and change the system clock and its settings
           </para>
           <indexterm zone="ch-system-systemd timedatectl">
             <primary sortas="b-timedatectl">timedatectl</primary>
@@ -793,10 +764,10 @@ meson --prefix=/usr                 \
       <varlistentry id="udevadm">
         <term><command>udevadm</command></term>
         <listitem>
-          <para>Generic udev administration tool: controls the udevd daemon,
-          provides info from the Udev database, monitors uevents, waits for
-          uevents to finish, tests udev configuration, and triggers uevents
-          for a given device</para>
+          <para>Is a generic udev administration tool which controls the udevd 
+          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">
             <primary sortas="b-udevadm">udevadm</primary>
           </indexterm>
@@ -806,7 +777,7 @@ meson --prefix=/usr                 \
       <varlistentry id="libsystemd">
         <term><filename class="libraryfile">libsystemd</filename></term>
         <listitem>
-          <para>The main systemd utility library</para>
+          <para>Is the main systemd utility library</para>
           <indexterm zone="ch-system-systemd libsystemd">
             <primary sortas="c-libsystemd">libsystemd</primary>
           </indexterm>
@@ -816,7 +787,7 @@ meson --prefix=/usr                 \
       <varlistentry id="libudev">
         <term><filename class="libraryfile">libudev</filename></term>
         <listitem>
-          <para>A library to access Udev device information</para>
+          <para>Is a library to access Udev device information</para>
           <indexterm zone="ch-system-systemd libudev">
             <primary sortas="c-libudev">libudev</primary>
           </indexterm>