Style and text fixes for the Typesetting chapter

6 files changed, 48 insertions, 46 deletions

diff --git a/pst/typesetting/asymptote.xml b/pst/typesetting/asymptote.xml
index 4ff6517828..7f887d82b0 100644
--- a/pst/typesetting/asymptote.xml
+++ b/pst/typesetting/asymptote.xml
@@ -31,7 +31,7 @@
       <application>Asymptote</application> is a powerful descriptive vector
       graphics language that provides a natural coordinate-based framework for
       technical drawing. Labels and equations can be typeset with LaTeX.  As
-      well as EPS, PDF and PNG output it can produce WebGL 3D HTML rendering
+      well as EPS, PDF, and PNG output, it can produce WebGL 3D HTML rendering
       and (using <application>dvisvgm</application>) SVG output.
     </para>
 
@@ -207,7 +207,7 @@ make</userinput></screen>
      <para>
        <parameter>--disable-lsp</parameter>: The Language Server Protocol is
        enabled by default, with several third-party sources included, but it
-       does not build unless boost and repidjson have been installed.
+       does not build unless boost and rapidjson have been installed.
      </para>
 
     <para>
diff --git a/pst/typesetting/biber.xml b/pst/typesetting/biber.xml
index 39a2ba4cdc..13f718570b 100644
--- a/pst/typesetting/biber.xml
+++ b/pst/typesetting/biber.xml
@@ -141,7 +141,8 @@
          biber requires a newer biblatex.  -->
 
   <!-- FIXME - ok to comment biblatex when version for a new year matches
-   what is in texmf-dist. For new version, reinstate to avoid runtime error.-->
+    what is in texmf-dist. For new version, reinstate to avoid runtime error.-->
+    <!--
     <bridgehead renderas="sect3">Required Additional Download</bridgehead>
 
     <itemizedlist spacing="compact">
@@ -161,60 +162,61 @@
         </para>
       </listitem>
     </itemizedlist>
+    -->
 
     <bridgehead renderas="sect3">Biber Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
       <!-- KFM: the order listed in Build.PL is not alphabetical -->
-      <xref linkend="perl-autovivification"/>
-      <xref linkend="perl-business-isbn"/>
-      <xref linkend="perl-business-ismn"/>
-      <xref linkend="perl-business-issn"/>
-      <xref linkend="perl-class-accessor"/>
-      <xref linkend="perl-data-compare"/>
-      <xref linkend="perl-data-dump"/>
-      <xref linkend="perl-data-uniqid"/>
-      <xref linkend="perl-datetime-calendar-julian"/>
-      <xref linkend="perl-datetime-format-builder"/>
-      <xref linkend="perl-encode-eucjpascii"/>
-      <xref linkend="perl-encode-hanextra"/>
-      <xref linkend="perl-encode-jis2k"/>
-      <xref linkend="perl-file-slurper"/>
-      <xref linkend="perl-io-string"/>
+      <xref linkend="perl-autovivification"/>,
+      <xref linkend="perl-business-isbn"/>,
+      <xref linkend="perl-business-ismn"/>,
+      <xref linkend="perl-business-issn"/>,
+      <xref linkend="perl-class-accessor"/>,
+      <xref linkend="perl-data-compare"/>,
+      <xref linkend="perl-data-dump"/>,
+      <xref linkend="perl-data-uniqid"/>,
+      <xref linkend="perl-datetime-calendar-julian"/>,
+      <xref linkend="perl-datetime-format-builder"/>,
+      <xref linkend="perl-encode-eucjpascii"/>,
+      <xref linkend="perl-encode-hanextra"/>,
+      <xref linkend="perl-encode-jis2k"/>,
+      <xref linkend="perl-file-slurper"/>,
+      <xref linkend="perl-io-string"/>,
       <!-- IPC::Cmd is a part of core perl -->
-      <xref linkend="perl-ipc-run3"/>
-      <xref linkend="perl-lingua-translit"/>
-      <xref linkend="perl-list-allutils"/>
-      <xref linkend="perl-list-moreutils"/>
+      <xref linkend="perl-ipc-run3"/>,
+      <xref linkend="perl-lingua-translit"/>,
+      <xref linkend="perl-list-allutils"/>,
+      <xref linkend="perl-list-moreutils"/>,
       <!-- perl-list-moreutils-xs is a dep of perl-list-moreutils -->
-      <xref linkend="perl-log-log4perl"/>
-      <xref linkend="perl-lwp-protocol-https"/>
+      <xref linkend="perl-log-log4perl"/>,
+      <xref linkend="perl-lwp-protocol-https"/>,
       <!-- LWP::Simple dep for this protocol is part of perl-libwww-perl,
       that is pulled in by perl-lwp-protocol-https and that pulls in
       perl-uri. Biber lists LWP::UserAgent as a dep, again it is part
       of perl-libwww-perl. -->
-      <xref linkend="perl-module-build"/>
-      <xref linkend="perl-parse-recdescent"/>
-      <xref linkend="perl-perlio-utf8_strict"/>
+      <xref linkend="perl-module-build"/>,
+      <xref linkend="perl-parse-recdescent"/>,
+      <xref linkend="perl-perlio-utf8_strict"/>,
       <!-- Mozilla::CA should not be needed when using system certificates -->
