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 8505d1e27b..1598172a6c 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 @@ -412,23 +412,23 @@ setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATA <para>Try to validate this file using an SGML parser.</para> <para>Part of <filename role="package">textproc/docproj</filename> is the - <command>nsgmls</command> <link linkend="sgml-primer-validating">validating - parser</link>. Normally, <command>nsgmls</command> reads in a document + <command>onsgmls</command> <link linkend="sgml-primer-validating">validating + parser</link>. Normally, <command>onsgmls</command> reads in a document marked up according to an SGML DTD and returns a copy of the document's Element Structure Information Set (ESIS, but that is not important right now).</para> - <para>However, when <command>nsgmls</command> is given the <option>-s</option> - parameter, <command>nsgmls</command> will suppress its normal output, and + <para>However, when <command>onsgmls</command> is given the <option>-s</option> + parameter, <command>onsgmls</command> 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 <command>nsgmls</command> to check that your document is + <para>Use <command>onsgmls</command> to check that your document is valid:</para> - <screen>&prompt.user; <userinput>nsgmls -s example.sgml</userinput></screen> + <screen>&prompt.user; <userinput>onsgmls -s example.sgml</userinput></screen> - <para>As you will see, <command>nsgmls</command> returns without displaying any + <para>As you will see, <command>onsgmls</command> returns without displaying any output. This means that your document validated successfully.</para> </step> @@ -438,11 +438,11 @@ setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATA removing the <sgmltag>title</sgmltag> and <sgmltag>/title</sgmltag> tags, and re-run the validation.</para> - <screen>&prompt.user; <userinput>nsgmls -s example.sgml</userinput> -nsgmls:example.sgml:5:4:E: character data is not allowed here -nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> + <screen>&prompt.user; <userinput>onsgmls -s example.sgml</userinput> +onsgmls:example.sgml:5:4:E: character data is not allowed here +onsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> - <para>The error output from <command>nsgmls</command> is organized into + <para>The error output from <command>onsgmls</command> is organized into colon-separated groups, or columns.</para> <informaltable frame="none" pgwide="1"> @@ -458,7 +458,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> <row> <entry>1</entry> <entry>The name of the program generating the error. This - will always be <literal>nsgmls</literal>.</entry> + will always be <literal>onsgmls</literal>.</entry> </row> <row> @@ -483,8 +483,8 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> message, <literal>W</literal> is for warnings, and <literal>E</literal> is for errors<footnote> <para>It is not always the fifth column either. - <command>nsgmls -sv</command> displays - <literal>nsgmls:I: SP version "1.3"</literal> + <command>onsgmls -sv</command> displays + <literal>onsgmls:I: "OpenSP" version "1.5.2"</literal> (depending on the installed version). As you can see, this is an informational message.</para> </footnote>, and <literal>X</literal> is for @@ -512,7 +512,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> <para>The second error is because <sgmltag>head</sgmltag> elements <emphasis>must</emphasis> contain a <sgmltag>title</sgmltag> - element. Because it does not <command>nsgmls</command> considers that the + element. Because it does not <command>onsgmls</command> considers that the element has not been properly finished. However, the closing tag indicates that the element has been closed before it has been finished.</para> @@ -894,13 +894,13 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> <procedure> <step> <para>Add some comments to <filename>example.sgml</filename>, and - check that the file still validates using <command>nsgmls</command>.</para> + check that the file still validates using <command>onsgmls</command>.</para> </step> <step> <para>Add some invalid comments to <filename>example.sgml</filename>, and see the error messages that - <command>nsgmls</command> gives when it encounters an invalid comment.</para> + <command>onsgmls</command> gives when it encounters an invalid comment.</para> </step> </procedure> </sect2> @@ -1049,7 +1049,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> </step> <step> - <para>Validate the document using <command>nsgmls</command>.</para> + <para>Validate the document using <command>onsgmls</command>.</para> </step> <step> @@ -1075,9 +1075,9 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> SGML is to expand all the entity references in the document, replacing the entities with the text that they represent.</para> - <para>You can use <command>sgmlnorm</command> to do this.</para> + <para>You can use <command>osgmlnorm</command> to do this.</para> - <screen>&prompt.user; <userinput>sgmlnorm example.sgml > example.html</userinput></screen> + <screen>&prompt.user; <userinput>osgmlnorm example.sgml > example.html</userinput></screen> <para>You should find a normalized (i.e., entity references expanded) copy of your document in @@ -1086,12 +1086,12 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> </step> <step> - <para>If you look at the output from <command>sgmlnorm</command> + <para>If you look at the output from <command>osgmlnorm</command> you will see that it does not include a DOCTYPE declaration at the start. To include this you need to use the <option>-d</option> option:</para> - <screen>&prompt.user; <userinput>sgmlnorm -d example.sgml > example.html</userinput></screen> + <screen>&prompt.user; <userinput>osgmlnorm -d example.sgml > example.html</userinput></screen> </step> </procedure> </sect2> @@ -1249,7 +1249,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> <para>Produce <filename>example.html</filename> by normalizing <filename>example.sgml</filename>.</para> - <screen>&prompt.user; <userinput>sgmlnorm -d example.sgml > example.html</userinput></screen> + <screen>&prompt.user; <userinput>osgmlnorm -d example.sgml > example.html</userinput></screen> </step> <step> @@ -1306,7 +1306,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> <para>Produce <filename>example.html</filename> by normalizing <filename>example.sgml</filename>.</para> - <screen>&prompt.user; <userinput>sgmlnorm -d example.sgml > example.html</userinput></screen> + <screen>&prompt.user; <userinput>osgmlnorm -d example.sgml > example.html</userinput></screen> </step> <step> @@ -1553,7 +1553,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen> </step> <step> - <para>Normalize this file using &man.sgmlnorm.1; and examine the + <para>Normalize this file using <command>osgmlnorm</command> and examine the output. Notice which paragraphs have appeared, which have disappeared, and what has happened to the content of the CDATA marked section.</para>