diff options
Diffstat (limited to 'prologue/typography.xml')
| -rw-r--r-- | prologue/typography.xml | 102 |
1 files changed, 51 insertions, 51 deletions
diff --git a/prologue/typography.xml b/prologue/typography.xml index b101817fe..ddafff780 100644 --- a/prologue/typography.xml +++ b/prologue/typography.xml @@ -1,41 +1,41 @@ <?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> + <sect1 id="pre-typography"> -<title>Typography</title> -<?dbhtml filename="typography.html"?> + <?dbhtml filename="typography.html"?> + + <title>Typography</title> -<para>To make things easier to follow, there are a few typographical -conventions used throughout this book. This section contains some -examples of the typographical format found throughout Linux From -Scratch.</para> + <para>To make things easier to follow, there are a few typographical + conventions used throughout this book. This section contains some + examples of the typographical format found throughout Linux From + Scratch.</para> <screen role="nodump"><userinput>./configure --prefix=/usr</userinput></screen> -<para>This form of text is designed to be typed exactly as seen unless -otherwise noted in the surrounding text. It is also used in the -explanation sections to identify which of the commands is being -referenced.</para> + <para>This form of text is designed to be typed exactly as seen unless + otherwise noted in the surrounding text. It is also used in the explanation + sections to identify which of the commands is being referenced.</para> <screen><computeroutput>install-info: unknown option '--dir-file=/mnt/lfs/usr/info/dir'</computeroutput></screen> -<para>This form of text (fixed-width text) shows screen output, -probably as the result of commands issued. This format is also used -to show filenames, such as -<filename>/etc/ld.so.conf</filename>.</para> + <para>This form of text (fixed-width text) shows screen output, probably as + the result of commands issued. This format is also used to show filenames, + such as <filename>/etc/ld.so.conf</filename>.</para> -<para><emphasis>Emphasis</emphasis></para> + <para><emphasis>Emphasis</emphasis></para> -<para>This form of text is used for several purposes in the book. Its main -purpose is to emphasize important points or items.</para> + <para>This form of text is used for several purposes in the book. Its main + purpose is to emphasize important points or items.</para> -<para><ulink url="&lfs-root;"/></para> + <para><ulink url="&lfs-root;"/></para> -<para>This format is used for hyperlinks both within the LFS -community and to external pages. It includes HOWTOs, download locations, -and websites.</para> + <para>This format is used for hyperlinks both within the LFS community and to + external pages. It includes HOWTOs, download locations, and websites.</para> <screen role="nodump"><userinput>cat > $LFS/etc/group << "EOF" <literal>root:x:0: @@ -43,35 +43,35 @@ bin:x:1: ......</literal> EOF</userinput></screen> -<para>This format is used when creating configuration files. The first -command tells the system to create the file -<filename>$LFS/etc/group</filename> from whatever is typed on the -following lines until the sequence end of file (EOF) is encountered. -Therefore, this entire section is generally typed as seen.</para> - -<para><replaceable>[REPLACED TEXT]</replaceable></para> - -<para>This format is used to encapsulate text that is not to be typed -as seen or copied-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> + <para>This format is used when creating configuration files. The first command + tells the system to create the file <filename>$LFS/etc/group</filename> from + whatever is typed on the following lines until the sequence end of file (EOF) + is encountered. Therefore, this entire section is generally typed as + seen.</para> + + <para><replaceable>[REPLACED TEXT]</replaceable></para> + + <para>This format is used to encapsulate text that is not to be typed + as seen or copied-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> |