Date: Wed, 3 Dec 2014 15:49:40 +0000 (UTC) From: Benedict Reuschling <bcr@FreeBSD.org> 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 Message-ID: <201412031549.sB3FneiH060661@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201412031549.sB3FneiH060661>