From owner-svn-doc-all@freebsd.org Thu Jan 28 02:00:00 2016 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id CF424A6F35A; Thu, 28 Jan 2016 02:00:00 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 8DAF9104E; Thu, 28 Jan 2016 02:00:00 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id u0S1xxAK080551; Thu, 28 Jan 2016 01:59:59 GMT (envelope-from wblock@FreeBSD.org) Received: (from wblock@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id u0S1xxIx080550; Thu, 28 Jan 2016 01:59:59 GMT (envelope-from wblock@FreeBSD.org) Message-Id: <201601280159.u0S1xxIx080550@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: wblock set sender to wblock@FreeBSD.org using -f From: Warren Block Date: Thu, 28 Jan 2016 01:59:59 +0000 (UTC) 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 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.20 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: Thu, 28 Jan 2016 02:00:01 -0000 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"> - FreeBSD Handbook + &os; Handbook The FreeBSD Documentation Project @@ -87,30 +87,30 @@ - Welcome to FreeBSD! This handbook covers the installation + Welcome to &os;! This handbook covers the installation and day to day use of - FreeBSD &rel2.current;-RELEASE and - FreeBSD &rel.current;-RELEASE. This - manual is a work in progress 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 FreeBSD web site - (previous versions of this handbook can be obtained from http://docs.FreeBSD.org/doc/). - It may also be downloaded in a variety of formats and + &os; &rel2.current;-RELEASE and + &os; &rel.current;-RELEASE. 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;. + + The latest + + version of this book is available from the FreeBSD web site. + Previous versions can be obtained from http://docs.FreeBSD.org/doc/. + The book can be downloaded in a variety of formats and compression options from the FreeBSD + xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">&os; FTP server or one of the numerous - mirror sites. If you would - prefer to have a hard copy of the handbook, you can purchase - one at the + mirror sites. Printed + copies can be purchased at the FreeBSD - Mall. You may also want to - search the - handbook. + Mall. Searches can be performed on the handbook and other documents on the + search + page. @@ -120,38 +120,37 @@ Getting Started - This part of the FreeBSD Handbook is for users and - administrators who are new to FreeBSD. These chapters: + This part of the handbook is for users and + administrators who are new to &os;. These chapters: - Introduce you to FreeBSD. + Introduce &os;. - Guide you through the installation process. + Guide readers through the installation process. - Teach you &unix; basics and fundamentals. + Teach &unix; basics and fundamentals. - Show you how to install the wealth of third party - applications available for FreeBSD. + Show how to install the wealth of third party + applications available for &os;. - Introduce you to X, the &unix; windowing system, and + Introduce X, the &unix; windowing system, and detail how to configure a desktop environment that makes - you more productive. + users more productive. - 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. + 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. &chap.introduction; @@ -166,25 +165,24 @@ Now that the basics have been covered, this part of the - FreeBSD Handbook will discuss some frequently used features of - FreeBSD. These chapters: + book discusses some frequently used features of + &os;. These chapters: - Introduce you to popular and useful desktop + Introduce popular and useful desktop applications: browsers, productivity tools, document - viewers, etc. + viewers, and more. - Introduce you to a number of multimedia tools - available for FreeBSD. + Introduce a number of multimedia tools + available for &os;. - Explain the process of building a customized FreeBSD - kernel, to enable extra functionality on your - system. + Explain the process of building a customized &os; + kernel to enable extra functionality. @@ -193,12 +191,12 @@ - Show you how to run Linux applications on your FreeBSD + Show how to run Linux applications on the &os; system. - Some of these chapters recommend that you do some prior + Some of these chapters recommend prior reading, and this is noted in the synopsis at the beginning of each chapter. @@ -214,16 +212,16 @@ System Administration - 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 + 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. - 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. + 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;. &chap.config; @@ -246,7 +244,7 @@ Network Communication - FreeBSD is one of the most widely deployed operating + &os; is one of the most widely deployed operating systems for high performance network servers. The chapters in this part cover: @@ -256,7 +254,7 @@ - PPP and PPP over Ethernet + PPP and PPP over Ethernet @@ -276,10 +274,10 @@ - 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. + 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. &chap.serialcomms;