os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Fix title capitalization style

Browse source
This commit is contained in:
Gabor Pali 2008-12-07 22:03:48 +00:00
parent 1465320cdf
commit 7c39370311
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=33375
6 changed files with 52 additions and 52 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
en_US.ISO8859-1/books/fdp-primer/book.sgml
View file

@ -192,7 +192,7 @@ Password:</screen></entry>
</sect1> </sect1>
<sect1 id="preface-notes"> <sect1 id="preface-notes">
<title>Notes, tips, important information, warnings, and examples</title> <title>Notes, Tips, Important Information, Warnings, and Examples</title>
<para>Within the text appear notes, warnings, and examples.</para> <para>Within the text appear notes, warnings, and examples.</para>
@ -220,7 +220,7 @@ Password:</screen></entry>
</warning> </warning>
<example> <example>
<title>A sample example</title> <title>A Sample Example</title>
<para>Examples are represented like this, and typically contain <para>Examples are represented like this, and typically contain
examples you should walk through, or show you what the results of a examples you should walk through, or show you what the results of a

2
en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml
View file

@ -146,7 +146,7 @@
</sect1> </sect1>
<sect1 id="overview-before"> <sect1 id="overview-before">
<title>Before you start</title> <title>Before You Start</title>
<para>This document assumes that you already know:</para> <para>This document assumes that you already know:</para>

10
en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml
View file

@ -172,8 +172,8 @@
Leaving gaps in the numbering is to be avoided.</para> Leaving gaps in the numbering is to be avoided.</para>
<example> <example>
<title>Bad ordering of <title>Bad Ordering of
<sgmltag>h<replaceable>n</replaceable></sgmltag> elements</title> <sgmltag>h<replaceable>n</replaceable></sgmltag> Elements</title>
<para>Use:</para> <para>Use:</para>
@ -2023,7 +2023,7 @@ This is the file called 'foo2'</screen>
</variablelist> </variablelist>
<example> <example>
<title><sgmltag>hostid</sgmltag> and roles</title> <title><sgmltag>hostid</sgmltag> and Roles</title>
<para>Use:</para> <para>Use:</para>
@ -2190,8 +2190,8 @@ This is the file called 'foo2'</screen>
</sect3> </sect3>
<sect3> <sect3>
<title>Showing items that the user <emphasis>must</emphasis> fill <title>Showing Items That the User <emphasis>Must</emphasis> Fill
in</title> In</title>
<para>There will often be times when you want to show the user what to <para>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 do, or refer to a file, or command line, or similar, where the user

80
en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml
View file

