From owner-svn-doc-all@FreeBSD.ORG Fri Jan 25 00:26:47 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 87C5AADD; Fri, 25 Jan 2013 00:26:47 +0000 (UTC) (envelope-from dru@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 6D33580; Fri, 25 Jan 2013 00:26:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id r0P0QlUU044717; Fri, 25 Jan 2013 00:26:47 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id r0P0QlXT044716; Fri, 25 Jan 2013 00:26:47 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201301250026.r0P0QlXT044716@svn.freebsd.org> From: Dru Lavigne Date: Fri, 25 Jan 2013 00:26:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r40743 - 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-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 25 Jan 2013 00:26:47 -0000 Author: dru Date: Fri Jan 25 00:26:46 2013 New Revision: 40743 URL: http://svnweb.freebsd.org/changeset/doc/40743 Log: White space fix only. Translators can ignore. Approved by: gjb (mentor) 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 Thu Jan 24 23:02:25 2013 (r40742) +++ head/en_US.ISO8859-1/books/handbook/preface/preface.xml Fri Jan 25 00:26:46 2013 (r40743) @@ -11,10 +11,10 @@ The &os; newcomer will find that the first section of this book guides the user through the &os; installation process and - gently introduces the concepts and conventions that underpin &unix;. - Working through this section requires little more than the desire - to explore, and the ability to take on board new concepts as they - are introduced. + gently introduces the concepts and conventions that underpin + &unix;. Working through this section requires little more than + the desire to explore, and the ability to take on board new + concepts as they are introduced. Once you have traveled this far, the second, far larger, section of the Handbook is a comprehensive reference to all manner @@ -23,11 +23,11 @@ this is noted in the synopsis at the beginning of each chapter. - For a list of additional sources of information, please see . + For a list of additional sources of information, please see + . - Changes from the - Third Edition + Changes + from the Third Edition The current online version of the Handbook represents the cumulative effort of many hundreds of contributors over the past @@ -35,125 +35,129 @@ the two volume third edition was published in 2004: - - , &dtrace;, has been added with - information about the powerful &dtrace; performance analysis - tool. - - - - , File Systems Support, has - been added with information about non-native file systems in - &os;, such as ZFS from &sun;. - - - - , Security Event Auditing, has - been added to cover the new auditing capabilities in &os; - and explain its use. - - - - , Virtualization, has - been added with information about installing &os; on - virtualization software. - - - - , Installing - &os; 9.x and Later, has been - added to cover installation of &os; using the new - installation utility, - bsdinstall. - + + , &dtrace;, has been added with + information about the powerful &dtrace; performance analysis + tool. + + + + , File Systems Support, has + been added with information about non-native file systems in + &os;, such as ZFS from &sun;. + + + + , Security Event Auditing, has + been added to cover the new auditing capabilities in &os; + and explain its use. + + + + , Virtualization, has + been added with information about installing &os; on + virtualization software. + + + + , Installing + &os; 9.x and Later, has been + added to cover installation of &os; using the new + installation utility, + bsdinstall. + - Changes from the - Second Edition (2004) + Changes + from the Second Edition (2004) The third edition was the culmination of over two years of - work by the dedicated members of the &os; Documentation - Project. The printed edition grew to such a size that it was - necessary to publish as two separate volumes. The following are - the major changes in this new edition: + work by the dedicated members of the &os; Documentation + Project. The printed edition grew to such a size that it was + necessary to publish as two separate volumes. The following are + the major changes in this new edition: - - , Configuration and - Tuning, has been expanded with new information about the - ACPI power and resource management, the cron system utility, - and more kernel tuning options. - - - - , Security, has been expanded with - new information about virtual private networks (VPNs), file - system access control lists (ACLs), and security - advisories. - - - - , Mandatory Access Control (MAC), is - a new chapter with this edition. It explains what MAC is - and how this mechanism can be used to secure a &os; - system. - - - - , Storage, has been expanded with - new information about USB storage devices, file system - snapshots, file system quotas, file and network backed - filesystems, and encrypted disk partitions. - + + , Configuration and + Tuning, has been expanded with new information about the + ACPI power and resource management, the + cron system utility, and more kernel + tuning options. + + + + , Security, has been expanded + with new information about virtual private networks (VPNs), + file system access control lists (ACLs), and security + advisories. + + + + , Mandatory Access Control (MAC), + is a new chapter with this edition. It explains what MAC is + and how this mechanism can be used to secure a &os; + system. + + + + , Storage, has been expanded with + new information about USB storage devices, file system + snapshots, file system quotas, file and network backed + filesystems, and encrypted disk partitions. + - - , Vinum, is a new chapter + + , Vinum, is a new chapter with this edition. It describes how to use Vinum, a logical volume manager which provides device-independent logical disks, and software RAID-0, RAID-1 and RAID-5. - + - - A troubleshooting section has been added to + A troubleshooting section has been added to , PPP and SLIP. - - - - , Electronic Mail, has been - expanded with new information about using alternative - transport agents, SMTP authentication, UUCP, fetchmail, - procmail, and other advanced topics. - - - - , Network Servers, is - all new with this edition. This chapter includes - information about setting up the Apache HTTP Server, ftpd, - and setting up a server for µsoft; &windows; clients with - Samba. Some sections from , Advanced Networking, were - moved here to improve the presentation. - - - - , Advanced - Networking, has been expanded with new information about - using &bluetooth; devices with &os;, setting up wireless - networks, and Asynchronous Transfer Mode (ATM) - networking. - + - - A glossary has been added to provide a central location - for the definitions of technical terms used throughout the - book. - - - - A number of aesthetic improvements have been made to the - tables and figures throughout the book. - - + + , Electronic Mail, has been + expanded with new information about using alternative + transport agents, SMTP authentication, UUCP, + fetchmail, + procmail, and other advanced + topics. + + + + , Network Servers, is + all new with this edition. This chapter includes + information about setting up the Apache HTTP + Server, ftpd, + and setting up a server for µsoft; &windows; clients + with Samba. Some sections from + , Advanced Networking, + were moved here to improve the presentation. + + + + , Advanced + Networking, has been expanded with new information about + using &bluetooth; devices with &os;, setting up wireless + networks, and Asynchronous Transfer Mode (ATM) + networking. + + + + A glossary has been added to provide a central location + for the definitions of technical terms used throughout the + book. + + + + A number of aesthetic improvements have been made to the + tables and figures throughout the book. + + Changes from the First Edition (2001) @@ -170,88 +174,99 @@ A complete Index has been added. - All ASCII figures have been replaced by graphical diagrams. + All ASCII figures have been replaced by graphical + diagrams. 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. + give a quick summary of what information the chapter + contains, and what the reader is expected to know. The content has been logically reorganized into three - parts: Getting Started, System Administration, and - Appendices. + parts: Getting Started, System + Administration, and + Appendices. - (Installing &os;) was completely - rewritten with many screenshots to make it much easier for new - users to grasp the text. + (Installing + &os;) was completely rewritten with many + screenshots to make it much easier for new users to grasp + the text. - (&unix; Basics) has been expanded to contain - additional information about processes, daemons, and - signals. + (&unix; Basics) + has been expanded to contain additional information about + processes, daemons, and signals. - (Installing Applications) has been expanded - to contain additional information about binary package - management. + (Installing + Applications) has been expanded to contain + additional information about binary package + management. - (The X Window System) has been completely - rewritten with an emphasis on using modern desktop - technologies such as KDE and GNOME on &xfree86; 4.X. + (The X Window + System) has been completely rewritten with an + emphasis on using modern desktop technologies such as + KDE and + GNOME on &xfree86; 4.X. - (The &os; Booting Process) has been - expanded. + (The &os; Booting + Process) has been expanded. - (Storage) has been written from what used - to be two separate chapters on Disks and Backups. We feel - that the topics are easier to comprehend when presented as a - single chapter. A section on RAID (both hardware and - software) has also been added. + (Storage) has + been written from what used to be two separate chapters on + Disks and Backups. We feel + that the topics are easier to comprehend when presented as + a single chapter. A section on RAID (both hardware and + software) has also been added. - (Serial Communications) has been completely - reorganized and updated for &os; 4.X/5.X. + (Serial + Communications) has been completely + reorganized and updated for &os; 4.X/5.X. - (PPP and SLIP) has been substantially - updated. + (PPP and + SLIP) has been substantially updated. - Many new sections have been added to - (Advanced Networking). + Many new sections have been added to + + (Advanced Networking). - (Electronic Mail) has been expanded to - include more information about configuring - sendmail. + (Electronic Mail) + has been expanded to include more information about + configuring sendmail. - (&linux; Compatibility) has been expanded to - include information about installing + (&linux; + Compatibility) has been expanded to include + information about installing &oracle; and - &sap.r3;. + &sap.r3;. The following new topics are covered in this second - edition: + edition: - Configuration and Tuning (). + Configuration and Tuning (). - Multimedia () + Multimedia () - Organization of This - Book + Organization of + This Book This book is split into five logically distinct sections. The first section, Getting Started, covers @@ -276,26 +291,30 @@ - , Introduction + , + Introduction Introduces &os; to a new user. It describes the - history of the &os; Project, its goals and development model. + history of the &os; Project, its goals and development + model. , Installation of - &os; 8.x and Earlier + &os; 8.x and + Earlier Walks a user through the entire installation process of &os; 8.x and earlier using - sysinstall. Some advanced installation - topics, such as installing through a serial console, are also - covered. + sysinstall. Some advanced + installation topics, such as installing through a serial + console, are also covered. , Installation of - &os; 9.x and Later + &os; 9.x and + Later Walks a user through the entire installation process of &os; 9.x and later using @@ -303,71 +322,81 @@ - , &unix; Basics + , &unix; + Basics Covers the basic commands and functionality of the - &os; operating system. If you are familiar with &linux; or - another flavor of &unix; then you can probably skip this - chapter. + &os; operating system. If you are familiar with &linux; + or another flavor of &unix; then you can probably skip this + chapter. - , Installing Applications + , Installing + Applications Covers the installation of third-party software with - both &os;'s innovative Ports Collection and standard - binary packages. + both &os;'s innovative Ports Collection and + standard binary packages. - , The X Window System + , The X Window + System Describes the X Window System in general and using - X11 on &os; in particular. Also describes common - desktop environments such as KDE and GNOME. + X11 on &os; in particular. Also describes common + desktop environments such as KDE + and GNOME. - , Desktop Applications + , Desktop + Applications - Lists some common desktop applications, such as web browsers - and productivity suites, and describes how to install them on - &os;. + Lists some common desktop applications, such as web + browsers and productivity suites, and describes how to + install them on &os;. - , Multimedia + , + Multimedia - Shows how to set up sound and video playback support for your - system. Also describes some sample audio and video applications. + Shows how to set up sound and video playback support + for your system. Also describes some sample audio and video + applications. - , Configuring the &os; - Kernel + , Configuring + the &os; Kernel Explains why you might need to configure a new kernel - and provides detailed instructions for configuring, building, - and installing a custom kernel. + and provides detailed instructions for configuring, + building, and installing a custom kernel. - , Printing + , + Printing Describes managing printers on &os;, including - information about banner pages, printer accounting, and - initial setup. + information about banner pages, printer accounting, and + initial setup. - , &linux; Binary Compatibility + , &linux; Binary + Compatibility Describes the &linux; compatibility features of &os;. - Also provides detailed installation instructions for many - popular &linux; applications such as &oracle; and + Also provides detailed installation instructions for many + popular &linux; applications such as + &oracle; and &mathematica;. @@ -375,19 +404,22 @@ - , Configuration and Tuning + , Configuration + and Tuning 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. + administrators to tune a &os; system for optimum + performance. Also describes the various configuration files + used in &os; and where to find them. - , Booting Process + , Booting + Process Describes the &os; boot process and explains - how to control this process with configuration options. + how to control this process with configuration + options. @@ -400,59 +432,69 @@ - , Security + , + Security - Describes many different tools available to help keep your - &os; system secure, including Kerberos, IPsec and OpenSSH. + Describes many different tools available to help keep + your &os; system secure, including Kerberos, IPsec and + OpenSSH. , Jails - Describes the jails framework, and the improvements of jails - over the traditional chroot support of &os;. + Describes the jails framework, and the improvements of + jails over the traditional chroot support of &os;. - , Mandatory Access Control + , Mandatory Access + Control - Explains what Mandatory Access Control (MAC) is and how this - mechanism can be used to secure a &os; system. + Explains what Mandatory Access Control (MAC) is and + how this mechanism can be used to secure a &os; + system. - , Security Event Auditing + , Security Event + Auditing - Describes what &os; Event Auditing is, how it can be installed, - configured, and how audit trails can be inspected or monitored. + Describes what &os; Event Auditing is, how it can be + installed, configured, and how audit trails can be inspected + or monitored. - , Storage + , + Storage Describes how to manage storage media and filesystems - with &os;. This includes physical disks, RAID arrays, - optical and tape media, memory-backed disks, and network - filesystems. + with &os;. This includes physical disks, RAID arrays, + optical and tape media, memory-backed disks, and network + filesystems. - , GEOM + , + GEOM Describes what the GEOM framework in &os; is and how to configure various supported RAID levels. - , File Systems Support + , File Systems + Support - Examines support of non-native file systems in &os;, like the Z - File System from &sun;. + Examines support of non-native file systems in &os;, + like the Z File System from &sun;. - , Vinum + , + Vinum Describes how to use Vinum, a logical volume manager which provides device-independent logical disks, and @@ -460,66 +502,77 @@ - , Virtualization + , + Virtualization - Describes what virtualization systems offer, and how they - can be used with &os;. + Describes what virtualization systems offer, and how + they can be used with &os;. - , Localization + , + Localization Describes how to use &os; in languages other than - English. Covers both system and application level - localization. + English. Covers both system and application level + localization. - , Updating and Upgrading &os; + , Updating + and Upgrading &os; Explains the differences between &os;-STABLE, - &os;-CURRENT, and &os; releases. Describes which users - would benefit from tracking a development system and outlines - that process. Covers the methods users may take to update their - system to the latest security release. + &os;-CURRENT, and &os; releases. Describes which users + would benefit from tracking a development system and + outlines that process. Covers the methods users may take + to update their system to the latest security + release. - , &dtrace; + , + &dtrace; - Describes how to configure and use the &dtrace; tool from &sun; - in &os;. Dynamic tracing can help locate performance issues, by - performing real time system analysis. + Describes how to configure and use the &dtrace; tool + from &sun; in &os;. Dynamic tracing can help locate + performance issues, by performing real time system + analysis. - , Serial Communications + , Serial + Communications Explains how to connect terminals and modems to your - &os; system for both dial in and dial out connections. + &os; system for both dial in and dial out + connections. - , PPP and SLIP + , PPP and + SLIP Describes how to use PPP, SLIP, or PPP over Ethernet to - connect to remote systems with &os;. + connect to remote systems with &os;. - , Electronic Mail + , Electronic + Mail - Explains the different components of an email server and - dives into simple configuration topics for the most popular - mail server software: - sendmail. + Explains the different components of an email server + and dives into simple configuration topics for the most + popular mail server software: + sendmail. - , Network Servers + , Network + Servers Provides detailed instructions and example configuration files to set up your &os; machine as a network filesystem @@ -528,79 +581,88 @@ - , Firewalls + , + Firewalls - Explains the philosophy behind software-based firewalls and - provides detailed information about the configuration of the - different firewalls available for &os;. + Explains the philosophy behind software-based firewalls + and provides detailed information about the configuration + of the different firewalls available for &os;. - , Advanced Networking + , Advanced + Networking Describes many networking topics, including sharing an - Internet connection with other computers on your LAN, advanced - routing topics, wireless networking, &bluetooth;, ATM, IPv6, and - much more. + Internet connection with other computers on your LAN, + advanced routing topics, wireless networking, &bluetooth;, + ATM, IPv6, and much more. - , Obtaining &os; + , Obtaining &os; + - 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;. + 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;. - , Bibliography + , + Bibliography This book touches on many different subjects that may - leave you hungry for a more detailed explanation. The - bibliography lists many excellent books that are referenced in - the text. + leave you hungry for a more detailed explanation. The + bibliography lists many excellent books that are referenced + in the text. - , Resources on the Internet + , Resources on the + Internet Describes the many forums available for &os; users to - post questions and engage in technical conversations about - &os;. + post questions and engage in technical conversations about + &os;. - , PGP Keys + , PGP + Keys - Lists the PGP fingerprints of several &os; Developers. + Lists the PGP fingerprints of several &os; + Developers. Conventions used - in this book + in this book To provide a consistent and easy to read text, several - conventions are followed throughout the book. + conventions are followed throughout the book. - Typographic - Conventions + Typographic + Conventions Italic - An italic font is used for filenames, URLs, - emphasized text, and the first usage of technical terms. + An italic font is used for + filenames, URLs, emphasized text, and the first usage of + technical terms. Monospace - A monospaced font is + A monospaced font is used for error messages, commands, environment variables, names of ports, hostnames, user names, group names, device names, variables, and code fragments. @@ -610,7 +672,7 @@ Bold A bold font is used for - applications, commands, and keys. + applications, commands, and keys. @@ -628,16 +690,14 @@ Ctrl Alt - Del - - + Del Meaning the user should type the Ctrl, Alt, and Del keys at the same time. - Keys that are meant to be typed in sequence will be separated with - commas, for example: + Keys that are meant to be typed in sequence will be separated + with commas, for example: @@ -646,9 +706,7 @@ , Ctrl - S - - + S Would mean that the user is expected to type the Ctrl and X keys simultaneously @@ -660,9 +718,10 @@ renderas="sect2">Examples Examples starting with E:\> - indicate a &ms-dos; command. Unless otherwise noted, these commands - may be executed from a Command Prompt window in a modern µsoft.windows; - environment. + indicate a &ms-dos; command. Unless otherwise noted, these + commands may be executed from a Command Prompt + window in a modern µsoft.windows; + environment. E:\> tools\fdimage floppies\kern.flp A: @@ -684,10 +743,10 @@ Acknowledgments - The book you are holding represents the efforts of many hundreds of - people around the world. Whether they sent in fixes for typos, or - submitted complete chapters, all the contributions have been - useful. + The book you are holding represents the efforts of many + hundreds of people around the world. Whether they sent in fixes + for typos, or submitted complete chapters, all the contributions + have been useful. Several companies have supported the development of this document by paying authors to work on it full-time, paying for @@ -697,11 +756,11 @@ improving this book full time leading up to the publication of the first printed edition in March 2000 (ISBN 1-57176-241-8). Wind River Systems then paid several additional authors to make a - 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, &os; Mall, Inc, paid + 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, &os; Mall, Inc, paid several contributors to improve the Handbook in preparation for the third printed edition.