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

Whitespace change only. Translators please ignore.

Browse source 
PR:		docs/30977
Submitted by:	Giorgos Keramidas <charon@labs.gr>
This commit is contained in:
Murray Stokely 2001-10-02 05:28:57 +00:00
parent ec23fd4f46
commit c0425835ca
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=10858
6 changed files with 36 additions and 35 deletions
en_US.ISO8859-1/books/fdp-primer
examples
appendix.sgml
overview
chapter.sgml
sgml-markup
chapter.sgml
sgml-primer
chapter.sgml
structure
chapter.sgml
the-website
chapter.sgml

12
en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml
View file

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml,v 1.4 2001/06/23 06:57:00 dd Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml,v 1.5 2001/08/29 00:34:27 nik Exp $
-->
<appendix id="examples">
@ -240,9 +240,9 @@
<callout arearefs="examples-co-jade-2-filename">
<para>Specifies the file that Jade should process. The
stylesheets determine how the individual HTML files will be
named, and the name of the <quote>root</quote> file (i.e., the
one that contains the start of the document.</para>
stylesheets determine how the individual HTML files will be
named, and the name of the <quote>root</quote> file (i.e., the
one that contains the start of the document.</para>
</callout>
</calloutlist>
@ -294,14 +294,14 @@
<screen>&prompt.user; <userinput>tex "&amp;jadetex" <replaceable>file</replaceable>.tex</userinput></screen>
<para>You have to run <command>tex</command> <emphasis>at
least</emphasis> three times. The first run processes the
least</emphasis> three times. The first run processes the
document, and determines areas of the document which are referenced
from other parts of the document, for use in indexing, and so
on.</para>
<para>Do not be alarmed if you see warning messages such as
<literal>LaTeX Warning: Reference `136' on page 5 undefined on input
line 728.</literal> at this point.</para>
line 728.</literal> at this point.</para>
<para>The second run reprocesses the document now that certain pieces
of information are known (such as the document's page length). This

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

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml,v 1.7 2001/07/16 14:45:56 nik Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/overview/chapter.sgml,v 1.8 2001/09/26 21:49:28 murray Exp $
-->
<chapter id="overview">
@ -39,15 +39,15 @@
is produced. Your contributions are very valuable.</para>
<para>This document's main purpose is to clearly explain <emphasis>how
the FDP is organised</emphasis>, <emphasis>how to write and submit
documentation to the FDP</emphasis>, and <emphasis>how to
effectively use the tools available to you when writing
documentation</emphasis>.</para>
the FDP is organised</emphasis>, <emphasis>how to write and submit
documentation to the FDP</emphasis>, and <emphasis>how to
effectively use the tools available to you when writing
documentation</emphasis>.</para>
<para><indexterm>
<primary>Membership</primary>
</indexterm>
Every one is welcome to join the FDP. There is no minimum
Every one is welcome to join the FDP. There is no minimum
membership requirement, no quota of documentation you need to
produce per month. All you need to do is subscribe to the
<email>freebsd-doc@FreeBSD.org</email> mailing list.</para>

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

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml,v 1.29 2001/08/12 19:41:44 dd Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml,v 1.30 2001/10/02 05:24:37 murray Exp $
-->
<chapter id="sgml-markup">
@ -546,7 +546,7 @@
<listitem>
<para>Use <sgmltag>font</sgmltag> with the <literal>size</literal>
attribute set to a number between 1 and 7. The default font size
attribute set to a number between 1 and 7. The default font size
is <literal>3</literal>. This approach is deprecated.</para>
</listitem>
</orderedlist>

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

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml,v 1.18 2001/07/13 20:49:35 nik Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml,v 1.19 2001/07/17 20:51:51 chern Exp $
-->
<chapter id="sgml-primer">
@ -88,12 +88,12 @@
markup from the user, so the user is not distracted by it.</para>
<para>The extra information stored in the markup <emphasis>adds
value</emphasis> to the document. Adding the markup to the document
value</emphasis> to the document. Adding the markup to the document
must typically be done by a person&mdash;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> (i.e., the effort required) to create 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>
@ -117,7 +117,7 @@
in turn, would be very different from a markup language used to describe
poetry. What you really need is a first language that you use to write
these other markup languages. A <emphasis>meta markup
language</emphasis>.</para>
language</emphasis>.</para>
<para>This is exactly what the Standard Generalised Markup Language (SGML)
is. Many markup languages have been written in SGML, including the two
@ -198,7 +198,7 @@
<para>A tag is used to identify where a particular element starts, and
where the element ends. <emphasis>The tag is not part of the element
itself</emphasis>. Because each DTD was normally written to mark up
itself</emphasis>. Because each DTD was normally written to mark up
specific types of information, each one will recognise different
elements, and will therefore have different names for the tags.</para>
@ -398,10 +398,10 @@ setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES</
<para>Part of <filename>textproc/docproj</filename> is the
&man.nsgmls.1; <link linkend="sgml-primer-validating">validating
parser</link>. Normally, &man.nsgmls.1; 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>
parser</link>. Normally, &man.nsgmls.1; 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 &man.nsgmls.1; is given the <option>-s</option>
parameter, &man.nsgmls.1; will suppress its normal output, and
@ -564,7 +564,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<para>Lists the Formal Public Identifier (FPI)<indexterm>
<primary>Formal Public Identifier</primary>
</indexterm>
for the DTD that this
for the DTD that this
document conforms to. Your SGML parser will use this to find the
correct DTD when processing this document.</para>
@ -1147,7 +1147,7 @@ nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished</screen>
<para>You could list the entities at the top of each book, but this
quickly becomes cumbersome to manage.</para>
<para>Instead, place the general entity definitions inside one file,
<para>Instead, place the general entity definitions inside one file,
and use a parameter entity to include that file within your
document.</para>

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

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/structure/chapter.sgml,v 1.5 2001/04/17 16:03:37 nik Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/structure/chapter.sgml,v 1.6 2001/06/11 01:16:47 ache Exp $
-->
<chapter id="structure">
@ -270,12 +270,12 @@
own DOCTYPE lines at the start of the files.</para>
<para>This is unfortunate as
it makes it impossible to treat these as generic SGML
files and simply convert them to HTML, RTF, PS, and other
formats in the same way the main Handbook is generated. This
<emphasis>would</emphasis> force you to rebuild the Handbook
every time you want to see the effect a change has had on just
one chapter.</para>
it makes it impossible to treat these as generic SGML
files and simply convert them to HTML, RTF, PS, and other
formats in the same way the main Handbook is generated. This
<emphasis>would</emphasis> force you to rebuild the Handbook
every time you want to see the effect a change has had on just
one chapter.</para>
</sect4>
</sect3>
</sect2>

5
en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml
View file

@ -27,7 +27,7 @@
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml,v 1.4 2000/04/03 16:24:16 nik Exp $
$FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml,v 1.5 2001/08/19 23:54:35 dd Exp $
-->
<chapter id="the-website">
@ -86,7 +86,8 @@
<screen>&prompt.root; <userinput>cvs -R co www doc</userinput></screen>
</step>
<step><para>Change in to the <filename>www</filename> directory, and
<step>
<para>Change in to the <filename>www</filename> directory, and
run the &man.make.1; <maketarget>links</maketarget> target, to
create the necessary symbolic links.</para>