Rewritten a lot. Clearer in some places, more explicit in others (no,
that does not mean "Get your XXX pics here"). Added $Id$.
This commit is contained in:
Nik Clayton
parent
68640ce6cc
commit
17da18f046
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=5215
3 changed files with 363 additions and 93 deletions
|
|
@ -26,54 +26,144 @@
|
||||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||||
POSSIBILITY OF SUCH DAMAGE.
|
POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
|
||||||
|
$Id: chapter.sgml,v 1.2 1999-07-14 19:25:40 nik Exp $
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<chapter id="overview">
|
<chapter id="overview">
|
||||||
<title>Overview</title>
|
<title>Overview</title>
|
||||||
|
|
||||||
<para>Welcome to the FreeBSD Documentation Project, and thank you for
|
<para>Welcome to the FreeBSD Documentation Project. Good quality
|
||||||
volunteering. One of the keys to the success of a project such as FreeBSD
|
documentation is very important to the success of FreeBSD, and the
|
||||||
is the availability of good quality documentation, and your contribution
|
FreeBSD Documentation Project (FDP) is how a lot of that documentation
|
||||||
will help that success.</para>
|
is produced. Your contributions are very valuable.</para>
|
||||||
|
|
||||||
<para>After you have read this primer you should;</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>
|
||||||
|
|
||||||
|
<para>Every one is welcome to join the FDP. There is no minimum
|
||||||
|
membership requirements, 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>
|
||||||
|
|
||||||
|
<para>After you have finished reading this document you should:</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Have an understanding of the text formats used by the
|
<para>Know which documentation is maintained by the FDP.</para>
|
||||||
Documentation Project, and why they were chosen.</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Be able to read and understand the source code for the Handbook,
|
<para>Be able to read and understand the SGML source code for the
|
||||||
FAQ, and website, and follow how they are converted into HTML,
|
documentation maintained by the FDP.</para>
|
||||||
PostScript, and other formats.</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Be able to make changes to the documentation, test them, and
|
<para>Be able to make changes to the documentation.</para>
|
||||||
either contribute them back to the project or (if you have commit
|
</listitem>
|
||||||
privileges) commit them.</para>
|
|
||||||
|
<listitem>
|
||||||
|
<para>Be able to submit your changes back for review and eventual
|
||||||
|
inclusion in the FreeBSD documentation.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
|
||||||
<para>This primer assumes that you already understand;</para>
|
<sect1>
|
||||||
|
<title>The FreeBSD Documentation Set</title>
|
||||||
|
|
||||||
<itemizedlist>
|
<para>The FDP is responsible for four categories of FreeBSD
|
||||||
<listitem>
|
documentation.</para>
|
||||||
<para>How to maintain an up-to-date copy of the FreeBSD CVS tree using
|
|
||||||
CVS and one of CVSup or CTM, and how to check out particular versions
|
|
||||||
of files.</para>
|
|
||||||
|
|
||||||
<para>Alternatively, how to retrieve versions of files using the
|
<variablelist>
|
||||||
<application>CVSWeb</application> interface.</para>
|
<varlistentry>
|
||||||
|
<term>Manual pages</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The English language system manual pages are not written by
|
||||||
|
the FDP, as they are part of the base system. However, the FDP can
|
||||||
|
(and has) re-worded parts of existing manual pages to make them
|
||||||
|
clearer, or to correct inaccuracies.</para>
|
||||||
|
|
||||||
|
<para>The translation teams are responsible for translating the
|
||||||
|
system manual pages in to different languages. These translations
|
||||||
|
are kept within the FDP.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>FAQ</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The FAQ aims to address (in short question and answer format)
|
||||||
|
questions that are asked, or should be asked, on the various
|
||||||
|
mailing lists and newsgroups devoted to FreeBSD. The format does
|
||||||
|
not permit long and comprehensive answers.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>Handbook</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The Handbook aims to be the comprehensive on-line resource and
|
||||||
|
reference for FreeBSD users.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>Web site</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>This is the main FreeBSD presence on the World Wide Web,
|
||||||
|
visible at <ulink
|
||||||
|
url="http://www.freebsd.org/">http://www.freebsd.org/</ulink>
|
||||||
|
and many mirrors around the world. The web site is many people's
|
||||||
|
first exposure to FreeBSD.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
</variablelist>
|
||||||
|
|
||||||
|
<para>These four groups of documentation are all available in the
|
||||||
|
FreeBSD CVS tree. This means that the logs and changes to these
|
||||||
|
files are visible to anyone, and anyone can use a program such as
|
||||||
|
<application>CVSup</application> or
|
||||||
|
<application>CTM</application> to keep their own local copies of
|
||||||
|
this documentation.</para>
|
||||||
|
|
||||||
|
<para>In addition, many people have written tutorials or other web
|
||||||
|
sites relating to FreeBSD. Some of these are stored in the CVS
|
||||||
|
repository as well (where the author has agreed to this). In
|
||||||
|
other cases the author has decided to keep their documentation
|
||||||
|
separate from the main FreeBSD repository. The FDP endeavours to
|
||||||
|
provide links to as much of this documentation as
|
||||||
|
possible.</para>
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<sect1>
|
||||||
|
<title>Before you start</title>
|
||||||
|
|
||||||
|
<para>This document assumes that you already know:</para>
|
||||||
|
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>How to maintain an up-to-date local copy of the FreeBSD
|
||||||
|
documentation. Either by maintaining a local copy of the
|
||||||
|
FreeBSD CVS repository (using <application>CVS</application>
|
||||||
|
and either <application>CVSup</application> or
|
||||||
|
<application>CTM</application>) or by using
|
||||||
|
<application>CVSup</application> to download just a
|
||||||
|
<emphasis>checked-out</emphasis> copy.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>How to use the ports system to download and install new
|
<para>How to download and install new software using either the
|
||||||
software.</para>
|
FreeBSD Ports system or &man.pkg.add.1;.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
</sect1>
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
|
|
|
||||||
|
|
@ -26,54 +26,144 @@
|
||||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||||
POSSIBILITY OF SUCH DAMAGE.
|
POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
|
||||||
|
$Id: chapter.sgml,v 1.2 1999-07-14 19:25:40 nik Exp $
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<chapter id="overview">
|
<chapter id="overview">
|
||||||
<title>Overview</title>
|
<title>Overview</title>
|
||||||
|
|
||||||
<para>Welcome to the FreeBSD Documentation Project, and thank you for
|
<para>Welcome to the FreeBSD Documentation Project. Good quality
|
||||||
volunteering. One of the keys to the success of a project such as FreeBSD
|
documentation is very important to the success of FreeBSD, and the
|
||||||
is the availability of good quality documentation, and your contribution
|
FreeBSD Documentation Project (FDP) is how a lot of that documentation
|
||||||
will help that success.</para>
|
is produced. Your contributions are very valuable.</para>
|
||||||
|
|
||||||
<para>After you have read this primer you should;</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>
|
||||||
|
|
||||||
|
<para>Every one is welcome to join the FDP. There is no minimum
|
||||||
|
membership requirements, 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>
|
||||||
|
|
||||||
|
<para>After you have finished reading this document you should:</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Have an understanding of the text formats used by the
|
<para>Know which documentation is maintained by the FDP.</para>
|
||||||
Documentation Project, and why they were chosen.</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Be able to read and understand the source code for the Handbook,
|
<para>Be able to read and understand the SGML source code for the
|
||||||
FAQ, and website, and follow how they are converted into HTML,
|
documentation maintained by the FDP.</para>
|
||||||
PostScript, and other formats.</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Be able to make changes to the documentation, test them, and
|
<para>Be able to make changes to the documentation.</para>
|
||||||
either contribute them back to the project or (if you have commit
|
</listitem>
|
||||||
privileges) commit them.</para>
|
|
||||||
|
<listitem>
|
||||||
|
<para>Be able to submit your changes back for review and eventual
|
||||||
|
inclusion in the FreeBSD documentation.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
|
||||||
<para>This primer assumes that you already understand;</para>
|
<sect1>
|
||||||
|
<title>The FreeBSD Documentation Set</title>
|
||||||
|
|
||||||
<itemizedlist>
|
<para>The FDP is responsible for four categories of FreeBSD
|
||||||
<listitem>
|
documentation.</para>
|
||||||
<para>How to maintain an up-to-date copy of the FreeBSD CVS tree using
|
|
||||||
CVS and one of CVSup or CTM, and how to check out particular versions
|
|
||||||
of files.</para>
|
|
||||||
|
|
||||||
<para>Alternatively, how to retrieve versions of files using the
|
<variablelist>
|
||||||
<application>CVSWeb</application> interface.</para>
|
<varlistentry>
|
||||||
|
<term>Manual pages</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The English language system manual pages are not written by
|
||||||
|
the FDP, as they are part of the base system. However, the FDP can
|
||||||
|
(and has) re-worded parts of existing manual pages to make them
|
||||||
|
clearer, or to correct inaccuracies.</para>
|
||||||
|
|
||||||
|
<para>The translation teams are responsible for translating the
|
||||||
|
system manual pages in to different languages. These translations
|
||||||
|
are kept within the FDP.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>FAQ</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The FAQ aims to address (in short question and answer format)
|
||||||
|
questions that are asked, or should be asked, on the various
|
||||||
|
mailing lists and newsgroups devoted to FreeBSD. The format does
|
||||||
|
not permit long and comprehensive answers.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>Handbook</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The Handbook aims to be the comprehensive on-line resource and
|
||||||
|
reference for FreeBSD users.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>Web site</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>This is the main FreeBSD presence on the World Wide Web,
|
||||||
|
visible at <ulink
|
||||||
|
url="http://www.freebsd.org/">http://www.freebsd.org/</ulink>
|
||||||
|
and many mirrors around the world. The web site is many people's
|
||||||
|
first exposure to FreeBSD.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
</variablelist>
|
||||||
|
|
||||||
|
<para>These four groups of documentation are all available in the
|
||||||
|
FreeBSD CVS tree. This means that the logs and changes to these
|
||||||
|
files are visible to anyone, and anyone can use a program such as
|
||||||
|
<application>CVSup</application> or
|
||||||
|
<application>CTM</application> to keep their own local copies of
|
||||||
|
this documentation.</para>
|
||||||
|
|
||||||
|
<para>In addition, many people have written tutorials or other web
|
||||||
|
sites relating to FreeBSD. Some of these are stored in the CVS
|
||||||
|
repository as well (where the author has agreed to this). In
|
||||||
|
other cases the author has decided to keep their documentation
|
||||||
|
separate from the main FreeBSD repository. The FDP endeavours to
|
||||||
|
provide links to as much of this documentation as
|
||||||
|
possible.</para>
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<sect1>
|
||||||
|
<title>Before you start</title>
|
||||||
|
|
||||||
|
<para>This document assumes that you already know:</para>
|
||||||
|
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>How to maintain an up-to-date local copy of the FreeBSD
|
||||||
|
documentation. Either by maintaining a local copy of the
|
||||||
|
FreeBSD CVS repository (using <application>CVS</application>
|
||||||
|
and either <application>CVSup</application> or
|
||||||
|
<application>CTM</application>) or by using
|
||||||
|
<application>CVSup</application> to download just a
|
||||||
|
<emphasis>checked-out</emphasis> copy.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>How to use the ports system to download and install new
|
<para>How to download and install new software using either the
|
||||||
software.</para>
|
FreeBSD Ports system or &man.pkg.add.1;.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
</sect1>
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
|
|
|
||||||
|
|
@ -26,54 +26,144 @@
|
||||||
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||||
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
||||||
POSSIBILITY OF SUCH DAMAGE.
|
POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
|
||||||
|
$Id: chapter.sgml,v 1.2 1999-07-14 19:25:40 nik Exp $
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<chapter id="overview">
|
<chapter id="overview">
|
||||||
<title>Overview</title>
|
<title>Overview</title>
|
||||||
|
|
||||||
<para>Welcome to the FreeBSD Documentation Project, and thank you for
|
<para>Welcome to the FreeBSD Documentation Project. Good quality
|
||||||
volunteering. One of the keys to the success of a project such as FreeBSD
|
documentation is very important to the success of FreeBSD, and the
|
||||||
is the availability of good quality documentation, and your contribution
|
FreeBSD Documentation Project (FDP) is how a lot of that documentation
|
||||||
will help that success.</para>
|
is produced. Your contributions are very valuable.</para>
|
||||||
|
|
||||||
<para>After you have read this primer you should;</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>
|
||||||
|
|
||||||
|
<para>Every one is welcome to join the FDP. There is no minimum
|
||||||
|
membership requirements, 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>
|
||||||
|
|
||||||
|
<para>After you have finished reading this document you should:</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Have an understanding of the text formats used by the
|
<para>Know which documentation is maintained by the FDP.</para>
|
||||||
Documentation Project, and why they were chosen.</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Be able to read and understand the source code for the Handbook,
|
<para>Be able to read and understand the SGML source code for the
|
||||||
FAQ, and website, and follow how they are converted into HTML,
|
documentation maintained by the FDP.</para>
|
||||||
PostScript, and other formats.</para>
|
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>Be able to make changes to the documentation, test them, and
|
<para>Be able to make changes to the documentation.</para>
|
||||||
either contribute them back to the project or (if you have commit
|
</listitem>
|
||||||
privileges) commit them.</para>
|
|
||||||
|
<listitem>
|
||||||
|
<para>Be able to submit your changes back for review and eventual
|
||||||
|
inclusion in the FreeBSD documentation.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
|
||||||
<para>This primer assumes that you already understand;</para>
|
<sect1>
|
||||||
|
<title>The FreeBSD Documentation Set</title>
|
||||||
|
|
||||||
<itemizedlist>
|
<para>The FDP is responsible for four categories of FreeBSD
|
||||||
<listitem>
|
documentation.</para>
|
||||||
<para>How to maintain an up-to-date copy of the FreeBSD CVS tree using
|
|
||||||
CVS and one of CVSup or CTM, and how to check out particular versions
|
|
||||||
of files.</para>
|
|
||||||
|
|
||||||
<para>Alternatively, how to retrieve versions of files using the
|
<variablelist>
|
||||||
<application>CVSWeb</application> interface.</para>
|
<varlistentry>
|
||||||
|
<term>Manual pages</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The English language system manual pages are not written by
|
||||||
|
the FDP, as they are part of the base system. However, the FDP can
|
||||||
|
(and has) re-worded parts of existing manual pages to make them
|
||||||
|
clearer, or to correct inaccuracies.</para>
|
||||||
|
|
||||||
|
<para>The translation teams are responsible for translating the
|
||||||
|
system manual pages in to different languages. These translations
|
||||||
|
are kept within the FDP.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>FAQ</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The FAQ aims to address (in short question and answer format)
|
||||||
|
questions that are asked, or should be asked, on the various
|
||||||
|
mailing lists and newsgroups devoted to FreeBSD. The format does
|
||||||
|
not permit long and comprehensive answers.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>Handbook</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>The Handbook aims to be the comprehensive on-line resource and
|
||||||
|
reference for FreeBSD users.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term>Web site</term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>This is the main FreeBSD presence on the World Wide Web,
|
||||||
|
visible at <ulink
|
||||||
|
url="http://www.freebsd.org/">http://www.freebsd.org/</ulink>
|
||||||
|
and many mirrors around the world. The web site is many people's
|
||||||
|
first exposure to FreeBSD.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
</variablelist>
|
||||||
|
|
||||||
|
<para>These four groups of documentation are all available in the
|
||||||
|
FreeBSD CVS tree. This means that the logs and changes to these
|
||||||
|
files are visible to anyone, and anyone can use a program such as
|
||||||
|
<application>CVSup</application> or
|
||||||
|
<application>CTM</application> to keep their own local copies of
|
||||||
|
this documentation.</para>
|
||||||
|
|
||||||
|
<para>In addition, many people have written tutorials or other web
|
||||||
|
sites relating to FreeBSD. Some of these are stored in the CVS
|
||||||
|
repository as well (where the author has agreed to this). In
|
||||||
|
other cases the author has decided to keep their documentation
|
||||||
|
separate from the main FreeBSD repository. The FDP endeavours to
|
||||||
|
provide links to as much of this documentation as
|
||||||
|
possible.</para>
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<sect1>
|
||||||
|
<title>Before you start</title>
|
||||||
|
|
||||||
|
<para>This document assumes that you already know:</para>
|
||||||
|
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>How to maintain an up-to-date local copy of the FreeBSD
|
||||||
|
documentation. Either by maintaining a local copy of the
|
||||||
|
FreeBSD CVS repository (using <application>CVS</application>
|
||||||
|
and either <application>CVSup</application> or
|
||||||
|
<application>CTM</application>) or by using
|
||||||
|
<application>CVSup</application> to download just a
|
||||||
|
<emphasis>checked-out</emphasis> copy.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>How to use the ports system to download and install new
|
<para>How to download and install new software using either the
|
||||||
software.</para>
|
FreeBSD Ports system or &man.pkg.add.1;.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
</sect1>
|
||||||
</chapter>
|
</chapter>
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue