Changeset 811d59db

Timestamp:

01/11/2024 12:52:28 PM (4 months ago)

Author:

Pierre Labastie <pierre.labastie@…>

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:

ce07f91d, e97d787

Parents:

f1370e2

Message:

Nitpick on format

• according to our typography, referring to a manual page should be <filename>page(x)</filename>
• don't enclose punctuation into quotes
• use <option> for option

Files:

• chapter04/settingenviron.xml (modified) (1 diff)
• chapter07/creatingdirs.xml (modified) (1 diff)
• chapter08/openssl.xml (modified) (2 diffs)
• chapter09/networkd.xml (modified) (2 diffs)
• chapter10/fstab.xml (modified) (1 diff)

chapter04/settingenviron.xml

@@ -80 +80 @@
   created files and directories are only writable by their owner, but are
   readable and executable by anyone (assuming default modes are used by the
-  <function>open(2)</function> system call, new files will end up with permission
-  mode 644 and directories with mode 755).</para>
+  <filename>open(2)</filename> system call, new files will end up with
+  permission mode 644 and directories with mode 755).</para>
       </listitem>
     </varlistentry>

chapter07/creatingdirs.xml

@@ -55 +55 @@
   class="directory">/var/tmp</filename> directories, but cannot remove
   another user's files from them. The latter is prohibited by the so-called
-  <quote>sticky bit,</quote> the highest bit (1) in the 1777 bit mask.</para>
+  <quote>sticky bit</quote>, the highest bit (1) in the 1777 bit mask.</para>
 
   <sect2>

chapter08/openssl.xml

@@ -164 +164 @@
             of <application>OpenSSL</application>'s crypto library from the
             shell. It can be used for various functions which are documented in
-            <command>man 1 openssl</command>
+            <filename>openssl(1)</filename>
           </para>
           <indexterm zone="ch-system-openssl openssl-prog">
@@ -196 +196 @@
             implements the Transport Layer Security (TLS v1) protocol.
             It provides a rich API, documentation
-            on which can be found by running <command>man 7 ssl</command>
+            on which can be found in <filename>ssl(7)</filename>
           </para>
           <indexterm zone="ch-system-openssl libssl">

chapter09/networkd.xml

@@ -114 +114 @@
 
           <para>
-             See the man page systemd.link(5) for more information.
+            See <filename>systemd.link(5)</filename> for more information.
           </para>
         </listitem>
@@ -120 +120 @@
         <listitem>
           <para>
-            In /boot/grub/grub.cfg, pass the option net.ifnames=0 on the
-            kernel command line.
+            In /boot/grub/grub.cfg, pass the option
+            <option>net.ifnames=0</option> on the kernel command line.
           </para>
         </listitem>

chapter10/fstab.xml

@@ -57 +57 @@
   class="partition">sda5</filename>, and <systemitem
   class="filesystem">ext4</systemitem>. For details on the six
-  fields in this file, see <command>man 5 fstab</command>.</para>
+  fields in this file, see <filename>fstab(5)</filename>.</para>
 
   <para>Filesystems with MS-DOS or Windows origin (i.e. vfat, ntfs, smbfs,