From owner-svn-doc-head@FreeBSD.ORG  Wed Dec  3 15:49:41 2014
Return-Path: <owner-svn-doc-head@FreeBSD.ORG>
Delivered-To: svn-doc-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 11101587;
 Wed,  3 Dec 2014 15:49:41 +0000 (UTC)
Received: from svn.freebsd.org (svn.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id F0A0BC2E;
 Wed,  3 Dec 2014 15:49:40 +0000 (UTC)
Received: from svn.freebsd.org ([127.0.1.70])
 by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id sB3Fneua060662;
 Wed, 3 Dec 2014 15:49:40 GMT (envelope-from bcr@FreeBSD.org)
Received: (from bcr@localhost)
 by svn.freebsd.org (8.14.9/8.14.9/Submit) id sB3FneiH060661;
 Wed, 3 Dec 2014 15:49:40 GMT (envelope-from bcr@FreeBSD.org)
Message-Id: <201412031549.sB3FneiH060661@svn.freebsd.org>
X-Authentication-Warning: svn.freebsd.org: bcr set sender to bcr@FreeBSD.org
 using -f
From: Benedict Reuschling <bcr@FreeBSD.org>
Date: Wed, 3 Dec 2014 15:49:40 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r46055 - head/en_US.ISO8859-1/books/handbook/preface
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-head@freebsd.org
X-Mailman-Version: 2.1.18-1
Precedence: list
List-Id: SVN commit messages for the doc tree for head
 <svn-doc-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-head/>
List-Post: <mailto:svn-doc-head@freebsd.org>
List-Help: <mailto:svn-doc-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-head>,
 <mailto:svn-doc-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 03 Dec 2014 15:49:41 -0000

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;&nbsp;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;&nbsp;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>