Changeset 37428334 for prologue

Timestamp:

07/04/2005 10:03:52 PM (19 years ago)

Author:

Archaic <archaic@…>

Branches:

6.1, 6.1.1

Children:

a998246

Parents:

5707154

Message:

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

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

File:

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

prologue/typography.xml

@@ -55 +55 @@
 as seen<phrase condition="html"> or copy-and-pasted</phrase>.</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>