diff options
author | Nik Clayton <nik@FreeBSD.org> | 1999-09-03 17:14:12 +0000 |
---|---|---|
committer | Nik Clayton <nik@FreeBSD.org> | 1999-09-03 17:14:12 +0000 |
commit | f4ca19b7a8ce1f5557db03c4ac0f795712692109 (patch) | |
tree | 383d7b4fdb8034dbc95ebbf1fedda869c23d8c9b /en_US.ISO8859-1 | |
parent | 9d22e6e5d72d41f7c88b9313ddf4c449f50a87f1 (diff) | |
download | doc-f4ca19b7a8ce1f5557db03c4ac0f795712692109.tar.gz doc-f4ca19b7a8ce1f5557db03c4ac0f795712692109.zip |
Miscellaneous small changes.
Note: includes whitespace changes. No active translations of this
document exist, so this doesn't matter.
Notes
Notes:
svn path=/head/; revision=5507
Diffstat (limited to 'en_US.ISO8859-1')
-rw-r--r-- | en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml | 20 |
1 files changed, 11 insertions, 9 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 |