svn commit: r48107 - head/en_US.ISO8859-1/books/handbook
Warren Block
wblock at FreeBSD.org
Thu Jan 28 02:00:01 UTC 2016
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;
More information about the svn-doc-all
mailing list