-      <xref linkend="perl-regexp-common"/>
-      <xref linkend="perl-sort-key"/>
-      <xref linkend="perl-text-bibtex"/>
-      <xref linkend="perl-text-csv"/>
+      <xref linkend="perl-regexp-common"/>,
+      <xref linkend="perl-sort-key"/>,
+      <xref linkend="perl-text-bibtex"/>,
+      <xref linkend="perl-text-csv"/>,
       <!-- perl-text-csv_xs is a recommended dependency for perl-text-csv -->
-      <xref linkend="perl-text-roman"/>
+      <xref linkend="perl-text-roman"/>,
       <!-- Unicode-Collate usually needs to be latest when biber is released,
         core perl is usually older. To read the core version, look at
         /usr/lib/perl5/5.xx.y/x86_64-linux-thread-multi/Unicode/Collate.pm -->
-      <xref linkend="perl-unicode-collate"/>
+      <xref linkend="perl-unicode-collate"/>,
       <!-- Unicode::GCstring is part of Unicode::LineBreak -->
-      <xref linkend="perl-unicode-linebreak"/>
+      <xref linkend="perl-unicode-linebreak"/>,
       <!-- Unicode::Normalize is part of core perl, found in
         /usr/lib/perl5/5.xx.y/x86_64-linux-thread-multi/Unicode/Normalize.pm -->
       <!-- perl-xml-libxml is a dependency of perl-xml-libxml-simple -->
-      <xref linkend="perl-xml-libxml-simple"/>
-      <xref linkend="perl-xml-libxslt"/>
+      <xref linkend="perl-xml-libxml-simple"/>,
+      <xref linkend="perl-xml-libxslt"/>, and
       <xref linkend="perl-xml-writer"/>
       <!-- untarring biblatex requires that the texmf directories already exist -->
       <!--
diff --git a/pst/typesetting/dvisvgm.xml b/pst/typesetting/dvisvgm.xml
index 30d8a2303a..b5578f94bc 100644
--- a/pst/typesetting/dvisvgm.xml
+++ b/pst/typesetting/dvisvgm.xml
@@ -92,7 +92,7 @@
     <para role="optional">
       <xref linkend="asciidoc"/> with
       <xref linkend="xmlto"/> and
-      <xref linkend="libxslt"/> (see command explanations),
+      <xref linkend="libxslt"/>,
       <ulink url="https://dblatex.sourceforge.net/">dblatex</ulink> (with the above) and
       <!-- version checked for dvisvgm-2.9, 0.7.3 is mentioned in the
            news and is the latest version at 2020-03-21
diff --git a/pst/typesetting/texlive.xml b/pst/typesetting/texlive.xml
index 7a3ec3e246..aadc12ca43 100644
--- a/pst/typesetting/texlive.xml
+++ b/pst/typesetting/texlive.xml
@@ -137,14 +137,14 @@ and it might have been removed by next year. -->
         fonts, and various other files) is not part of the source tarball.
         You must download it separately. This will give you all of the
         additional files which are provided by a full install of the binary
-        version, there is no realistic way to restrict which parts get
+        version, as there is no realistic way to restrict which parts get
         installed.
       </para>
 
       <para>
         Because of the size of this package, it is unlikely to be mirrored by
-        BLFS mirrors.  In case of difficulty, go to http://www.ctan.org/mirrors/
-        to find a more-accessible mirror.
+        BLFS mirrors. If you are unable to download the files for this package,
+        go to https://www.ctan.org/mirrors/ to find a more-accessible mirror.
       </para>
 
     <itemizedlist spacing="compact">
@@ -263,7 +263,7 @@ and it might have been removed by next year. -->
       <para>
         A successful install requires some texlive
         commands to be run as the root user, so we will export the TEXARCH
-        variable to let <systemitem class="username">root</systemitem> use it.
+        variable to let &root; use it.
       </para>
     </note>
 
@@ -409,7 +409,7 @@ fmtutil-sys --all</userinput></screen>
     <title>Command Explanations</title>
 
     <para>
-      <command>-C</command>: create config.cache, this saves significant
+      <command>-C</command>: creates config.cache, which saves significant
       time in a parallel build.
     </para>
 
diff --git a/pst/typesetting/tl-installer.xml b/pst/typesetting/tl-installer.xml
index c4c72a8689..1749fa9a14 100644
--- a/pst/typesetting/tl-installer.xml
+++ b/pst/typesetting/tl-installer.xml
@@ -218,8 +218,8 @@ and it might have been removed by next year. -->
        texlive list, at least ls-R was involved and maybe other files,
        suggestion was to remove, chown prefix, reinstall. --> If any later
        change in that directory is made by the <systemitem
-       class="username">root</systemitem> user <emphasis>that will change the
-       ownership</emphasis> which breaks usage by normal users.
+       class="username">root</systemitem> user, <emphasis>that will change the
+       ownership</emphasis>, which breaks usage by normal users.
      </para>
     </note>
 
diff --git a/pst/typesetting/typesetting.xml b/pst/typesetting/typesetting.xml
index c15fe2a34c..fa9ad9c797 100644
--- a/pst/typesetting/typesetting.xml
+++ b/pst/typesetting/typesetting.xml
@@ -42,8 +42,8 @@
     <application>texlive</application>, together with <emphasis>all</emphasis>
     of the supporting files. This almost-complete install can then be used
     to build the remaining parts of <application>texlive</application>:
-    <xref linkend="asymptote"/>, <xref linkend="biber"/> and <xref
-    linkend="xindy"/>.
+    <xref linkend="asymptote"/>, <xref linkend="biber"/>,
+    <xref linkend="dvisvgm"/>, and <xref linkend="xindy"/>.
   </para>
 
   <para>