diff options
Diffstat (limited to 'prologue/typography.xml')
| -rw-r--r-- | prologue/typography.xml | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/prologue/typography.xml b/prologue/typography.xml index 62b8ef9c9..13cc4d199 100644 --- a/prologue/typography.xml +++ b/prologue/typography.xml @@ -54,5 +54,24 @@ Therefore, this entire section is generally typed as seen.</para> <para>This format is used to encapsulate text that is not to be typed 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> |