@ -157,7 +157,7 @@
</sect1> </sect1>
<sect1 id="sgml-primer-elements"> <sect1 id="sgml-primer-elements">
<title>Elements, tags, and attributes</title> <title>Elements, Tags, and Attributes</title>
<para>All the DTDs written in SGML share certain characteristics. This is <para>All the DTDs written in SGML share certain characteristics. This is
hardly surprising, as the philosophy behind SGML will inevitably show hardly surprising, as the philosophy behind SGML will inevitably show
@ -209,7 +209,7 @@
<sgmltag>/<replaceable>element-name</replaceable></sgmltag>.</para> <sgmltag>/<replaceable>element-name</replaceable></sgmltag>.</para>
<example> <example>
<title>Using an element (start and end tags)</title> <title>Using an Element (Start and End Tags)</title>
<para>HTML has an element for indicating that the content enclosed by <para>HTML has an element for indicating that the content enclosed by
the element is a paragraph, called <sgmltag>p</sgmltag>. This the element is a paragraph, called <sgmltag>p</sgmltag>. This
@ -228,7 +228,7 @@
the start tag is required for this element.</para> the start tag is required for this element.</para>
<example> <example>
<title>Using an element (start tag only)</title> <title>Using an Element (Start Tag Only)</title>
<para>HTML has an element for indicating a horizontal rule, called <para>HTML has an element for indicating a horizontal rule, called
<sgmltag>hr</sgmltag>. This element does not wrap content, so only <sgmltag>hr</sgmltag>. This element does not wrap content, so only
@ -248,7 +248,7 @@
on.</para> on.</para>
<example> <example>
<title>Elements within elements; <sgmltag>em</sgmltag></title> <title>Elements within Elements; <sgmltag>em</sgmltag></title>
<programlisting><![ CDATA [<p>This is a simple <em>paragraph</em> where some <programlisting><![ CDATA [<p>This is a simple <em>paragraph</em> where some
of the <em>words</em> have been <em>emphasized</em>.</p>]]></programlisting> of the <em>words</em> have been <em>emphasized</em>.</p>]]></programlisting>
@ -298,7 +298,7 @@
<literal>left</literal>.</para> <literal>left</literal>.</para>
<example> <example>
<title>Using an element with an attribute</title> <title>Using An Element with An Attribute</title>
<programlisting><![ CDATA [<p align="left">The inclusion of the align attribute <programlisting><![ CDATA [<p align="left">The inclusion of the align attribute
on this paragraph was superfluous, since the default is left.</p> on this paragraph was superfluous, since the default is left.</p>
@ -313,7 +313,7 @@
the attribute value.</para> the attribute value.</para>
<example> <example>
<title>Single quotes around attributes</title> <title>Single Quotes Around Attributes</title>
<programlisting><![ CDATA [<p align='right'>I am on the right!</p>]]></programlisting> <programlisting><![ CDATA [<p align='right'>I am on the right!</p>]]></programlisting>
</example> </example>
@ -332,7 +332,7 @@
catalog files.</para> catalog files.</para>
<sect2> <sect2>
<title>For you to do&hellip;</title> <title>For You to Do&hellip;</title>
<para>In order to run the examples in this document you will need to <para>In order to run the examples in this document you will need to
install some software on your system and ensure that an environment install some software on your system and ensure that an environment
@ -356,7 +356,7 @@
<example id="sgml-primer-envars"> <example id="sgml-primer-envars">
<title><filename>.profile</filename>, for &man.sh.1; and <title><filename>.profile</filename>, for &man.sh.1; and
&man.bash.1; users</title> &man.bash.1; Users</title>
<programlisting>SGML_ROOT=/usr/local/share/sgml <programlisting>SGML_ROOT=/usr/local/share/sgml
SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog
@ -370,7 +370,7 @@ export SGML_CATALOG_FILES</programlisting>
<example> <example>
<title><filename>.cshrc</filename>, for &man.csh.1; and <title><filename>.cshrc</filename>, for &man.csh.1; and
&man.tcsh.1; users</title> &man.tcsh.1; Users</title>
<programlisting>setenv SGML_ROOT /usr/local/share/sgml <programlisting>setenv SGML_ROOT /usr/local/share/sgml
setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog 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
<html> <html>
<head> <head>
<title>An example HTML file</title> <title>An Example HTML File</title>
</head> </head>
<body> <body>
@ -526,7 +526,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect1> </sect1>
<sect1 id="sgml-primer-doctype-declaration"> <sect1 id="sgml-primer-doctype-declaration">
<title>The DOCTYPE declaration</title> <title>The DOCTYPE Declaration</title>
<para>The beginning of each document that you write must specify the name <para>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 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</screen>
</variablelist> </variablelist>
<sect3> <sect3>
<title><filename>catalog</filename> files</title> <title><filename>catalog</filename> Files</title>
<para>If you use the syntax above and process this document <para>If you use the syntax above and process this document
using an SGML processor, the processor will need to have some way of 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</screen>
</sect1> </sect1>
<sect1 id="sgml-primer-sgml-escape"> <sect1 id="sgml-primer-sgml-escape">
<title>Escaping back to SGML</title> <title>Escaping Back to SGML</title>
<para>As mentioned earlier, SGML is only used when writing a <para>As mentioned earlier, SGML is only used when writing a
DTD. This is not strictly true. There is certain SGML syntax that you 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</screen>
opens a comment, and the second closes it.</para> opens a comment, and the second closes it.</para>
<example> <example>
<title>SGML generic comment</title> <title>SGML Generic Comment</title>
<programlisting>&lt;!-- test comment --></programlisting> <programlisting>&lt;!-- test comment --></programlisting>
@ -832,7 +832,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<![ %output.print; [ <![ %output.print; [
<important> <important>
<title>Use 2 dashes</title> <title>Use 2 Dashes</title>
<para>There is a problem with producing the Postscript and PDF versions <para>There is a problem with producing the Postscript and PDF versions
of this document. The above example probably shows just one hyphen 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</screen>
will reject documents that make that error.</para> will reject documents that make that error.</para>
<example> <example>
<title>Erroneous SGML comments</title> <title>Erroneous SGML Comments</title>
<programlisting><![ CDATA [ <programlisting><![ CDATA [
<!-- This is in the comment -- <!-- This is in the comment --
@ -889,7 +889,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</example> </example>
<sect2> <sect2>
<title>For you to do&hellip;</title> <title>For You to Do&hellip;</title>
<procedure> <procedure>
<step> <step>
@ -964,7 +964,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
declaration.</para> declaration.</para>
<example> <example>
<title>Defining general entities</title> <title>Defining General Entities</title>
<programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [ <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY current.version "3.0-RELEASE"> <!ENTITY current.version "3.0-RELEASE">
@ -982,7 +982,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect2> </sect2>
<sect2 id="sgml-primer-parameter-entities"> <sect2 id="sgml-primer-parameter-entities">
<title>Parameter entities</title> <title>Parameter Entities</title>
<para>Like <link linkend="sgml-primer-general-entities">general <para>Like <link linkend="sgml-primer-general-entities">general
entities</link>, parameter entities are used to assign names to entities</link>, 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</screen>
entity.</para> entity.</para>
<example> <example>
<title>Defining parameter entities</title> <title>Defining Parameter Entities</title>
<programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [ <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % param.some "some"> <!ENTITY % param.some "some">
@ -1018,7 +1018,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect2> </sect2>
<sect2> <sect2>
<title>For you to do&hellip;</title> <title>For You to Do&hellip;</title>
<procedure> <procedure>
<step> <step>
@ -1031,7 +1031,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<html> <html>
<head> <head>
<title>An example HTML file</title> <title>An Example HTML File</title>
</head> </head>
<!-- You might well have some comments in here as well --> <!-- You might well have some comments in here as well -->
@ -1098,7 +1098,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect1> </sect1>
<sect1 id="sgml-primer-include"> <sect1 id="sgml-primer-include">
<title>Using entities to include files</title> <title>Using Entities to Include Files</title>
<para>Entities (both <link <para>Entities (both <link
linkend="sgml-primer-general-entities">general</link> and <link linkend="sgml-primer-general-entities">general</link> and <link
@ -1106,7 +1106,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
particularly useful when used to include one file inside another.</para> particularly useful when used to include one file inside another.</para>
<sect2 id="sgml-primer-include-using-gen-entities"> <sect2 id="sgml-primer-include-using-gen-entities">
<title>Using general entities to include files</title> <title>Using General Entities to Include Files</title>
<para>Suppose you have some content for an SGML book organized into <para>Suppose you have some content for an SGML book organized into
files, one file per chapter, called files, one file per chapter, called
@ -1121,7 +1121,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
the value of the entity.</para> the value of the entity.</para>
<example> <example>
<title>Using general entities to include files</title> <title>Using General Entities to Include Files</title>
<programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [ <programlisting><![ CDATA [<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY chapter.1 SYSTEM "chapter1.sgml"> <!ENTITY chapter.1 SYSTEM "chapter1.sgml">
@ -1150,7 +1150,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect2> </sect2>
<sect2> <sect2>
<title>Using parameter entities to include files</title> <title>Using Parameter Entities to Include Files</title>
<para>Recall that parameter entities can only be used inside an SGML <para>Recall that parameter entities can only be used inside an SGML
context. Why then would you want to include a file within 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</screen>
document.</para> document.</para>
<example> <example>
<title>Using parameter entities to include files</title> <title>Using Parameter Entities to Include Files</title>
<para>First, place your entity definitions in a separate file, called <para>First, place your entity definitions in a separate file, called
<filename>chapters.ent</filename>. This file contains the <filename>chapters.ent</filename>. This file contains the
@ -1203,10 +1203,10 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect2> </sect2>
<sect2> <sect2>
<title>For you to do&hellip;</title> <title>For You to Do&hellip;</title>
<sect3> <sect3>
<title>Use general entities to include files</title> <title>Use General Entities to Include Files</title>
<procedure> <procedure>
<step> <step>
@ -1232,7 +1232,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<html> <html>
<head> <head>
<title>An example HTML file</title> <title>An Example HTML File</title>
</head> </head>
<body> <body>
@ -1262,7 +1262,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect3> </sect3>
<sect3> <sect3>
<title>Use parameter entities to include files</title> <title>Use Parameter Entities to Include Files</title>
<note> <note>
<para>You must have taken the previous steps first.</para> <para>You must have taken the previous steps first.</para>
@ -1279,7 +1279,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<html> <html>
<head> <head>
<title>An example HTML file</title> <title>An Example HTML File</title>
</head> </head>
<body> <body>
@ -1321,14 +1321,14 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect1> </sect1>
<sect1 id="sgml-primer-marked-sections"> <sect1 id="sgml-primer-marked-sections">
<title>Marked sections</title> <title>Marked Sections</title>
<para>SGML provides a mechanism to indicate that particular pieces of the <para>SGML provides a mechanism to indicate that particular pieces of the
document should be processed in a special way. These are termed document should be processed in a special way. These are termed
<quote>marked sections</quote>.</para> <quote>marked sections</quote>.</para>
<example> <example>
<title>Structure of a marked section</title> <title>Structure of A Marked Section</title>
<programlisting>&lt;![ <replaceable>KEYWORD</replaceable> [ <programlisting>&lt;![ <replaceable>KEYWORD</replaceable> [
Contents of marked section Contents of marked section
@ -1352,7 +1352,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<literal>&gt;</literal>.</para> <literal>&gt;</literal>.</para>
<sect2> <sect2>
<title>Marked section keywords</title> <title>Marked Section Keywords</title>
<sect3> <sect3>
<title><literal>CDATA</literal>, <literal>RCDATA</literal></title> <title><literal>CDATA</literal>, <literal>RCDATA</literal></title>
@ -1409,7 +1409,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<!-- The nesting of CDATA within the next example is disgusting --> <!-- The nesting of CDATA within the next example is disgusting -->
<example> <example>
<title>Using a CDATA marked section</title> <title>Using a <literal>CDATA</literal> Marked Section</title>
<programlisting>&lt;para>Here is an example of how you would include some text <programlisting>&lt;para>Here is an example of how you would include some text
that contained many &lt;literal>&amp;lt;&lt;/literal> that contained many &lt;literal>&amp;lt;&lt;/literal>
@ -1451,7 +1451,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<example> <example>
<title>Using <literal>INCLUDE</literal> and <title>Using <literal>INCLUDE</literal> and
<literal>IGNORE</literal> in marked sections</title> <literal>IGNORE</literal> in Marked Sections</title>
<programlisting>&lt;![ INCLUDE [ <programlisting>&lt;![ INCLUDE [
This text will be processed and included. 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</screen>
reprocess the document.</para> reprocess the document.</para>
<example> <example>
<title>Using a parameter entity to control a marked <title>Using A Parameter Entity to Control a Marked
section</title> Section</title>
<programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [ <programlisting>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
&lt;!ENTITY % electronic.copy "INCLUDE"> &lt;!ENTITY % electronic.copy "INCLUDE">
@ -1515,7 +1515,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
</sect2> </sect2>
<sect2> <sect2>
<title>For you to do&hellip;</title> <title>For You to Do&hellip;</title>
<procedure> <procedure>
<step> <step>

2
en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml
View file

@ -70,7 +70,7 @@
HTML document without abusing HTML to do so.</para> HTML document without abusing HTML to do so.</para>
<sect2> <sect2>
<title>The DocBook documents</title> <title>The DocBook Documents</title>
<para>The FreeBSD DSSSL stylesheets include a reference to a stylesheet, <para>The FreeBSD DSSSL stylesheets include a reference to a stylesheet,
<filename>docbook.css</filename>, which is expected to appear in the <filename>docbook.css</filename>, which is expected to appear in the

6
en_US.ISO8859-1/books/fdp-primer/tools/chapter.sgml
View file

@ -47,7 +47,7 @@
tools is covered in later chapters.</para> tools is covered in later chapters.</para>
<tip> <tip>
<title>Use <filename role="package">textproc/docproj</filename> if possible</title> <title>Use <filename role="package">textproc/docproj</filename> If Possible</title>
<para>You can save yourself a lot of time if you install the <para>You can save yourself a lot of time if you install the
<filename role="package">textproc/docproj</filename> port. This is a <filename role="package">textproc/docproj</filename> port. This is a
@ -83,7 +83,7 @@
</tip> </tip>
<sect1 id="tools-mandatory"> <sect1 id="tools-mandatory">
<title>Mandatory tools</title> <title>Mandatory Tools</title>
<sect2> <sect2>
<title>Software</title> <title>Software</title>
@ -199,7 +199,7 @@
</sect1> </sect1>
<sect1 id="tools-optional"> <sect1 id="tools-optional">
<title>Optional tools</title> <title>Optional Tools</title>
<para>You do not need to have any of the following installed. However, <para>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 you may find it easier to work with the documentation if you do, and