diff --git a/en_US.ISO8859-1/books/fdp-primer/book.sgml b/en_US.ISO8859-1/books/fdp-primer/book.sgml index 349cc48426..5a79e0c026 100644 --- a/en_US.ISO8859-1/books/fdp-primer/book.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/book.sgml @@ -192,7 +192,7 @@ Password: - Notes, tips, important information, warnings, and examples + Notes, Tips, Important Information, Warnings, and Examples Within the text appear notes, warnings, and examples. @@ -220,7 +220,7 @@ Password: - A sample example + A Sample Example Examples are represented like this, and typically contain examples you should walk through, or show you what the results of a diff --git a/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml index b7a8ab04a8..78ef791c4b 100644 --- a/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml @@ -146,7 +146,7 @@ - Before you start + Before You Start This document assumes that you already know: diff --git a/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml index 2d54675444..99a75b82d4 100644 --- a/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml @@ -172,8 +172,8 @@ Leaving gaps in the numbering is to be avoided. - Bad ordering of - <sgmltag>h<replaceable>n</replaceable></sgmltag> elements + Bad Ordering of + <sgmltag>h<replaceable>n</replaceable></sgmltag> Elements Use: @@ -2023,7 +2023,7 @@ This is the file called 'foo2' - <sgmltag>hostid</sgmltag> and roles + <sgmltag>hostid</sgmltag> and Roles Use: @@ -2190,8 +2190,8 @@ This is the file called 'foo2' - Showing items that the user <emphasis>must</emphasis> fill - in + Showing Items That the User <emphasis>Must</emphasis> Fill + In There will often be times when you want to show the user what to do, or refer to a file, or command line, or similar, where the user 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 909f2c9480..8505d1e27b 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 @@ -157,7 +157,7 @@ - Elements, tags, and attributes + Elements, Tags, and Attributes All the DTDs written in SGML share certain characteristics. This is hardly surprising, as the philosophy behind SGML will inevitably show @@ -209,7 +209,7 @@ /element-name. - Using an element (start and end tags) + Using an Element (Start and End Tags) HTML has an element for indicating that the content enclosed by the element is a paragraph, called p. This @@ -228,7 +228,7 @@ the start tag is required for this element. - Using an element (start tag only) + Using an Element (Start Tag Only) HTML has an element for indicating a horizontal rule, called hr. This element does not wrap content, so only @@ -248,7 +248,7 @@ on. - Elements within elements; <sgmltag>em</sgmltag> + Elements within Elements; <sgmltag>em</sgmltag> This is a simple paragraph where some of the words have been emphasized.

]]> @@ -298,7 +298,7 @@ left. - Using an element with an attribute + Using An Element with An Attribute The inclusion of the align attribute on this paragraph was superfluous, since the default is left.

