Remove leading and trailing whitespace from the Documentation Primer.

Translators can likely ignore this change.

Approved by:		jkois (mentor)
This commit is contained in:
Glen Barber 2011-07-12 01:20:10 +00:00
parent 653f99ca4f
commit e7f9c1620c
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=37426

View file

@ -32,19 +32,19 @@
<chapter id="tools">
<title>Tools</title>
<para>The FDP uses a number of different software tools to help
manage the FreeBSD documentation, convert it to different output
formats, and so on. You will need to use these tools yourself if
you are to work with the FreeBSD documentation.</para>
you are to work with the FreeBSD documentation.</para>
<para>All these tools are available as FreeBSD Ports and Packages,
greatly simplifying the work you have to do to install
them.</para>
them.</para>
<para>You will need to install these tools before you work through
any of the examples in later chapters. The actual usage of these
tools is covered in later chapters.</para>
tools is covered in later chapters.</para>
<tip>
<title>Use <filename role="package">textproc/docproj</filename> If Possible</title>
@ -87,38 +87,38 @@
<sect2>
<title>Software</title>
<para>These programs are required before you can usefully work with the
FreeBSD documentation, and they will allow you to convert the
documentation to HTML, plain text, and RTF formats. They are all
included in <filename role="package">textproc/docproj</filename>.</para>
<variablelist>
<varlistentry>
<term><application>Jade</application>
(<filename role="package">textproc/jade</filename>)</term>
<listitem>
<para>A DSSSL implementation. Used for converting marked up
documents to other formats, including HTML and &tex;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><application>Tidy</application>
(<filename role="package">www/tidy</filename>)</term>
<listitem>
<para>An HTML <quote>pretty printer</quote>, used to reformat some of the
automatically generated HTML so that it is easier to
follow.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><application>Links</application>
(<filename role="package">www/links</filename>)</term>
<listitem>
<para>A text-mode WWW browser that can also convert
HTML files to plain text.</para>
@ -128,7 +128,7 @@
<varlistentry>
<term><application>peps</application>
(<filename role="package">graphics/peps</filename>)</term>
<listitem>
<para>Some of the documentation includes images, some of which are
stored as EPS files. These must be converted to PNG before most
@ -143,30 +143,30 @@
<para>These are the DTDs and entity sets used by the FDP. They need to
be installed before you can work with any of the documentation.</para>
<variablelist>
<varlistentry>
<term>HTML DTD (<filename role="package">textproc/html</filename>)</term>
<listitem>
<para>HTML is the markup language of choice for the World Wide
Web, and is used throughout the FreeBSD web site.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>DocBook DTD (<filename role="package">textproc/docbook</filename>)</term>
<listitem>
<para>DocBook is designed for marking up technical documentation.
All the FreeBSD documentation is written in DocBook.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ISO 8879 entities
(<filename role="package">textproc/iso8879</filename>)</term>
<listitem>
<para>19 of the ISO 8879:1986 character entity sets used by many
DTDs. Includes named mathematical symbols, additional
@ -182,12 +182,12 @@
<para>The stylesheets are used when converting and formatting the
documentation for display on screen, printing, and so on.</para>
<variablelist>
<varlistentry>
<term>Modular DocBook Stylesheets
(<filename role="package">textproc/dsssl-docbook-modular</filename>)</term>
<listitem>
<para>The Modular DocBook Stylesheets are used when converting
documentation marked up in DocBook to other formats, such as
@ -208,14 +208,14 @@
<sect2>
<title>Software</title>
<variablelist>
<varlistentry>
<term><application>JadeTeX</application> and
<application>teTeX</application>
(<filename role="package">print/jadetex</filename> and
<filename role="package">print/teTeX</filename>)</term>
<listitem>
<para><application>Jade</application> and
<application>teTeX</application> are used to convert DocBook
@ -242,13 +242,13 @@
</important>
</listitem>
</varlistentry>
<varlistentry>
<term><application>Emacs</application> or
<application>XEmacs</application>
<application>XEmacs</application>
(<filename role="package">editors/emacs</filename> or
<filename role="package">editors/xemacs</filename>)</term>
<listitem>
<para>Both these editors include a special mode for editing
documents marked up according to an SGML DTD. This mode
@ -261,7 +261,7 @@
</listitem>
</varlistentry>
</variablelist>
<para>If anyone has recommendations for other software that is useful
when manipulating SGML documents, please let &a.doceng; know, so they
can be added to this list.</para>