Changeset a1a7f4f for prologue/typography.xml

Timestamp:

07/04/2005 09:32:47 PM (19 years ago)

Author:

Archaic <archaic@…>

Branches:

10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

afe7ecef

Parents:

ae31883

Message:

Brought (hopefully) all references of man/info pages into conformity. Updated typography to reflect this.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@6376 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:

• prologue/typography.xml (modified) (1 diff)

prologue/typography.xml

@@ -55 +55 @@
 as seen or copy-and-pasted.</para>
 
+<para><filename>passwd(5)</filename></para>
+
+<para>This format is used to refer to a specific manual page (hereinafter
+referred to simply as a <quote>man</quote> page). The number inside parentheses
+indicates a specific section inside of <command>man</command>. For example,
+<command>passwd</command> has two man pages. Per LFS installation instructions,
+those two man pages will be located at
+<filename>/usr/share/man/man1/passwd.1</filename> and
+<filename>/usr/share/man/man5/passwd.5</filename>. Both man pages have different
+information in them. When the book uses <filename>passwd(5)</filename> it is
+specifically referring to <filename>/usr/share/man/man5/passwd.5</filename>.
+<command>man passwd</command> will print the first man page it finds that
+matches <quote>passwd</quote>, which will be
+<filename>/usr/share/man/man1/passwd.1</filename>. For this example, you will
+need to run <command>man 5 passwd</command> in order to read the specific page
+being referred to. It should be noted that most man pages do not have duplicate
+page names in different sections. Therefore, <command>man <replaceable>[program
+name]</replaceable></command> is generally sufficient.</para>
+
 </sect1>