Date: Wed, 1 Dec 2010 22:42:43 -0800 From: Jason Helfman <jhelfman@e-e.com> To: John McCall <biomedsoftware@gmail.com> Cc: freebsd-doc@freebsd.org Subject: Re: typo in manual first paragraph Message-ID: <20101202064243.GA11197@eggman.experts-exchange.com> In-Reply-To: <AANLkTin5zWRPBZXR2giBsWsjWaW0=M_nE%2BMmzaHC7kz=@mail.gmail.com> References: <AANLkTin5zWRPBZXR2giBsWsjWaW0=M_nE%2BMmzaHC7kz=@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--jI8keyz6grp/JLjh Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline I believe this patch should take care of this. While at it, I took all instances of FreeBSD and changed it to '&os;' -jgh On Wed, Dec 01, 2010 at 10:14:41PM -0500, John McCall thus spake: >I think you mean "broad"..........not board > >............"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. >_______________________________________________ >freebsd-doc@freebsd.org mailing list >http://lists.freebsd.org/mailman/listinfo/freebsd-doc >To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > -- Jason Helfman System Administrator experts-exchange.com http://www.experts-exchange.com/M_4830110.html --jI8keyz6grp/JLjh Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="patch.txt" --- handbook/preface/preface.sgml.orig 2010-12-01 22:31:06.000000000 -0800 +++ handbook/preface/preface.sgml 2010-12-01 22:38:57.000000000 -0800 @@ -8,16 +8,16 @@ <bridgehead id="preface-audience" renderas=sect1>Intended Audience</bridgehead> - <para>The FreeBSD newcomer will find that the first section of this - book guides the user through the FreeBSD installation process and + <para>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 + to explore, and the ability to take on broad new concepts as they are introduced.</para> <para>Once you have traveled this far, the second, far larger, section of the Handbook is a comprehensive reference to all manner - of topics of interest to FreeBSD system administrators. Some of + of topics of interest to &os; system administrators. Some of these chapters may recommend that you do some prior reading, and this is noted in the synopsis at the beginning of each chapter.</para> @@ -63,7 +63,7 @@ Second Edition (2004)</bridgehead> <para>The third edition was the culmination of over two years of - work by the dedicated members of the FreeBSD Documentation + 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:</para> @@ -86,7 +86,7 @@ <listitem> <para><xref linkend="mac">, 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 FreeBSD + and how this mechanism can be used to secure a &os; system.</para> </listitem> @@ -129,7 +129,7 @@ <listitem> <para><xref linkend="advanced-networking">, Advanced Networking, has been expanded with new information about - using &bluetooth; devices with FreeBSD, setting up wireless + using &bluetooth; devices with &os;, setting up wireless networks, and Asynchronous Transfer Mode (ATM) networking.</para> </listitem> @@ -150,7 +150,7 @@ First Edition (2001)</bridgehead> <para>The second edition was the culmination of over two years of - work by the dedicated members of the FreeBSD Documentation + work by the dedicated members of the &os; Documentation Project. The following were the major changes in this edition:</para> @@ -174,7 +174,7 @@ <quote>Appendices</quote>.</para> </listitem> <listitem> - <para><xref linkend="install"> (<quote>Installing FreeBSD</quote>) was completely + <para><xref linkend="install"> (<quote>Installing &os;</quote>) was completely rewritten with many screenshots to make it much easier for new users to grasp the text.</para> </listitem> @@ -194,7 +194,7 @@ technologies such as <application>KDE</application> and <application>GNOME</application> on &xfree86; 4.X.</para> </listitem> <listitem> - <para><xref linkend="boot"> (<quote>The FreeBSD Booting Process</quote>) has been + <para><xref linkend="boot"> (<quote>The &os; Booting Process</quote>) has been expanded.</para> </listitem> <listitem> @@ -206,7 +206,7 @@ </listitem> <listitem> <para><xref linkend="serialcomms"> (<quote>Serial Communications</quote>) has been completely - reorganized and updated for FreeBSD 4.X/5.X.</para> + reorganized and updated for &os; 4.X/5.X.</para> </listitem> <listitem> <para><xref linkend="ppp-and-slip"> (<quote>PPP and SLIP</quote>) has been substantially @@ -246,11 +246,11 @@ <para>This book is split into five logically distinct sections. The first section, <emphasis>Getting Started</emphasis>, covers - the installation and basic usage of FreeBSD. It is expected that + the installation and basic usage of &os;. It is expected that the reader will follow these chapters in sequence, possibly skipping chapters covering familiar topics. The second section, <emphasis>Common Tasks</emphasis>, covers some frequently used - features of FreeBSD. This section, and all subsequent sections, + features of &os;. This section, and all subsequent sections, can be read out of order. Each chapter begins with a succinct synopsis that describes what the chapter covers and what the reader is expected @@ -269,8 +269,8 @@ <varlistentry> <term><emphasis><xref linkend="introduction">, Introduction</emphasis></term> <listitem> - <para>Introduces FreeBSD to a new user. It describes the - history of the FreeBSD Project, its goals and development model.</para> + <para>Introduces &os; to a new user. It describes the + history of the &os; Project, its goals and development model.</para> </listitem> </varlistentry> <varlistentry> @@ -285,7 +285,7 @@ <term><emphasis><xref linkend="basics">, &unix; Basics</emphasis></term> <listitem> <para>Covers the basic commands and functionality of the - FreeBSD operating system. If you are familiar with &linux; or + &os; operating system. If you are familiar with &linux; or another flavor of &unix; then you can probably skip this chapter.</para> </listitem> @@ -294,7 +294,7 @@ <term><emphasis><xref linkend="ports">, Installing Applications</emphasis></term> <listitem> <para>Covers the installation of third-party software with - both FreeBSD's innovative <quote>Ports Collection</quote> and standard + both &os;'s innovative <quote>Ports Collection</quote> and standard binary packages.</para> </listitem> </varlistentry> @@ -302,7 +302,7 @@ <term><emphasis><xref linkend="x11">, The X Window System</emphasis></term> <listitem> <para>Describes the X Window System in general and using - X11 on FreeBSD in particular. Also describes common + X11 on &os; in particular. Also describes common desktop environments such as <application>KDE</application> and <application>GNOME</application>.</para> </listitem> </varlistentry> @@ -314,7 +314,7 @@ <listitem> <para>Lists some common desktop applications, such as web browsers and productivity suites, and describes how to install them on - FreeBSD.</para> + &os;.</para> </listitem> </varlistentry> <varlistentry> @@ -325,7 +325,7 @@ </listitem> </varlistentry> <varlistentry> - <term><emphasis><xref linkend="kernelconfig">, Configuring the FreeBSD + <term><emphasis><xref linkend="kernelconfig">, Configuring the &os; Kernel</emphasis></term> <listitem> <para>Explains why you might need to configure a new kernel @@ -336,7 +336,7 @@ <varlistentry> <term><emphasis><xref linkend="printing">, Printing</emphasis></term> <listitem> - <para>Describes managing printers on FreeBSD, including + <para>Describes managing printers on &os;, including information about banner pages, printer accounting, and initial setup.</para> </listitem> @@ -344,7 +344,7 @@ <varlistentry> <term><emphasis><xref linkend="linuxemu">, &linux; Binary Compatibility</emphasis></term> <listitem> - <para>Describes the &linux; compatibility features of FreeBSD. + <para>Describes the &linux; compatibility features of &os;. Also provides detailed installation instructions for many popular &linux; applications such as <application>&oracle;</application>, <application>&sap.r3;</application>, and <application>&mathematica;</application>.</para> @@ -357,15 +357,15 @@ <term><emphasis><xref linkend="config-tuning">, Configuration and Tuning</emphasis></term> <listitem> <para>Describes the parameters available for system - administrators to tune a FreeBSD system for optimum + administrators to tune a &os; system for optimum performance. Also describes the various configuration files - used in FreeBSD and where to find them.</para> + used in &os; and where to find them.</para> </listitem> </varlistentry> <varlistentry> <term><emphasis><xref linkend="boot">, Booting Process</emphasis></term> <listitem> - <para>Describes the FreeBSD boot process and explains + <para>Describes the &os; boot process and explains how to control this process with configuration options.</para> </listitem> </varlistentry> @@ -382,7 +382,7 @@ <term><emphasis><xref linkend="security">, Security</emphasis></term> <listitem> <para>Describes many different tools available to help keep your - FreeBSD system secure, including Kerberos, IPsec and OpenSSH.</para> + &os; system secure, including Kerberos, IPsec and OpenSSH.</para> </listitem> </varlistentry> <varlistentry> @@ -396,7 +396,7 @@ <term><emphasis><xref linkend="mac">, Mandatory Access Control</emphasis></term> <listitem> <para>Explains what Mandatory Access Control (MAC) is and how this - mechanism can be used to secure a FreeBSD system.</para> + mechanism can be used to secure a &os; system.</para> </listitem> </varlistentry> <varlistentry> @@ -411,7 +411,7 @@ <term><emphasis><xref linkend="disks">, Storage</emphasis></term> <listitem> <para>Describes how to manage storage media and filesystems - with FreeBSD. This includes physical disks, RAID arrays, + with &os;. This includes physical disks, RAID arrays, optical and tape media, memory-backed disks, and network filesystems.</para> </listitem> @@ -419,7 +419,7 @@ <varlistentry> <term><emphasis><xref linkend="geom">, GEOM</emphasis></term> <listitem> - <para>Describes what the GEOM framework in FreeBSD is and how + <para>Describes what the GEOM framework in &os; is and how to configure various supported RAID levels.</para> </listitem> </varlistentry> @@ -448,7 +448,7 @@ <varlistentry> <term><emphasis><xref linkend="l10n">, Localization</emphasis></term> <listitem> - <para>Describes how to use FreeBSD in languages other than + <para>Describes how to use &os; in languages other than English. Covers both system and application level localization.</para> </listitem> @@ -456,8 +456,8 @@ <varlistentry> <term><emphasis><xref linkend="updating-upgrading">, Updating and Upgrading &os;</emphasis></term> <listitem> - <para>Explains the differences between FreeBSD-STABLE, - FreeBSD-CURRENT, and FreeBSD releases. Describes which users + <para>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.</para> @@ -478,14 +478,14 @@ <term><emphasis><xref linkend="serialcomms">, Serial Communications</emphasis></term> <listitem> <para>Explains how to connect terminals and modems to your - FreeBSD system for both dial in and dial out connections.</para> + &os; system for both dial in and dial out connections.</para> </listitem> </varlistentry> <varlistentry> <term><emphasis><xref linkend="ppp-and-slip">, PPP and SLIP</emphasis></term> <listitem> <para>Describes how to use PPP, SLIP, or PPP over Ethernet to - connect to remote systems with FreeBSD.</para> + connect to remote systems with &os;.</para> </listitem> </varlistentry> <varlistentry> @@ -501,7 +501,7 @@ <term><emphasis><xref linkend="network-servers">, Network Servers</emphasis></term> <listitem> <para>Provides detailed instructions and example configuration - files to set up your FreeBSD machine as a network filesystem + 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> @@ -511,7 +511,7 @@ <listitem> <para>Explains the philosophy behind software-based firewalls and provides detailed information about the configuration of the - different firewalls available for FreeBSD.</para> + different firewalls available for &os;.</para> </listitem> </varlistentry> <varlistentry> @@ -527,11 +527,11 @@ <!-- Part V - Appendices --> <varlistentry> - <term><emphasis><xref linkend="mirrors">, Obtaining FreeBSD </emphasis></term> + <term><emphasis><xref linkend="mirrors">, Obtaining &os; </emphasis></term> <listitem> - <para>Lists different sources for obtaining FreeBSD media on CDROM + <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 FreeBSD.</para> + you to download and install &os;.</para> </listitem> </varlistentry> <varlistentry> @@ -546,15 +546,15 @@ <varlistentry> <term><emphasis><xref linkend="eresources">, Resources on the Internet</emphasis></term> <listitem> - <para>Describes the many forums available for FreeBSD users to + <para>Describes the many forums available for &os; users to post questions and engage in technical conversations about - FreeBSD.</para> + &os;.</para> </listitem> </varlistentry> <varlistentry> <term><emphasis><xref linkend="pgpkeys">, PGP Keys</emphasis></term> <listitem> - <para>Lists the PGP fingerprints of several FreeBSD Developers.</para> + <para>Lists the PGP fingerprints of several &os; Developers.</para> </listitem> </varlistentry> </variablelist> @@ -646,7 +646,7 @@ <screen><prompt>E:\></prompt> <userinput>tools\fdimage floppies\kern.flp A:</userinput></screen> <para>Examples starting with &prompt.root; indicate a command that - must be invoked as the superuser in FreeBSD. You can login as + must be invoked as the superuser in &os;. You can login as <username>root</username> to type the command, or login as your normal account and use &man.su.1; to gain superuser privileges.</para> @@ -672,7 +672,7 @@ 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>) - paid members of the FreeBSD Documentation Project to work on + 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 River Systems then paid several additional authors to make a @@ -680,7 +680,7 @@ 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">FreeBSD Mall, Inc</ulink>, paid + url="http://www.freebsdmall.com">&os; Mall, Inc</ulink>, paid several contributors to improve the Handbook in preparation for the third printed edition.</para> --jI8keyz6grp/JLjh--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20101202064243.GA11197>