svn commit: r46055 - head/en_US.ISO8859-1/books/handbook/preface
Benedict Reuschling
bcr at FreeBSD.org
Wed Dec 3 15:49:41 UTC 2014
Author: bcr
Date: Wed Dec 3 15:49:40 2014
New Revision: 46055
URL: https://svnweb.freebsd.org/changeset/doc/46055
Log:
Whitespace fixes:
- break listitem tags to their own line (down from term tags)
- add an empty line between term and listitem tags
- add an empty line between consecutive varlistentry tags
This change is purely cosmetical to conform to our block element
formatting guidelines layed out in the FDP primer. It also silences
igor(8) in the standard invocation. Translators can ignore.
Obtained from: igor(8) output
Modified:
head/en_US.ISO8859-1/books/handbook/preface/preface.xml
Modified: head/en_US.ISO8859-1/books/handbook/preface/preface.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/preface/preface.xml Tue Dec 2 22:26:57 2014 (r46054)
+++ head/en_US.ISO8859-1/books/handbook/preface/preface.xml Wed Dec 3 15:49:40 2014 (r46055)
@@ -103,7 +103,8 @@
<listitem>
<para>A troubleshooting section has been added to <xref
- linkend="ppp-and-slip"/>.</para> </listitem>
+ linkend="ppp-and-slip"/>.</para>
+ </listitem>
<listitem>
<para><xref linkend="mail"/> has been expanded with new
@@ -156,45 +157,54 @@
<listitem>
<para>A complete Index has been added.</para>
</listitem>
+
<listitem>
<para>All ASCII figures have been replaced by graphical
diagrams.</para>
</listitem>
+
<listitem>
<para>A standard synopsis has been added to each chapter to
give a quick summary of what information the chapter
contains, and what the reader is expected to know.</para>
</listitem>
+
<listitem>
<para>The content has been logically reorganized into three
parts: <quote>Getting Started</quote>, <quote>System
Administration</quote>, and
<quote>Appendices</quote>.</para>
</listitem>
+
<listitem>
<para><xref linkend="install"/> was completely rewritten with
many screenshots to make it much easier for new users to
grasp the text.</para>
</listitem>
+
<listitem>
<para><xref linkend="basics"/> has been expanded to contain
additional information about processes, daemons, and
signals.</para>
</listitem>
+
<listitem>
<para><xref linkend="ports"/> has been expanded to contain
additional information about binary package
management.</para>
</listitem>
+
<listitem>
<para><xref linkend="x11"/> has been completely rewritten with
an emphasis on using modern desktop technologies such as
<application>KDE</application> and
<application>GNOME</application> on &xfree86; 4.X.</para>
</listitem>
+
<listitem>
<para><xref linkend="boot"/> has been expanded.</para>
</listitem>
+
<listitem>
<para><xref linkend="disks"/> has been written from what used
to be two separate chapters on <quote>Disks</quote> and
@@ -203,35 +213,44 @@
on RAID (both hardware and software) has also been
added.</para>
</listitem>
+
<listitem>
<para><xref linkend="serialcomms"/> has been completely
reorganized and updated for &os; 4.X/5.X.</para>
</listitem>
+
<listitem>
<para><xref linkend="ppp-and-slip"/> has been substantially
updated.</para>
</listitem>
+
<listitem>
<para>Many new sections have been added to <xref
- linkend="advanced-networking"/>.</para> </listitem>
+ linkend="advanced-networking"/>.</para>
+ </listitem>
+
<listitem>
<para><xref linkend="mail"/> has been expanded to include more
information about configuring
<application>sendmail</application>.</para>
</listitem>
+
<listitem>
<para><xref linkend="linuxemu"/> has been expanded to include
information about installing
<application>&oracle;</application> and
<application>&sap.r3;</application>.</para>
</listitem>
+
<listitem>
<para>The following new topics are covered in this second
edition:</para>
+
<itemizedlist>
<listitem>
<para><xref linkend="config-tuning"/>.</para>
</listitem>
+
<listitem>
<para><xref linkend="multimedia"/>.</para>
</listitem>
@@ -265,22 +284,27 @@
<varlistentry>
<term><emphasis><xref linkend="introduction"/></emphasis></term>
+
<listitem>
<para>Introduces &os; to a new user. It describes the
history of the &os; Project, its goals and development
model.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="bsdinstall"/></emphasis></term>
+
<listitem>
<para>Walks a user through the entire installation process of
&os; 9.<replaceable>x</replaceable> and later using
<application>bsdinstall</application>.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="install"/></emphasis></term>
+
<listitem>
<para>Walks a user through the entire installation process of
&os; 8.<replaceable>x</replaceable> and earlier using
@@ -289,8 +313,10 @@
console, are also covered.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="basics"/></emphasis></term>
+
<listitem>
<para>Covers the basic commands and functionality of the
&os; operating system. If you are familiar with &linux;
@@ -298,16 +324,20 @@
chapter.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="ports"/></emphasis></term>
+
<listitem>
<para>Covers the installation of third-party software with
both &os;'s innovative <quote>Ports Collection</quote> and
standard binary packages.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="x11"/></emphasis></term>
+
<listitem>
<para>Describes the X Window System in general and using X11
on &os; in particular. Also describes common desktop
@@ -320,12 +350,14 @@
<varlistentry>
<term><emphasis><xref linkend="desktop"/></emphasis></term>
+
<listitem>
<para>Lists some common desktop applications, such as web
browsers and productivity suites, and describes how to
install them on &os;.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="multimedia"/></emphasis></term>
<listitem>
@@ -334,24 +366,30 @@
applications.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="kernelconfig"/></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"/></emphasis></term>
+
<listitem>
<para>Describes managing printers on &os;, including
information about banner pages, printer accounting, and
initial setup.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="linuxemu"/></emphasis></term>
+
<listitem>
<para>Describes the &linux; compatibility features of &os;.
Also provides detailed installation instructions for many
@@ -365,45 +403,57 @@
<varlistentry>
<term><emphasis><xref
- linkend="config-tuning"/></emphasis></term> <listitem>
+ linkend="config-tuning"/></emphasis></term>
+
+ <listitem>
<para>Describes the parameters available for system
administrators to tune a &os; system for optimum
performance. Also describes the various configuration files
used in &os; and where to find them.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="boot"/></emphasis></term>
+
<listitem>
<para>Describes the &os; boot process and explains how to
control this process with configuration options.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="security"/></emphasis></term>
+
<listitem>
<para>Describes many different tools available to help keep
your &os; system secure, including Kerberos, IPsec and
OpenSSH.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="jails"/></emphasis></term>
+
<listitem>
<para>Describes the jails framework, and the improvements of
jails over the traditional chroot support of &os;.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="mac"/></emphasis></term>
+
<listitem>
<para>Explains what Mandatory Access Control (MAC) is and
how this mechanism can be used to secure a &os;
system.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="audit"/></emphasis></term>
+
<listitem>
<para>Describes what &os; Event Auditing is, how it can be
installed, configured, and how audit trails can be inspected
@@ -413,6 +463,7 @@
<varlistentry>
<term><emphasis><xref linkend="disks"/></emphasis></term>
+
<listitem>
<para>Describes how to manage storage media and filesystems
with &os;. This includes physical disks, RAID arrays,
@@ -420,38 +471,49 @@
filesystems.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="geom"/></emphasis></term>
+
<listitem>
<para>Describes what the GEOM framework in &os; is and how
to configure various supported RAID levels.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="filesystems"/></emphasis></term>
+
<listitem>
<para>Examines support of non-native file systems in &os;,
like the Z File System from &sun;.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref
- linkend="virtualization"/></emphasis></term> <listitem>
+ linkend="virtualization"/></emphasis></term>
+
+ <listitem>
<para>Describes what virtualization systems offer, and how
they can be used with &os;.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="l10n"/></emphasis></term>
+
<listitem>
<para>Describes how to use &os; in languages other than
English. Covers both system and application level
localization.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref
linkend="updating-upgrading"/></emphasis></term>
+
<listitem>
<para>Explains the differences between &os;-STABLE,
&os;-CURRENT, and &os; releases. Describes which users
@@ -461,8 +523,10 @@
release.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="dtrace"/></emphasis></term>
+
<listitem>
<para>Describes how to configure and use the &dtrace; tool
from &sun; in &os;. Dynamic tracing can help locate
@@ -475,21 +539,26 @@
<varlistentry>
<term><emphasis><xref linkend="serialcomms"/></emphasis></term>
+
<listitem>
<para>Explains how to connect terminals and modems to your
&os; system for both dial in and dial out
connections.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="ppp-and-slip"/></emphasis></term>
+
<listitem>
<para>Describes how to use PPP to connect to remote systems
with &os;.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="mail"/></emphasis></term>
+
<listitem>
<para>Explains the different components of an email server
and dives into simple configuration topics for the most
@@ -497,26 +566,33 @@
<application>sendmail</application>.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref
- linkend="network-servers"/></emphasis></term> <listitem>
+ linkend="network-servers"/></emphasis></term>
+
+ <listitem>
<para>Provides detailed instructions and example configuration
files to set up your &os; machine as a network filesystem
server, domain name server, network information system
server, or time synchronization server.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="firewalls"/></emphasis></term>
+
<listitem>
<para>Explains the philosophy behind software-based firewalls
and provides detailed information about the configuration
of the different firewalls available for &os;.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref
linkend="advanced-networking"/></emphasis></term>
+
<listitem>
<para>Describes many networking topics, including sharing an
Internet connection with other computers on your LAN,
@@ -529,14 +605,17 @@
<varlistentry>
<term><emphasis><xref linkend="mirrors"/></emphasis></term>
+
<listitem>
<para>Lists different sources for obtaining &os; media on
CDROM or DVD as well as different sites on the Internet
that allow you to download and install &os;.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="bibliography"/></emphasis></term>
+
<listitem>
<para>This book touches on many different subjects that may
leave you hungry for a more detailed explanation. The
@@ -544,16 +623,20 @@
in the text.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="eresources"/></emphasis></term>
+
<listitem>
<para>Describes the many forums available for &os; users to
post questions and engage in technical conversations about
&os;.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><emphasis><xref linkend="pgpkeys"/></emphasis></term>
+
<listitem>
<para>Lists the PGP fingerprints of several &os;
Developers.</para>
@@ -573,14 +656,17 @@
<variablelist>
<varlistentry>
<term><emphasis>Italic</emphasis></term>
+
<listitem>
<para>An <emphasis>italic</emphasis> font is used for
filenames, URLs, emphasized text, and the first usage of
technical terms.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><literal>Monospace</literal></term>
+
<listitem>
<para>A <literal>monospaced</literal> font is used for error
messages, commands, environment variables, names of ports,
@@ -588,8 +674,10 @@
and code fragments.</para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><application>Bold</application></term>
+
<listitem>
<para>A <application>bold</application> font is used for
applications, commands, and keys.</para>
@@ -647,9 +735,9 @@
<para>Examples starting with &prompt.root; indicate a command that
must be invoked as the superuser in &os;. You can login as
- <systemitem class="username">root</systemitem> to type the command, or login as your
- normal account and use &man.su.1; to gain
- superuser privileges.</para>
+ <systemitem class="username">root</systemitem> to type the
+ command, or login as your normal account and use &man.su.1; to
+ gain superuser privileges.</para>
<screen>&prompt.root; <userinput>dd if=kern.flp of=/dev/fd0</userinput></screen>
More information about the svn-doc-all
mailing list