diff options
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/preface/preface.xml')
| -rw-r--r-- | en_US.ISO8859-1/books/handbook/preface/preface.xml | 63 |
1 files changed, 24 insertions, 39 deletions
diff --git a/en_US.ISO8859-1/books/handbook/preface/preface.xml b/en_US.ISO8859-1/books/handbook/preface/preface.xml index c353e84b13..c1b53a7ba8 100644 --- a/en_US.ISO8859-1/books/handbook/preface/preface.xml +++ b/en_US.ISO8859-1/books/handbook/preface/preface.xml @@ -2,11 +2,10 @@ <!-- $FreeBSD$ --> - -<preface id="book-preface"> +<preface xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="book-preface"> <title>Preface</title> - <bridgehead id="preface-audience" renderas="sect1">Intended + <bridgehead xml:id="preface-audience" renderas="sect1">Intended Audience</bridgehead> <para>The &os; newcomer will find that the first section of this @@ -26,7 +25,7 @@ <para>For a list of additional sources of information, please see <xref linkend="bibliography"/>.</para> - <bridgehead id="preface-changes-from3" renderas="sect1">Changes + <bridgehead xml:id="preface-changes-from3" renderas="sect1">Changes from the Third Edition</bridgehead> <para>The current online version of the Handbook represents the @@ -64,7 +63,7 @@ </listitem> </itemizedlist> - <bridgehead id="preface-changes-from2" renderas="sect1">Changes + <bridgehead xml:id="preface-changes-from2" renderas="sect1">Changes from the Second Edition (2004)</bridgehead> <para>The third edition was the culmination of over two years of @@ -101,8 +100,7 @@ </listitem> <listitem> - <para>A troubleshooting section has been added to <xref - linkend="ppp-and-slip"/>.</para> + <para>A troubleshooting section has been added to <xref linkend="ppp-and-slip"/>.</para> </listitem> <listitem> @@ -119,8 +117,7 @@ the <application>Apache HTTP Server</application>, <application>ftpd</application>, and setting up a server for µsoft; &windows; clients with - <application>Samba</application>. Some sections from <xref - linkend="advanced-networking"/> were moved here to improve + <application>Samba</application>. Some sections from <xref linkend="advanced-networking"/> were moved here to improve the presentation.</para> </listitem> @@ -143,7 +140,7 @@ </listitem> </itemizedlist> - <bridgehead id="preface-changes" renderas="sect1">Changes from the + <bridgehead xml:id="preface-changes" renderas="sect1">Changes from the First Edition (2001)</bridgehead> <para>The second edition was the culmination of over two years of @@ -212,8 +209,7 @@ updated.</para> </listitem> <listitem> - <para>Many new sections have been added to <xref - linkend="advanced-networking"/>.</para> + <para>Many new sections have been added to <xref linkend="advanced-networking"/>.</para> </listitem> <listitem> <para><xref linkend="mail"/> has been expanded to include more @@ -231,8 +227,7 @@ edition:</para> <itemizedlist> <listitem> - <para><xref - linkend="config-tuning"/>.</para> + <para><xref linkend="config-tuning"/>.</para> </listitem> <listitem> <para><xref linkend="multimedia"/>.</para> @@ -241,7 +236,7 @@ </listitem> </itemizedlist> - <bridgehead id="preface-overview" renderas="sect1">Organization of + <bridgehead xml:id="preface-overview" renderas="sect1">Organization of This Book</bridgehead> <para>This book is split into five logically distinct sections. @@ -366,8 +361,7 @@ <!-- Part III - System Administration --> <varlistentry> - <term><emphasis><xref - linkend="config-tuning"/></emphasis></term> + <term><emphasis><xref linkend="config-tuning"/></emphasis></term> <listitem> <para>Describes the parameters available for system administrators to tune a &os; system for optimum @@ -438,8 +432,7 @@ </listitem> </varlistentry> <varlistentry> - <term><emphasis><xref - linkend="virtualization"/></emphasis></term> + <term><emphasis><xref linkend="virtualization"/></emphasis></term> <listitem> <para>Describes what virtualization systems offer, and how they can be used with &os;.</para> @@ -454,8 +447,7 @@ </listitem> </varlistentry> <varlistentry> - <term><emphasis><xref - linkend="updating-upgrading"/></emphasis></term> + <term><emphasis><xref linkend="updating-upgrading"/></emphasis></term> <listitem> <para>Explains the differences between &os;-STABLE, &os;-CURRENT, and &os; releases. Describes which users @@ -502,8 +494,7 @@ </listitem> </varlistentry> <varlistentry> - <term><emphasis><xref - linkend="network-servers"/></emphasis></term> + <term><emphasis><xref linkend="network-servers"/></emphasis></term> <listitem> <para>Provides detailed instructions and example configuration files to set up your &os; machine as a network filesystem @@ -520,8 +511,7 @@ </listitem> </varlistentry> <varlistentry> - <term><emphasis><xref - linkend="advanced-networking"/></emphasis></term> + <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, @@ -566,14 +556,13 @@ </varlistentry> </variablelist> - <bridgehead id="preface-conv" renderas="sect1">Conventions used + <bridgehead xml:id="preface-conv" renderas="sect1">Conventions used in this book</bridgehead> <para>To provide a consistent and easy to read text, several conventions are followed throughout the book.</para> - <bridgehead id="preface-conv-typographic" - renderas="sect2">Typographic + <bridgehead xml:id="preface-conv-typographic" renderas="sect2">Typographic Conventions</bridgehead> <variablelist> @@ -604,8 +593,7 @@ </variablelist> <!-- Var list --> - <bridgehead id="preface-conv-commands" - renderas="sect2">User Input</bridgehead> + <bridgehead xml:id="preface-conv-commands" renderas="sect2">User Input</bridgehead> <para>Keys are shown in <keycap>bold</keycap> to stand out from other text. Key combinations that are meant to be typed @@ -640,10 +628,9 @@ keys simultaneously.</para> <!-- How to type in key stokes, etc.. --> - <bridgehead id="preface-conv-examples" - renderas="sect2">Examples</bridgehead> + <bridgehead xml:id="preface-conv-examples" renderas="sect2">Examples</bridgehead> - <para>Examples starting with <devicename>C:\></devicename> + <para>Examples starting with <filename>C:\></filename> indicate a &ms-dos; command. Unless otherwise noted, these commands may be executed from a <quote>Command Prompt</quote> window in a modern µsoft.windows; @@ -653,7 +640,7 @@ <para>Examples starting with &prompt.root; indicate a command that must be invoked as the superuser in &os;. You can login as - <username>root</username> to type the command, or login as your + <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> @@ -666,8 +653,7 @@ <screen>&prompt.user; <userinput>top</userinput></screen> - <bridgehead id="preface-acknowledgements" - renderas="sect1">Acknowledgments</bridgehead> + <bridgehead xml:id="preface-acknowledgements" renderas="sect1">Acknowledgments</bridgehead> <para>The book you are holding represents the efforts of many hundreds of people around the world. Whether they sent in fixes @@ -677,7 +663,7 @@ <para>Several companies have supported the development of this document by paying authors to work on it full-time, paying for publication, etc. In particular, BSDi (subsequently acquired by - <ulink url="http://www.windriver.com">Wind River Systems</ulink>) + <link xlink:href="http://www.windriver.com">Wind River Systems</link>) paid members of the &os; Documentation Project to work on improving this book full time leading up to the publication of the first printed edition in March 2000 (ISBN 1-57176-241-8). Wind @@ -685,8 +671,7 @@ number of improvements to the print-output infrastructure and to add additional chapters to the text. This work culminated in the publication of the second printed edition in November 2001 - (ISBN 1-57176-303-1). In 2003-2004, <ulink - url="http://www.freebsdmall.com">&os; Mall, Inc</ulink>, paid + (ISBN 1-57176-303-1). In 2003-2004, <link xlink:href="http://www.freebsdmall.com">&os; Mall, Inc</link>, paid several contributors to improve the Handbook in preparation for the third printed edition.</para> |