Changeset ee950a5e

Timestamp:

01/28/2024 12:53:47 PM (3 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.1, 12.1-rc1, multilib, trunk, xry111/arm64, xry111/clfs-ng, xry111/loongarch, xry111/loongarch-12.1, xry111/mips64el, xry111/update-glibc

Children:

5dd7073

Parents:

6ebb3b9

Message:

More <quote> clean up

Use <quote> instead of '"' if possible. Use <literal>,
<computeroutput>, etc. instead of <quote> if possible. Replace
<quote>alpha</quote> with a UTF-8 Greek alpha character.

BTW decorate ".link" with <filename class='extension'>.

Files:

• chapter02/hostreqs.xml (modified) (1 diff)
• chapter02/mounting.xml (modified) (1 diff)
• chapter07/python.xml (modified) (1 diff)
• chapter08/coreutils.xml (modified) (1 diff)
• chapter08/expect.xml (modified) (1 diff)
• chapter08/stripping.xml (modified) (1 diff)
• chapter09/networkd.xml (modified) (2 diffs)
• chapter09/usage.xml (modified) (1 diff)

chapter02/hostreqs.xml

@@ -30 +30 @@
     modern Linux distributions. Also note that many distributions will
     place software headers into separate packages, often in the form of
-    <quote>&lt;package-name&gt;-devel</quote> or
-    <quote>&lt;package-name&gt;-dev.</quote> Be sure to install those if
-    your distribution provides them.</para>
+    <literal><replaceable>&lt;package-name&gt;</replaceable>-devel</literal>
+    or
+    <literal><replaceable>&lt;package-name&gt;</replaceable>-dev</literal>.
+    Be sure to install those if your distribution provides them.</para>
 
    <para>Earlier versions of the listed software packages may work, but have

chapter02/mounting.xml

@@ -17 +17 @@
   </para>
   
-  <para>Strictly speaking, one cannot "mount a partition." One mounts the <emphasis>file
+  <para>Strictly speaking, one cannot <quote>mount a partition.</quote> One mounts the <emphasis>file
   system</emphasis> embedded in that partition. But since a single partition can't contain
   more than one file system, people often speak of the partition and the

chapter07/python.xml

@@ -85 +85 @@
         Some Python 3 modules can't be built now because the dependencies
         are not installed yet. For the <filename>ssl</filename> module,
-        a message <quote><computeroutput>Python requires a OpenSSL 1.1.1 or
-        newer</computeroutput></quote> is outputted.
+        a message <computeroutput>Python requires a OpenSSL 1.1.1 or
+        newer</computeroutput> is outputted.
         The message should be ignored.  Just make sure the toplevel
         <command>make</command> command has not failed.  The optional

chapter08/coreutils.xml

@@ -1262 +1262 @@
         <term><command>yes</command></term>
         <listitem>
-          <para>Repeatedly outputs <quote>y,</quote> or a given string, until
-          killed</para>
+          <para>Repeatedly outputs <literal>y</literal> or a given string,
+          until killed</para>
           <indexterm zone="ch-system-coreutils yes">
             <primary sortas="b-yes">yes</primary>

chapter08/expect.xml

@@ -93 +93 @@
 
     <para>If any test fails with the message
-    <quote><computeroutput>The system has no more ptys. Ask your system
-    administrator to create more</computeroutput>,</quote> it indicates
+    <computeroutput>The system has no more ptys. Ask your system
+    administrator to create more</computeroutput>, it indicates
     you've not mounted the
     <systemitem class="filesystem">devpts</systemitem> file system

chapter08/stripping.xml

@@ -53 +53 @@
   and ld-linux.so.2 on 32-bit systems.  The construct below selects the
   correct name for the current architecture, excluding anything ending
-  with <quote>g,</quote> in case the commands below have already been
+  with <literal>g</literal>, in case the commands below have already been
   run.</para></note>
 

chapter09/networkd.xml

@@ -92 +92 @@
         <listitem>
           <para>
-            Mask udev's .link file for the default policy:
+            Mask udev's <filename class='extension'>.link</filename> file
+            for the default policy:
 <screen role="nodump"><userinput>ln -s /dev/null /etc/systemd/network/99-default.link</userinput></screen>
           </para>
@@ -102 +103 @@
             interfaces something like <literal>internet0</literal>,
             <literal>dmz0</literal>, or <literal>lan0</literal>.
-            To do that, create .link files in /etc/systemd/network/ that
-            select an explicit name or a better naming scheme for your
-            network interfaces. For example:
+            To do that, create <filename class='extension'>.link</filename>
+            files in /etc/systemd/network/ that select an explicit name or a
+            better naming scheme for your network interfaces. For example:
           </para>
 

chapter09/usage.xml

@@ -527 +527 @@
       characters, or two ASCII characters are composed together. However, in
       UTF-8 mode it is a problem; e.g., for the Greek language, where one
-      sometimes needs to put an accent on the letter <quote>alpha.</quote>
+      sometimes needs to put an accent on the letter α.
       The solution is either to avoid the use of UTF-8, or to install the
       X window system, which doesn't have this limitation, in its input