Date: Thu, 28 Jan 2016 01:59:59 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48107 - head/en_US.ISO8859-1/books/handbook Message-ID: <201601280159.u0S1xxIx080550@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Thu Jan 28 01:59:59 2016 New Revision: 48107 URL: https://svnweb.freebsd.org/changeset/doc/48107 Log: Clean up and simplify language. Remove most uses of "you", use &os; instead of literal "FreeBSD", make wording less redundant and passive. Modified: head/en_US.ISO8859-1/books/handbook/book.xml Modified: head/en_US.ISO8859-1/books/handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/book.xml Wed Jan 27 23:33:55 2016 (r48106) +++ head/en_US.ISO8859-1/books/handbook/book.xml Thu Jan 28 01:59:59 2016 (r48107) @@ -18,7 +18,7 @@ xml:lang="en"> <info> - <title>FreeBSD Handbook</title> + <title>&os; Handbook</title> <author> <orgname>The FreeBSD Documentation Project</orgname> @@ -87,30 +87,30 @@ </legalnotice> <abstract> - <para>Welcome to FreeBSD! This handbook covers the installation + <para>Welcome to &os;! This handbook covers the installation and day to day use of - <emphasis>FreeBSD &rel2.current;-RELEASE</emphasis> and - <emphasis>FreeBSD &rel.current;-RELEASE</emphasis>. This - manual is a <emphasis>work in progress</emphasis> and is the - work of many individuals. As such, some sections may become - dated and require updating. If you are interested in helping - out with this project, send email to the &a.doc;. The latest - - version of this document is always available from the <link - xlink:href="http://www.FreeBSD.org/">FreeBSD web site</link> - (previous versions of this handbook can be obtained from <uri - xlink:href="http://docs.FreeBSD.org/doc/">http://docs.FreeBSD.org/doc/</uri>). - It may also be downloaded in a variety of formats and + <emphasis>&os; &rel2.current;-RELEASE</emphasis> and + <emphasis>&os; &rel.current;-RELEASE</emphasis>. This + book is the result of ongoing work by many individuals. Some sections might be + outdated. Those interested in helping to update and expand + this document should send email to the &a.doc;.</para> + + <para>The latest + + version of this book is available from the <link + xlink:href="http://www.FreeBSD.org/">FreeBSD web site</link>. + Previous versions can be obtained from <uri + xlink:href="http://docs.FreeBSD.org/doc/">http://docs.FreeBSD.org/doc/</uri>. + The book can be downloaded in a variety of formats and compression options from the <link - xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">FreeBSD + xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">&os; FTP server</link> or one of the numerous - <link linkend="mirrors-ftp">mirror sites</link>. If you would - prefer to have a hard copy of the handbook, you can purchase - one at the + <link linkend="mirrors-ftp">mirror sites</link>. Printed + copies can be purchased at the <link xlink:href="http://www.freebsdmall.com/">FreeBSD - Mall</link>. You may also want to - <link xlink:href="&url.base;/search/index.html">search the - handbook</link>.</para> + Mall</link>. Searches can be performed on the handbook and other documents on the + <link xlink:href="&url.base;/search/index.html">search + page</link>.</para> </abstract> </info> @@ -120,38 +120,37 @@ <title>Getting Started</title> <partintro> - <para>This part of the FreeBSD Handbook is for users and - administrators who are new to FreeBSD. These chapters:</para> + <para>This part of the handbook is for users and + administrators who are new to &os;. These chapters:</para> <itemizedlist> <listitem> - <para>Introduce you to FreeBSD.</para> + <para>Introduce &os;.</para> </listitem> <listitem> - <para>Guide you through the installation process.</para> + <para>Guide readers through the installation process.</para> </listitem> <listitem> - <para>Teach you &unix; basics and fundamentals.</para> + <para>Teach &unix; basics and fundamentals.</para> </listitem> <listitem> - <para>Show you how to install the wealth of third party - applications available for FreeBSD.</para> + <para>Show how to install the wealth of third party + applications available for &os;.</para> </listitem> <listitem> - <para>Introduce you to X, the &unix; windowing system, and + <para>Introduce X, the &unix; windowing system, and detail how to configure a desktop environment that makes - you more productive.</para> + users more productive.</para> </listitem> </itemizedlist> - <para>We have tried to keep the number of forward references in - the text to a minimum so that you can read this section of the - Handbook from front to back with the minimum page flipping - required.</para> + <para>The number of forward references in the text have been + kept to a minimum so that this section + can be read from front to back with minimal page flipping.</para> </partintro> &chap.introduction; @@ -166,25 +165,24 @@ <partintro> <para>Now that the basics have been covered, this part of the - FreeBSD Handbook will discuss some frequently used features of - FreeBSD. These chapters:</para> + book discusses some frequently used features of + &os;. These chapters:</para> <itemizedlist> <listitem> - <para>Introduce you to popular and useful desktop + <para>Introduce popular and useful desktop applications: browsers, productivity tools, document - viewers, etc.</para> + viewers, and more.</para> </listitem> <listitem> - <para>Introduce you to a number of multimedia tools - available for FreeBSD.</para> + <para>Introduce a number of multimedia tools + available for &os;.</para> </listitem> <listitem> - <para>Explain the process of building a customized FreeBSD - kernel, to enable extra functionality on your - system.</para> + <para>Explain the process of building a customized &os; + kernel to enable extra functionality.</para> </listitem> <listitem> @@ -193,12 +191,12 @@ </listitem> <listitem> - <para>Show you how to run Linux applications on your FreeBSD + <para>Show how to run Linux applications on the &os; system.</para> </listitem> </itemizedlist> - <para>Some of these chapters recommend that you do some prior + <para>Some of these chapters recommend prior reading, and this is noted in the synopsis at the beginning of each chapter.</para> </partintro> @@ -214,16 +212,16 @@ <title>System Administration</title> <partintro> - <para>The remaining chapters of the FreeBSD Handbook cover all - aspects of FreeBSD system administration. Each chapter starts - by describing what you will learn as a result of reading the - chapter, and also details what you are expected to know before + <para>The remaining chapters cover all + aspects of &os; system administration. Each chapter starts + by describing what will be learned as a result of reading the + chapter, and also details what the reader is expected to know before tackling the material.</para> - <para>These chapters are designed to be read when you need - the information. You do not have to read them in any - particular order, nor do you need to read all of them before - you can begin using FreeBSD.</para> + <para>These chapters are designed to be read as the information + is needed. They do not need to be read in any + particular order, nor must all of them be read before + beginning to use &os;.</para> </partintro> &chap.config; @@ -246,7 +244,7 @@ <title>Network Communication</title> <partintro> - <para>FreeBSD is one of the most widely deployed operating + <para>&os; is one of the most widely deployed operating systems for high performance network servers. The chapters in this part cover:</para> @@ -256,7 +254,7 @@ </listitem> <listitem> - <para>PPP and PPP over Ethernet</para> + <para><acronym>PPP</acronym> and <acronym>PPP</acronym> over Ethernet</para> </listitem> <listitem> @@ -276,10 +274,10 @@ </listitem> </itemizedlist> - <para>These chapters are designed to be read when - you need the information. You do not have to read them in any - particular order, nor do you need to read all of them before - you can begin using FreeBSD in a network environment.</para> + <para>These chapters are designed to be read when the + information is needed. They do not need to be read in any + particular order, nor is it necessary to read all of them + before using &os; in a network environment.</para> </partintro> &chap.serialcomms;
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201601280159.u0S1xxIx080550>