@@ -313,7 +313,7 @@ the attribute value. - Single quotes around attributes + Single Quotes Around Attributes I am on the right!

]]> @@ -332,7 +332,7 @@ catalog files. - For you to do… + For You to Do… In order to run the examples in this document you will need to install some software on your system and ensure that an environment @@ -356,7 +356,7 @@ <filename>.profile</filename>, for &man.sh.1; and - &man.bash.1; users + &man.bash.1; Users SGML_ROOT=/usr/local/share/sgml SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog @@ -370,7 +370,7 @@ export SGML_CATALOG_FILES <filename>.cshrc</filename>, for &man.csh.1; and - &man.tcsh.1; users + &man.tcsh.1; Users setenv SGML_ROOT /usr/local/share/sgml setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog @@ -395,7 +395,7 @@ setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATA - An example HTML file + An Example HTML File @@ -526,7 +526,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - The DOCTYPE declaration + The DOCTYPE Declaration The beginning of each document that you write must specify the name of the DTD that the document conforms to. This is so that SGML parsers @@ -692,7 +692,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - <filename>catalog</filename> files + <filename>catalog</filename> Files If you use the syntax above and process this document using an SGML processor, the processor will need to have some way of @@ -779,7 +779,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Escaping back to SGML + Escaping Back to SGML As mentioned earlier, SGML is only used when writing a DTD. This is not strictly true. There is certain SGML syntax that you @@ -814,7 +814,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished opens a comment, and the second closes it. - SGML generic comment + SGML Generic Comment <!-- test comment --> @@ -832,7 +832,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Use 2 dashes + Use 2 Dashes There is a problem with producing the Postscript and PDF versions of this document. The above example probably shows just one hyphen @@ -861,7 +861,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished will reject documents that make that error. - Erroneous SGML comments + Erroneous SGML Comments - For you to do… + For You to Do… @@ -964,7 +964,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished declaration. - Defining general entities + Defining General Entities @@ -982,7 +982,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Parameter entities + Parameter Entities Like general entities, parameter entities are used to assign names to @@ -1003,7 +1003,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished entity. - Defining parameter entities + Defining Parameter Entities @@ -1018,7 +1018,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - For you to do… + For You to Do… @@ -1031,7 +1031,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - An example HTML file + An Example HTML File @@ -1098,7 +1098,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Using entities to include files + Using Entities to Include Files Entities (both general and particularly useful when used to include one file inside another. - Using general entities to include files + Using General Entities to Include Files Suppose you have some content for an SGML book organized into files, one file per chapter, called @@ -1121,7 +1121,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished the value of the entity. - Using general entities to include files + Using General Entities to Include Files @@ -1150,7 +1150,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Using parameter entities to include files + Using Parameter Entities to Include Files Recall that parameter entities can only be used inside an SGML context. Why then would you want to include a file within an SGML @@ -1171,7 +1171,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished document. - Using parameter entities to include files + Using Parameter Entities to Include Files First, place your entity definitions in a separate file, called chapters.ent. This file contains the @@ -1203,10 +1203,10 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - For you to do… + For You to Do… - Use general entities to include files + Use General Entities to Include Files @@ -1232,7 +1232,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - An example HTML file + An Example HTML File @@ -1262,7 +1262,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Use parameter entities to include files + Use Parameter Entities to Include Files You must have taken the previous steps first. @@ -1279,7 +1279,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - An example HTML file + An Example HTML File @@ -1321,14 +1321,14 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Marked sections + Marked Sections SGML provides a mechanism to indicate that particular pieces of the document should be processed in a special way. These are termed marked sections. - Structure of a marked section + Structure of A Marked Section <![ KEYWORD [ Contents of marked section @@ -1352,7 +1352,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished >. - Marked section keywords + Marked Section Keywords <literal>CDATA</literal>, <literal>RCDATA</literal> @@ -1409,7 +1409,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - Using a CDATA marked section + Using a <literal>CDATA</literal> Marked Section <para>Here is an example of how you would include some text that contained many <literal>&lt;</literal> @@ -1451,7 +1451,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished Using <literal>INCLUDE</literal> and - <literal>IGNORE</literal> in marked sections + IGNORE in Marked Sections <![ INCLUDE [ This text will be processed and included. @@ -1488,8 +1488,8 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished reprocess the document. - Using a parameter entity to control a marked - section + Using A Parameter Entity to Control a Marked + Section <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [ <!ENTITY % electronic.copy "INCLUDE"> @@ -1515,7 +1515,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished - For you to do… + For You to Do… diff --git a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml index 7dd78fa245..8b8ba4b461 100644 --- a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml @@ -70,7 +70,7 @@ HTML document without abusing HTML to do so. - The DocBook documents + The DocBook Documents The FreeBSD DSSSL stylesheets include a reference to a stylesheet, docbook.css, which is expected to appear in the diff --git a/en_US.ISO8859-1/books/fdp-primer/tools/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/tools/chapter.sgml index 1f41bb85a7..68ebb62ce2 100644 --- a/en_US.ISO8859-1/books/fdp-primer/tools/chapter.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/tools/chapter.sgml @@ -47,7 +47,7 @@ tools is covered in later chapters. - Use <filename role="package">textproc/docproj</filename> if possible + Use <filename role="package">textproc/docproj</filename> If Possible You can save yourself a lot of time if you install the textproc/docproj port. This is a @@ -83,7 +83,7 @@ - Mandatory tools + Mandatory Tools Software @@ -199,7 +199,7 @@ - Optional tools + Optional Tools You do not need to have any of the following installed. However, you may find it easier to work with the documentation if you do, and