diff options
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml')
| -rw-r--r-- | en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml | 127 |
1 files changed, 64 insertions, 63 deletions
diff --git a/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml index 6b8e33ef14..7f6782f9dc 100644 --- a/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml @@ -1,3 +1,4 @@ +<?xml version="1.0" encoding="ISO8859-1" standalone="no"?> <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved. Redistribution and use in source (SGML DocBook) and 'compiled' forms @@ -151,7 +152,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<h1>First section</h1> + <programlisting><![CDATA[<h1>First section</h1> <!-- Document introduction goes here --> @@ -184,7 +185,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<h1>First section</h1> + <programlisting><![CDATA[<h1>First section</h1> <!-- Document introduction --> @@ -205,7 +206,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>This is a paragraph. It can contain just about any + <programlisting><![CDATA[<p>This is a paragraph. It can contain just about any other element.</p>]]></programlisting> </example> </sect3> @@ -222,7 +223,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>A small excerpt from the US Constitution:</p> + <programlisting><![CDATA[<p>A small excerpt from the US Constitution:</p> <blockquote>We the People of the United States, in Order to form a more perfect Union, establish Justice, insure domestic @@ -268,7 +269,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>An unordered list. Listitems will probably be + <programlisting><![CDATA[<p>An unordered list. Listitems will probably be preceded by bullets.</p> <ul> @@ -300,7 +301,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<dl> + <programlisting><![CDATA[<dl> <dt>Term 1</dt> <dd><p>Paragraph 1 of definition 1.</p> @@ -336,7 +337,7 @@ <para>You could use <sgmltag>pre</sgmltag> to mark up an email message:</para> - <programlisting><![ CDATA [<pre> From: nik@FreeBSD.org + <programlisting><![CDATA[<pre> From: nik@FreeBSD.org To: freebsd-doc@FreeBSD.org Subject: New documentation available @@ -387,7 +388,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>This is a simple 2x2 table.</p> + <programlisting><![CDATA[<p>This is a simple 2x2 table.</p> <table> <tr> @@ -414,7 +415,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>One tall thin cell on the left, two short cells next to + <programlisting><![CDATA[<p>One tall thin cell on the left, two short cells next to it on the right.</p> <table> @@ -435,7 +436,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>One long cell on top, two short cells below it.</p> + <programlisting><![CDATA[<p>One long cell on top, two short cells below it.</p> <table> <tr> @@ -456,7 +457,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>On a 3x3 grid, the top left block is a 2x2 set of + <programlisting><![CDATA[<p>On a 3x3 grid, the top left block is a 2x2 set of cells merged into one. The other cells are normal.</p> <table> @@ -509,7 +510,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p><em>This</em> has been emphasized, while + <programlisting><![CDATA[<p><em>This</em> has been emphasized, while <strong>this</strong> has been strongly emphasized.</p>]]></programlisting> </example> </sect3> @@ -525,7 +526,7 @@ <example> <title><sgmltag>b</sgmltag> and <sgmltag>i</sgmltag></title> - <programlisting><![ CDATA [<p><b>This</b> is in bold, while <i>this</i> is + <programlisting><![CDATA[<p><b>This</b> is in bold, while <i>this</i> is in italics.</p>]]></programlisting> </example> </sect3> @@ -542,7 +543,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>This document was originally written by + <programlisting><![CDATA[<p>This document was originally written by Nik Clayton, who can be reached by email as <tt>nik@FreeBSD.org</tt>.</p>]]></programlisting> </example> @@ -589,7 +590,7 @@ <para>The following fragments all do the same thing.</para> - <programlisting><![ CDATA [<p>This text is <small>slightly smaller</small>. But + <programlisting><![CDATA[<p>This text is <small>slightly smaller</small>. But this text is <big>slightly bigger</big>.</p> <p>This text is <font size="-1">slightly smaller</font>. But @@ -627,7 +628,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p>More information is available at the + <programlisting><![CDATA[<p>More information is available at the <a href="http://www.FreeBSD.org/">FreeBSD web site</a>.</p>]]></programlisting> </example> @@ -651,7 +652,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<p><a name="para1">This</a> paragraph can be referenced + <programlisting><![CDATA[<p><a name="para1">This</a> paragraph can be referenced in other links with the name <tt>para1</tt>.</p>]]></programlisting> </example> @@ -666,7 +667,7 @@ resides in a document called <filename>foo.html</filename>.</para> - <programlisting><![ CDATA [<p>More information can be found in the + <programlisting><![CDATA[<p>More information can be found in the <a href="foo.html#para1">first paragraph</a> of <tt>foo.html</tt>.</p>]]></programlisting> </example> @@ -682,7 +683,7 @@ <para>Assume that the <literal>para1</literal> example resides in this document:</para> - <programlisting><![ CDATA [<p>More information can be found in the + <programlisting><![CDATA[<p>More information can be found in the <a href="#para1">first paragraph</a> of this document.</p>]]></programlisting> </example> @@ -919,7 +920,7 @@ <example> <title>A Simple Chapter</title> - <programlisting><![ CDATA [<chapter> + <programlisting><![CDATA[<chapter> <title>The Chapter's Title</title> ... @@ -934,7 +935,7 @@ <example> <title>Empty Chapters</title> - <programlisting><![ CDATA [<chapter> + <programlisting><![CDATA[<chapter> <title>This is An Empty Chapter</title> <para></para> @@ -963,7 +964,7 @@ <example> <title>Sections in Chapters</title> - <programlisting><![ RCDATA [<chapter> + <programlisting><![CDATA[<chapter> <title>A Sample Chapter</title> <para>Some text in the chapter.</para> @@ -1014,7 +1015,7 @@ one or more <sgmltag>part</sgmltag>s. This cannot be done in an <sgmltag>article</sgmltag>.</para> - <programlisting><![ CDATA [<part> + <programlisting><![CDATA[<part> <title>Introduction</title> <chapter> @@ -1060,7 +1061,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<para>This is a paragraph. It can contain just about any + <programlisting><![CDATA[<para>This is a paragraph. It can contain just about any other element.</para> ]]></programlisting> <para>Appearance:</para> @@ -1087,7 +1088,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<para>A small excerpt from the US Constitution:</para> + <programlisting><![CDATA[<para>A small excerpt from the US Constitution:</para> <blockquote> <title>Preamble to the Constitution of the United States</title> @@ -1169,7 +1170,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<warning> + <programlisting><![CDATA[<warning> <para>Installing FreeBSD may make you want to delete Windows from your hard disk.</para> </warning>]]></programlisting> @@ -1221,7 +1222,7 @@ <para>Use:</para> - <programlisting><![ CDATA [<itemizedlist> + <programlisting><![CDATA[<itemizedlist> <listitem> <para>This is the first itemized item.</para> </listitem> @@ -1315,7 +1316,7 @@ <para>Use:</para> - <programlisting><![ CDATA[<para>When you have finished, your program should look like + <programlisting><![CDATA[<para>When you have finished, your program should look like this:</para> <programlisting>#include <stdio.h> @@ -1365,15 +1366,15 @@ main(void) <title><sgmltag>co</sgmltag> and <sgmltag>calloutlist</sgmltag></title> - <programlisting><![ CDATA[<para>When you have finished, your program should look like + <programlisting><![CDATA[<para>When you have finished, your program should look like this:</para> -<programlisting>#include <stdio.h> <co id="co-ex-include"> +<programlisting>#include <stdio.h> <co id="co-ex-include"/> -int <co id="co-ex-return"> +int <co id="co-ex-return"/> main(void) { - printf("hello, world\n"); <co id="co-ex-printf"> + printf("hello, world\n"); <co id="co-ex-printf"/> }</programlisting> <calloutlist> @@ -1397,12 +1398,12 @@ main(void) <para>When you have finished, your program should look like this:</para> - <programlisting>#include <stdio.h> <co id="co-ex-include"> + <programlisting>#include <stdio.h> <co id="co-ex-include"/> -int <co id="co-ex-return"> +int <co id="co-ex-return"/> main(void) { - printf("hello, world\n"); <co id="co-ex-printf"> + printf("hello, world\n"); <co id="co-ex-printf"/> }</programlisting> <calloutlist> @@ -1453,7 +1454,7 @@ main(void) <para>Use:</para> - <programlisting><![ CDATA [<informaltable pgwide="1"> + <programlisting><![CDATA[<informaltable pgwide="1"> <tgroup cols="2"> <thead> <row> @@ -1617,7 +1618,7 @@ main(void) <para>Use:</para> - <programlisting><![ CDATA [<screen>&prompt.user; <userinput>ls -1</userinput> + <programlisting><![CDATA[<screen>&prompt.user; <userinput>ls -1</userinput> foo1 foo2 foo3 @@ -1675,7 +1676,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>FreeBSD is without doubt <emphasis>the</emphasis> + <programlisting><![CDATA[<para>FreeBSD is without doubt <emphasis>the</emphasis> premiere Unix like operating system for the Intel architecture.</para>]]></programlisting> <para>Appearance:</para> @@ -1700,7 +1701,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>However, make sure that the search does not go beyond the + <programlisting><![CDATA[<para>However, make sure that the search does not go beyond the <quote>boundary between local and public administration</quote>, as RFC 1535 calls it.</para>]]></programlisting> @@ -1738,7 +1739,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>To switch to the second virtual terminal, press + <programlisting><![CDATA[<para>To switch to the second virtual terminal, press <keycombo action="simul"><keycap>Alt</keycap> <keycap>F1</keycap></keycombo>.</para> @@ -1850,7 +1851,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para><application>Sendmail</application> is the most + <programlisting><![CDATA[<para><application>Sendmail</application> is the most widely used Unix mail application.</para> <para><application>Sendmail</application> includes the @@ -1908,7 +1909,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>The SGML source for the Handbook in English can be + <programlisting><![CDATA[<para>The SGML source for the Handbook in English can be found in <filename class="directory">/usr/doc/en_US.ISO8859-1/books/handbook/</filename>. The first file is called <filename>book.sgml</filename> in that directory. You should also see a <filename>Makefile</filename> @@ -1952,7 +1953,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>Install the <filename role="package">net/ethereal</filename> port to view network traffic.</para>]]></programlisting> + <programlisting><![CDATA[<para>Install the <filename role="package">net/ethereal</filename> port to view network traffic.</para>]]></programlisting> <para>Appearance:</para> @@ -1989,7 +1990,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para><devicename>sio</devicename> is used for serial + <programlisting><![CDATA[<para><devicename>sio</devicename> is used for serial communication in FreeBSD. <devicename>sio</devicename> manifests through a number of entries in <filename>/dev</filename>, including <filename>/dev/ttyd0</filename> and <filename>/dev/cuaa0</filename>.</para> @@ -2117,7 +2118,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>The local machine can always be referred to by the + <programlisting><![CDATA[<para>The local machine can always be referred to by the name <hostid>localhost</hostid>, which will have the IP address <hostid role="ipaddr">127.0.0.1</hostid>.</para> @@ -2180,7 +2181,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>To carry out most system administration functions you + <programlisting><![CDATA[<para>To carry out most system administration functions you will need to be <username>root</username>.</para>]]></programlisting> <para>Appearance:</para> @@ -2220,7 +2221,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>Two common targets in a <filename>Makefile</filename> + <programlisting><![CDATA[<para>Two common targets in a <filename>Makefile</filename> are <maketarget>all</maketarget> and <maketarget>clean</maketarget>.</para> <para>Typically, invoking <maketarget>all</maketarget> will rebuild the @@ -2273,7 +2274,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>The <literal>maxusers 10</literal> line in the kernel + <programlisting><![CDATA[<para>The <literal>maxusers 10</literal> line in the kernel configuration file determines the size of many system tables, and is a rough guide to how many simultaneous logins the system will support.</para>]]></programlisting> @@ -2307,7 +2308,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<screen>&prompt.user; <userinput>man <replaceable>command</replaceable></userinput></screen>]]></programlisting> + <programlisting><![CDATA[<screen>&prompt.user; <userinput>man <replaceable>command</replaceable></userinput></screen>]]></programlisting> <para>Appearance:</para> @@ -2325,7 +2326,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [<para>The <literal>maxusers <replaceable>n</replaceable></literal> + <programlisting><![CDATA[<para>The <literal>maxusers <replaceable>n</replaceable></literal> line in the kernel configuration file determines the size of many system tables, and is a rough guide to how many simultaneous logins the system will support.</para> @@ -2358,7 +2359,7 @@ This is the file called 'foo2'</screen> <para>Use:</para> - <programlisting><![ CDATA [ + <programlisting><![CDATA[ <screen><errorname>Panic: cannot mount root</errorname></screen> ]]> </programlisting> @@ -2480,17 +2481,17 @@ This is the file called 'foo2'</screen> <programlisting><mediaobject> <imageobject> - <imagedata fileref="fig1"> <co id="co-image-ext"> + <imagedata fileref="fig1"> <co id="co-image-ext"/> </imageobject> <textobject> - <literallayout class="monospaced">+---------------+ <co id="co-image-literal"> + <literallayout class="monospaced">+---------------+ <co id="co-image-literal"/> | A | +---------------+</literallayout> </textobject> <textobject> - <phrase>A picture</phrase> <co id="co-image-phrase"> + <phrase>A picture</phrase> <co id="co-image-phrase"/> </textobject> </mediaobject></programlisting> @@ -2567,7 +2568,7 @@ IMAGES+= fig3.png <para>You must be careful when you separate your documentation into smaller files (see - <xref linkend="sgml-primer-include-using-gen-entities">) in + <xref linkend="sgml-primer-include-using-gen-entities"/>) in different directories.</para> <para>Suppose you have a book with three chapters, and the @@ -2595,7 +2596,7 @@ IMAGES+= fig3.png <programlisting><mediaobject> <imageobject> - <imagedata fileref="chapter1/fig1"> <co id="co-image-dir"> + <imagedata fileref="chapter1/fig1"> <co id="co-image-dir"/> </imageobject> … @@ -2649,7 +2650,7 @@ IMAGES= chapter1/fig1.png <title>Attribute <literal>id</literal> on Chapters and Sections</title> - <programlisting><![ CDATA [<chapter id="chapter1"> + <programlisting><![CDATA[<chapter id="chapter1"> <title>Introduction</title> <para>This is the introduction. It contains a subsection, @@ -2680,7 +2681,7 @@ IMAGES= chapter1/fig1.png <example> <title><sgmltag>anchor</sgmltag></title> - <programlisting><![ CDATA [<para>This paragraph has an embedded + <programlisting><![CDATA[<para>This paragraph has an embedded <anchor id="para1">link target in it. It will not show up in the document.</para>]]></programlisting> </example> @@ -2709,11 +2710,11 @@ IMAGES= chapter1/fig1.png document that includes the <literal>id</literal> example:</para> - <programlisting><![ CDATA [<para>More information can be found - in <xref linkend="chapter1">.</para> + <programlisting><![CDATA[<para>More information can be found + in <xref linkend="chapter1"/>.</para> <para>More specific information can be found - in <xref linkend="chapter1-sect1">.</para>]]></programlisting> + in <xref linkend="chapter1-sect1"/>.</para>]]></programlisting> <para>The text of the link will be generated automatically, and will look like (<emphasis>emphasized</emphasis> text @@ -2753,7 +2754,7 @@ IMAGES= chapter1/fig1.png document that includes the <literal>id</literal> example.</para> - <programlisting><![ CDATA [<para>More information can be found in + <programlisting><![CDATA[<para>More information can be found in <link linkend="chapter1">the first chapter</link>.</para> <para>More specific information can be found in @@ -2804,7 +2805,7 @@ IMAGES= chapter1/fig1.png <para>Use:</para> - <programlisting><![ CDATA [<para>Of course, you could stop reading this document and + <programlisting><![CDATA[<para>Of course, you could stop reading this document and go to the <ulink url="&url.base;/index.html">FreeBSD home page</ulink> instead.</para>]]></programlisting> |