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 0c60f6ed96..f15c01370b 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 Try to validate this file using an SGML parser. Part of textproc/docproj is the - &man.nsgmls.1; validating - parser. Normally, &man.nsgmls.1; reads in a document + nsgmls validating + parser. Normally, nsgmls 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). - However, when &man.nsgmls.1; is given the - parameter, &man.nsgmls.1; will suppress its normal output, and + However, when nsgmls is given the + parameter, nsgmls 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. - Use &man.nsgmls.1; to check that your document is + Use nsgmls to check that your document is valid; &prompt.user; nsgmls -s example.sgml - As you will see, &man.nsgmls.1; returns without displaying any + As you will see, nsgmls returns without displaying any output. This means that your document validated successfully. @@ -442,7 +442,7 @@ setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATA 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 - The error output from &man.nsgmls.1; is organized into + The error output from nsgmls is organized into colon-separated groups, or columns. @@ -512,7 +512,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished The second error is because head elements must contain a title - element. Because it does not &man.nsgmls.1; considers that the + element. Because it does not nsgmls 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. @@ -894,13 +894,13 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished Add some comments to example.sgml, and - check that the file still validates using &man.nsgmls.1; + check that the file still validates using nsgmls Add some invalid comments to example.sgml, and see the error messages that - &man.nsgmls.1; gives when it encounters an invalid comment. + nsgmls gives when it encounters an invalid comment. @@ -1045,7 +1045,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Validate the document using &man.nsgmls.1; + Validate the document using nsgmls @@ -1071,7 +1071,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished SGML is to expand all the entity references in the document, replacing the entities with the text that they represent. - You can use &man.sgmlnorm.1; to do this. + You can use sgmlnorm to do this. &prompt.user; sgmlnorm example.sgml > example.html @@ -1082,9 +1082,9 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - If you look at the output from &man.sgmlnorm.1; you will see - that it does not include a DOCTYPE declaration at the start. To - include this you need to use the + If you look at the output from sgmlnorm + you will see that it does not include a DOCTYPE declaration at + the start. To include this you need to use the option; &prompt.user; sgmlnorm -d example.sgml > example.html