Index: kde/kf5/kf5-frameworks.xml
===================================================================
--- kde/kf5/kf5-frameworks.xml	(revision 6b705bd90f0706c43ce34ee3c2fa87e43fea4f3b)
+++ kde/kf5/kf5-frameworks.xml	(revision 1c8c15ce9e8f47c495740050b181f29a1526bd90)
@@ -28,32 +28,48 @@
   </indexterm>
 
-  <para>KDE Frameworks 5 is a collection of libraries based on top of Qt5 and
-  QML derived from the monolithic KDE 4 libraries. They can be used
-  independent of the KDE Display Environment (Plasma 5).</para>
+  <para>
+    KDE Frameworks 5 is a collection of libraries based on top of Qt5 and
+    QML derived from the monolithic KDE 4 libraries. They can be used
+    independent of the KDE Display Environment (Plasma 5).
+  </para>
 
   &lfs91_checked;
 
-  <para>The instructions below build all of the KDE Frameworks packages in one
-  step by using a bash script.  </para>
+  <para>
+    The instructions below build all of the KDE Frameworks packages in one
+    step by using a bash script.
+  </para>
 
   <bridgehead renderas="sect3">Package Information</bridgehead>
   <itemizedlist spacing="compact">
     <listitem>
-      <para>Download (HTTP): <ulink url="&kf5-download-http;"/></para>
+      <para>
+        Download (HTTP): <ulink url="&kf5-download-http;"/>
+      </para>
     </listitem>
     <listitem>
-      <para>Download (FTP): <ulink url="&kf5-download-ftp;"/></para>
+      <para>
+        Download (FTP): <ulink url="&kf5-download-ftp;"/>
+      </para>
     </listitem>
     <listitem>
-      <para>Download MD5 sum: &kf5-md5sum;</para>
+      <para>
+        Download MD5 sum: &kf5-md5sum;
+      </para>
     </listitem>
     <listitem>
-      <para>Download size: &kf5-size;</para>
+      <para>
+        Download size: &kf5-size;
+      </para>
     </listitem>
     <listitem>
-      <para>Estimated disk space required: &kf5-buildsize;</para>
+      <para>
+        Estimated disk space required: &kf5-buildsize;
+      </para>
     </listitem>
     <listitem>
-      <para>Estimated build time: &kf5-time;</para>
+      <para>
+        Estimated build time: &kf5-time;
+      </para>
     </listitem>
   </itemizedlist>
@@ -266,14 +282,16 @@
 EOF</userinput></screen>
 
-  <para>In the above list, notice that some files have been commented out with
-  a hash (#) character. The extra-cmake-modules entry has been commented out
-  because it was built earlier in the <xref linkend="kde-prereq"/>. The icon
-  packages are covered separately at <xref linkend="breeze-icons"/> and <xref
-  linkend="oxygen-icons5"/>.  The modemmanager-qt package may be built if its
-  optional dependency has been installed. The prison package (bar code reader)
-  may be built if the required external libraries are installed. The kdewebkit
-  may be built if the external package 
-  <ulink url="https://download.qt.io/community_releases/5.9/5.9.0-final/">
-  QtWebkit</ulink> has been built. </para>
+  <para>
+    In the above list, notice that some files have been commented out with
+    a hash (#) character. The extra-cmake-modules entry has been commented out
+    because it was built earlier in the <xref linkend="kde-prereq"/>. The icon
+    packages are covered separately at <xref linkend="breeze-icons"/> and <xref
+    linkend="oxygen-icons5"/>.  The modemmanager-qt package may be built if its
+    optional dependency has been installed. The prison package (bar code reader)
+    may be built if the required external libraries are installed. The
+    kdewebkit may be built if the external package 
+    <ulink url="https://download.qt.io/community_releases/5.9/5.9.0-final/">
+    QtWebkit</ulink> has been built.
+  </para>
 
   </sect2>
@@ -286,7 +304,10 @@
     <caution>
 
-      <para>If installing in /opt and there is an existing /opt/kf5 either as a
-      regular directory or a symbolic link, it should be reinitialized (as
-      root):</para>
+      <para>
+        If installing in <filename class="directory">/opt</filename> and there
+        is an existing /opt/kf5 either as a regular directory or a symbolic
+        link, it should be reinitialized (as <systemitem class="username">
+        root</systemitem>):
+      </para>
 
       <screen role="root"><userinput>mv -v /opt/kf5 /opt/kf5.old                         &amp;&amp;
@@ -355,11 +376,17 @@
 exit</userinput></screen>
 
-    <note><para>Any modules that have been omitted can be installed later by
-    using the same mkdir build; cd build; cmake; make; make install procedure
-    as above.</para></note>
-
-    <para>Sometimes the installation paths are hardcoded into installed files.
-    If the installed directory is not /usr, rename the directory and create a
-    symlink:</para>
+    <note>
+      <para>
+        Any modules that have been omitted can be installed later by
+        using the same <command>mkdir build; cd build; cmake; make;
+        make install</command> procedure as above.
+      </para>
+    </note>
+
+    <para>
+      Sometimes the installation paths are hardcoded into installed files.
+      If the installed directory is not /usr, rename the directory and create a
+      symlink:
+    </para>
 
     <screen role="root"><userinput>mv -v /opt/kf5 /opt/kf5-&kf5-version;
Index: kde/kf5/kf5-intro.xml
===================================================================
--- kde/kf5/kf5-intro.xml	(revision 6b705bd90f0706c43ce34ee3c2fa87e43fea4f3b)
+++ kde/kf5/kf5-intro.xml	(revision 1c8c15ce9e8f47c495740050b181f29a1526bd90)
@@ -27,6 +27,8 @@
   </indexterm>
 
-  <para>KF5 can be installed in /usr or /opt/kf5.  The BLFS editors
-  recommend the latter in the BLFS environment.
+  <para>
+    KF5 can be installed in <filename class="directory">/usr</filename> or
+    <filename class="directory">/opt/kf5</filename>. The BLFS editors
+    recommend the latter in the BLFS environment.
   </para>
 
@@ -68,11 +70,19 @@
 EOF</userinput></screen>
 
-    <note><para>If <application>qt5</application> was installed in /usr, the
-    $QT5DIR/lib/ portions of the above paths may need to be changed to
-    $QT5DIR/lib/qt5/.</para></note>
-
-    <para>Additionally, if <xref linkend="sudo"/> is installed, these variables
-    should be available to the super user. Execute the following commands as
-    the <systemitem class="username">root</systemitem> user:</para>
+    <note>
+      <para>
+        If <application>qt5</application> was installed in <filename
+        class="directory">/usr</filename>, the <filename
+        class="directory">$QT5DIR/lib/</filename> portions of the above paths
+        may need to be changed to <filename
+        class="directory">$QT5DIR/lib/qt5/</filename>.
+      </para>
+    </note>
+
+    <para>
+      Additionally, if <xref linkend="sudo"/> is installed, these variables
+      should be available to the super user. Execute the following commands as
+      the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>cat &gt;&gt; /etc/sudoers.d/qt &lt;&lt; "EOF"
