os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Miscellaneous small changes.

Browse source 
Note:  includes whitespace changes.  No active translations of this
document exist, so this doesn't matter.
This commit is contained in:
Nik Clayton 1999-09-03 17:14:12 +00:00
parent 9d22e6e5d7
commit f4ca19b7a8
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=5507
2 changed files with 22 additions and 18 deletions
en_US.ISO8859-1/books/fdp-primer/sgml-primer
chapter.sgml
en_US.ISO_8859-1/books/fdp-primer/sgml-primer
chapter.sgml

20
en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
View file

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE. POSSIBILITY OF SUCH DAMAGE.
$Id: chapter.sgml,v 1.7 1999-07-30 21:25:50 nik Exp $ $Id: chapter.sgml,v 1.8 1999-09-03 17:14:12 nik Exp $
--> -->
<chapter id="sgml-primer"> <chapter id="sgml-primer">
@ -92,7 +92,8 @@
must typically be done by a person&mdash;after all, if computers could must typically be done by a person&mdash;after all, if computers could
recognise the text sufficiently well to add the markup then there would recognise the text sufficiently well to add the markup then there would
be no need to add it in the first place. This <emphasis>increases the be no need to add it in the first place. This <emphasis>increases the
cost</emphasis> of the document.</para> cost</emphasis> (i.e., the effort required) to create the
document.</para>
<para>The previous example is actually represented in this document like <para>The previous example is actually represented in this document like
this;</para> this;</para>
@ -410,15 +411,16 @@ setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/catalog:$SGML_CATALOG_FILES</prog
document's Element Structure Information Set (ESIS, but that is document's Element Structure Information Set (ESIS, but that is
not important right now).</para> not important right now).</para>
<para>However, when <option>-s</option> is passed as a parameter to <para>However, when &man.nsgmls.1; is given the <option>-s</option>
it, &man.nsgmls.1; will suppress its normal output, and just print parameter, &man.nsgmls.1; will suppress its normal output, and
error messages. This makes it a useful way to check to see if your just print error messages. This makes it a useful way to check to
document is valid or not.</para> see if your document is valid or not.</para>
<para>Use &man.nsgmls.1; to check that your document is <para>Use &man.nsgmls.1; to check that your document is
valid;</para> valid;</para>
<screen>&prompt.user; <userinput>nsgmls -s example.sgml</userinput></screen> <screen>&prompt.user; <userinput>nsgmls -s
example.sgml</userinput></screen>
<para>As you will see, &man.nsgmls.1; returns without displaying any <para>As you will see, &man.nsgmls.1; returns without displaying any
output. This means that your document validated output. This means that your document validated
@ -806,7 +808,7 @@ PUBLIC "-//W3C//DTD HTML 4.0//EN" "4.0/strict.dtd"</programlisting>
inside a DTD. However, as <xref linkend="sgml-primer-sgml-escape"> inside a DTD. However, as <xref linkend="sgml-primer-sgml-escape">
shows, it is possible to use SGML syntax within your document.</para> shows, it is possible to use SGML syntax within your document.</para>
<para>The delimiters for SGML comments is the string <para>The delimiter for SGML comments is the string
&ldquo;<literal>--</literal>&rdquo;. The first occurence of this string &ldquo;<literal>--</literal>&rdquo;. The first occurence of this string
opens a comment, and the second closes it.</para> opens a comment, and the second closes it.</para>
@ -1370,7 +1372,7 @@ PUBLIC "-//W3C//DTD HTML 4.0//EN" "4.0/strict.dtd"</programlisting>
model</emphasis>, and allow you to change it from the model</emphasis>, and allow you to change it from the
default.</para> default.</para>
<para>When an SGML parser is processing a document, it keeps track <para>When an SGML parser is processing a document it keeps track
of what is called the &ldquo;content model&rdquo;.</para> of what is called the &ldquo;content model&rdquo;.</para>
<para>Briefly, the content model describes what sort of content the <para>Briefly, the content model describes what sort of content the

20
en_US.ISO_8859-1/books/fdp-primer/sgml-primer/chapter.sgml
View file

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE. POSSIBILITY OF SUCH DAMAGE.
$Id: chapter.sgml,v 1.7 1999-07-30 21:25:50 nik Exp $ $Id: chapter.sgml,v 1.8 1999-09-03 17:14:12 nik Exp $
--> -->
<chapter id="sgml-primer"> <chapter id="sgml-primer">
@ -92,7 +92,8 @@
must typically be done by a person&mdash;after all, if computers could must typically be done by a person&mdash;after all, if computers could
recognise the text sufficiently well to add the markup then there would recognise the text sufficiently well to add the markup then there would
be no need to add it in the first place. This <emphasis>increases the be no need to add it in the first place. This <emphasis>increases the
cost</emphasis> of the document.</para> cost</emphasis> (i.e., the effort required) to create the
document.</para>
<para>The previous example is actually represented in this document like <para>The previous example is actually represented in this document like
this;</para> this;</para>
@ -410,15 +411,16 @@ setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/catalog:$SGML_CATALOG_FILES</prog
document's Element Structure Information Set (ESIS, but that is document's Element Structure Information Set (ESIS, but that is
not important right now).</para> not important right now).</para>
<para>However, when <option>-s</option> is passed as a parameter to <para>However, when &man.nsgmls.1; is given the <option>-s</option>
it, &man.nsgmls.1; will suppress its normal output, and just print parameter, &man.nsgmls.1; will suppress its normal output, and
error messages. This makes it a useful way to check to see if your just print error messages. This makes it a useful way to check to
document is valid or not.</para> see if your document is valid or not.</para>
<para>Use &man.nsgmls.1; to check that your document is <para>Use &man.nsgmls.1; to check that your document is
valid;</para> valid;</para>
<screen>&prompt.user; <userinput>nsgmls -s example.sgml</userinput></screen> <screen>&prompt.user; <userinput>nsgmls -s
example.sgml</userinput></screen>
<para>As you will see, &man.nsgmls.1; returns without displaying any <para>As you will see, &man.nsgmls.1; returns without displaying any
output. This means that your document validated output. This means that your document validated
@ -806,7 +808,7 @@ PUBLIC "-//W3C//DTD HTML 4.0//EN" "4.0/strict.dtd"</programlisting>
inside a DTD. However, as <xref linkend="sgml-primer-sgml-escape"> inside a DTD. However, as <xref linkend="sgml-primer-sgml-escape">
shows, it is possible to use SGML syntax within your document.</para> shows, it is possible to use SGML syntax within your document.</para>
<para>The delimiters for SGML comments is the string <para>The delimiter for SGML comments is the string
&ldquo;<literal>--</literal>&rdquo;. The first occurence of this string &ldquo;<literal>--</literal>&rdquo;. The first occurence of this string
opens a comment, and the second closes it.</para> opens a comment, and the second closes it.</para>
@ -1370,7 +1372,7 @@ PUBLIC "-//W3C//DTD HTML 4.0//EN" "4.0/strict.dtd"</programlisting>
model</emphasis>, and allow you to change it from the model</emphasis>, and allow you to change it from the
default.</para> default.</para>
<para>When an SGML parser is processing a document, it keeps track <para>When an SGML parser is processing a document it keeps track
of what is called the &ldquo;content model&rdquo;.</para> of what is called the &ldquo;content model&rdquo;.</para>
<para>Briefly, the content model describes what sort of content the <para>Briefly, the content model describes what sort of content the