newxml/prologue/typography.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6 <sect1 id="pre-typography">
   7 <title>Typography</title>
   8 <?dbhtml filename="typography.html"?>
   9
  10 <para>To make things easier to follow, there are a few typographical
  11 conventions used throughout the book. Following are some examples:</para>
  12
  13 <screen><userinput>./configure --prefix=/usr</userinput></screen>
  14
  15 <blockquote><para>This form of text is designed to be typed exactly
  16 as seen unless otherwise noted in the surrounding text. It is also used
  17 in the explanation sections to identify which of the commands is being
  18 referenced.</para></blockquote>
  19
  20 <para><filename>install-info: unknown option
  21 `--dir-file=/mnt/lfs/usr/info/dir'</filename></para>
  22
  23 <blockquote><para>This form of text (fixed width text) is showing screen
  24 output, probably as the result of commands issued, and is also used to
  25 show filenames, such as <filename>/etc/ld.so.conf</filename>.</para></blockquote>
  26
  27 <para><emphasis>Emphasis</emphasis></para>
  28
  29 <blockquote><para>This form of text is used for several purposes in the
  30 book, mainly to emphasize important points, and to give examples of
  31 what to type.</para></blockquote>
  32
  33 <para><ulink url="&lfs-root;"/></para>
  34
  35 <blockquote><para>This form of text is used for hyperlinks, both within the
  36 book and to external pages such as HOWTOs, download locations and
  37 websites.</para></blockquote>
  38
  39 <screen><userinput>cat &gt; $LFS/etc/group &lt;&lt; "EOF"</userinput>
  40 root:x:0:
  41 bin:x:1:
  42 ......
  43 <userinput>EOF</userinput>
  44 </screen>
  45
  46 <blockquote><para>This type of section is used mainly when creating
  47 configuration files. The first command tells the system to create
  48 the file $LFS/etc/group from whatever is typed on the following lines until
  49 the sequence EOF is encountered. Therefore, this whole section is generally
  50 typed as seen.</para></blockquote>
  51
  52 </sect1>