diff options
| -rw-r--r-- | en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml | 20 | ||||
| -rw-r--r-- | en_US.ISO_8859-1/books/fdp-primer/sgml-primer/chapter.sgml | 20 |
2 files changed, 22 insertions, 18 deletions
diff --git a/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml index c3b2c4d80e..eb71dc5139 100644 --- a/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml @@ -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—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 “<literal>--</literal>”. 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 “content model”.</para> <para>Briefly, the content model describes what sort of content the diff --git a/en_US.ISO_8859-1/books/fdp-primer/sgml-primer/chapter.sgml b/en_US.ISO_8859-1/books/fdp-primer/sgml-primer/chapter.sgml index c3b2c4d80e..eb71dc5139 100644 --- a/en_US.ISO_8859-1/books/fdp-primer/sgml-primer/chapter.sgml +++ b/en_US.ISO_8859-1/books/fdp-primer/sgml-primer/chapter.sgml @@ -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—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 “<literal>--</literal>”. 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 “content model”.</para> <para>Briefly, the content model describes what sort of content the |