Miscellaneous small changes.

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
en_US.ISO_8859-1/books/fdp-primer/sgml-primer

View file

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
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">
@ -92,7 +92,8 @@
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
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
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
not important right now).</para>
<para>However, when <option>-s</option> is passed as a parameter to
it, &man.nsgmls.1; will suppress its normal output, and just print
error messages. This makes it a useful way to check to see if your
document is valid or not.</para>
<para>However, when &man.nsgmls.1; is given the <option>-s</option>
parameter, &man.nsgmls.1; will suppress its normal output, and
just print error messages. This makes it a useful way to check to
see if your document is valid or not.</para>
<para>Use &man.nsgmls.1; to check that your document is
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
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">
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
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
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>
<para>Briefly, the content model describes what sort of content the

View file

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
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">
@ -92,7 +92,8 @@
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
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
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
not important right now).</para>
<para>However, when <option>-s</option> is passed as a parameter to
it, &man.nsgmls.1; will suppress its normal output, and just print
error messages. This makes it a useful way to check to see if your
document is valid or not.</para>
<para>However, when &man.nsgmls.1; is given the <option>-s</option>
parameter, &man.nsgmls.1; will suppress its normal output, and
just print error messages. This makes it a useful way to check to
see if your document is valid or not.</para>
<para>Use &man.nsgmls.1; to check that your document is
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
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">
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
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
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>
<para>Briefly, the content model describes what sort of content the