Update the preface to describe the new organization of the Handbook

into 5 logical parts.  Reorder the brief description of each chapter
to conform to the new layout.

Obtained from:	FreeBSD Mall, Inc. Third Edition FreeBSD Handbook
This commit is contained in:
Murray Stokely 2004-07-13 08:52:37 +00:00
parent 9ced89b347
commit e489a014cc
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=21479

View file

@ -123,20 +123,28 @@
<bridgehead id="preface-overview" renderas=sect1>Organization of This <bridgehead id="preface-overview" renderas=sect1>Organization of This
Book</bridgehead> Book</bridgehead>
<para>This book is split into three logically distinct sections. <para>This book is split into five logically distinct sections.
The first section, <emphasis>Getting Started</emphasis>, covers The first section, <emphasis>Getting Started</emphasis>, covers
the installation and basic usage of FreeBSD. It is expected that the installation and basic usage of FreeBSD. It is expected that
the reader will follow these chapters in sequence, possibly the reader will follow these chapters in sequence, possibly
skipping chapters covering familiar topics. The second section, skipping chapters covering familiar topics. The second section,
<emphasis>System Administration</emphasis>, covers a broad <emphasis>Common Tasks</emphasis>, covers some frequently used
collection of subjects that are of interest to more advanced features of FreeBSD. This section, and all subsequent sections,
FreeBSD users. Each section begins with a succinct synopsis that can be read out of order. Each chapter begins with a succinct
synopsis that
describes what the chapter covers and what the reader is expected describes what the chapter covers and what the reader is expected
to already know. This is meant to allow the casual reader to skip to already know. This is meant to allow the casual reader to skip
around to find chapters of interest. The third section contains around to find chapters of interest. The third section,
<emphasis>System Administration</emphasis>, covers administration
topics. The fourth section, <emphasis>Network
Communication</emphasis>, covers networking and server topics.
The fifth section contains
appendices of reference information.</para> appendices of reference information.</para>
<variablelist> <variablelist>
<!-- Part I - Introduction -->
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="introduction">, Introduction</emphasis></term> <term><emphasis><xref linkend="introduction">, Introduction</emphasis></term>
<listitem> <listitem>
@ -177,6 +185,53 @@
desktop environments such as <application>KDE</application> and <application>GNOME</application>.</para> desktop environments such as <application>KDE</application> and <application>GNOME</application>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<!-- Part II Common Tasks -->
<varlistentry>
<term><emphasis><xref linkend="desktop">, Desktop Applications</emphasis></term>
<listitem>
<para>Lists some common desktop applications, such as web browsers
and productivity suites, and describes how to install them on
FreeBSD.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="multimedia">, Multimedia</emphasis></term>
<listitem>
<para>Shows how to set up sound and video playback support for your
system. Also describes some sample audio and video applications.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="kernelconfig">, Configuring the FreeBSD
Kernel</emphasis></term>
<listitem>
<para>Explains why you might need to configure a new kernel
and provides detailed instructions for configuring, building,
and installing a custom kernel.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="printing">, Printing</emphasis></term>
<listitem>
<para>Describes managing printers on FreeBSD, including
information about banner pages, printer accounting, and
initial setup.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="linuxemu">, Linux Binary Compatibility</emphasis></term>
<listitem>
<para>Describes the Linux compatibility features of FreeBSD.
Also provides detailed installation instructions for many
popular Linux applications such as <application>&oracle;</application>, <application>&sap.r3;</application>, and
<application>&mathematica;</application>.</para>
</listitem>
</varlistentry>
<!-- Part III - System Administration -->
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="config-tuning">, Configuration and Tuning</emphasis></term> <term><emphasis><xref linkend="config-tuning">, Configuration and Tuning</emphasis></term>
<listitem> <listitem>
@ -202,15 +257,6 @@
set on users and other account management tasks.</para> set on users and other account management tasks.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><emphasis><xref linkend="kernelconfig">, Configuring the FreeBSD
Kernel</emphasis></term>
<listitem>
<para>Explains why you might need to configure a new kernel
and provides detailed instructions for configuring, building,
and installing a custom kernel.</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="security">, Security</emphasis></term> <term><emphasis><xref linkend="security">, Security</emphasis></term>
<listitem> <listitem>
@ -226,14 +272,6 @@
mechanism can be used to secure a FreeBSD system.</para> mechanism can be used to secure a FreeBSD system.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><emphasis><xref linkend="printing">, Printing</emphasis></term>
<listitem>
<para>Describes managing printers on FreeBSD, including
information about banner pages, printer accounting, and
initial setup.</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="disks">, Storage</emphasis></term> <term><emphasis><xref linkend="disks">, Storage</emphasis></term>
<listitem> <listitem>
@ -260,20 +298,17 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="desktop">, Desktop Applications</emphasis></term> <term><emphasis><xref linkend="cutting-edge">, The Cutting Edge</emphasis></term>
<listitem> <listitem>
<para>Lists some common desktop applications, such as web browsers <para>Explains the differences between FreeBSD-STABLE,
and productivity suites, and describes how to install them on FreeBSD-CURRENT, and FreeBSD releases. Describes which users
FreeBSD.</para> would benefit from tracking a development system and outlines
</listitem> that process.</para>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="multimedia">, Multimedia</emphasis></term>
<listitem>
<para>Shows how to set up sound and video playback support for your
system. Also describes some sample audio and video applications.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<!-- Part IV - Network Communications -->
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="serialcomms">, Serial Communications</emphasis></term> <term><emphasis><xref linkend="serialcomms">, Serial Communications</emphasis></term>
<listitem> <listitem>
@ -289,12 +324,12 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="advanced-networking">, Advanced Networking</emphasis></term> <term><emphasis><xref linkend="mail">, Electronic Mail</emphasis></term>
<listitem> <listitem>
<para>Describes many networking topics, including sharing an <para>Explains the different components of an email server and
Internet connection with other computers on your LAN, advanced dives into simple configuration topics for the most popular
routing topics, wireless networking, bluetooth, ATM, IPv6, and mail server software:
much more.</para> <application>sendmail</application>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -307,32 +342,17 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="mail">, Electronic Mail</emphasis></term> <term><emphasis><xref linkend="advanced-networking">, Advanced Networking</emphasis></term>
<listitem> <listitem>
<para>Explains the different components of an email server and <para>Describes many networking topics, including sharing an
dives into simple configuration topics for the most popular Internet connection with other computers on your LAN, advanced
mail server software: routing topics, wireless networking, bluetooth, ATM, IPv6, and
<application>sendmail</application>.</para> much more.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="cutting-edge">, The Cutting Edge</emphasis></term>
<listitem>
<para>Explains the differences between FreeBSD-STABLE,
FreeBSD-CURRENT, and FreeBSD releases. Describes which users
would benefit from tracking a development system and outlines
that process.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis><xref linkend="linuxemu">, Linux Binary Compatibility</emphasis></term>
<listitem>
<para>Describes the Linux compatibility features of FreeBSD.
Also provides detailed installation instructions for many
popular Linux applications such as <application>&oracle;</application>, <application>&sap.r3;</application>, and
<application>&mathematica;</application>.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<!-- Part V - Appendices -->
<varlistentry> <varlistentry>
<term><emphasis><xref linkend="mirrors">, Obtaining FreeBSD </emphasis></term> <term><emphasis><xref linkend="mirrors">, Obtaining FreeBSD </emphasis></term>
<listitem> <listitem>