From owner-svn-doc-all@FreeBSD.ORG Thu Jul 18 21:31:17 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 5BCBD792; Thu, 18 Jul 2013 21:31:17 +0000 (UTC) (envelope-from wblock@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 3E2A7A48; Thu, 18 Jul 2013 21:31:17 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6ILVHjI078641; Thu, 18 Jul 2013 21:31:17 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6ILVH1W078640; Thu, 18 Jul 2013 21:31:17 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307182131.r6ILVH1W078640@svn.freebsd.org> From: Warren Block Date: Thu, 18 Jul 2013 21:31:17 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42319 - head/en_US.ISO8859-1/books/fdp-primer/overview 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: Thu, 18 Jul 2013 21:31:17 -0000 Author: wblock Date: Thu Jul 18 21:31:16 2013 New Revision: 42319 URL: http://svnweb.freebsd.org/changeset/doc/42319 Log: Whitespace-only fixes. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml Thu Jul 18 21:04:22 2013 (r42318) +++ head/en_US.ISO8859-1/books/fdp-primer/overview/chapter.xml Thu Jul 18 21:31:16 2013 (r42319) @@ -64,8 +64,8 @@ - Submit changes back for review and inclusion in - the &os; documentation. + Submit changes back for review and inclusion in the &os; + documentation. @@ -172,12 +172,12 @@ For the fastest download, pick the nearest mirror from the list of Subversion - mirror sites. + mirror sites. - The editor to be used - should be configured as follows: + The editor to be used should be configured as + follows: @@ -200,21 +200,18 @@ - Run - svn up to update the local working copy. - Edit the documentation files that need changes. - Before making major - changes to a file, ask for input on the - &a.doc;. - - To learn which tags and entities - are needed to achieve the desired formatting, - compare some text in the + Run svn up to update the local + working copy. Edit the documentation files that need + changes. Before making major changes to a file, ask for + input on the &a.doc;. + + To learn which tags and entities are needed to achieve + the desired formatting, compare some text in the HTML formatted version of the document - to the text, tags, and entities - in the XML file. - References to the commonly used tags and entities can be - found in and + to the text, tags, and entities in the + XML file. References to the commonly + used tags and entities can be found in + and . @@ -225,10 +222,9 @@ &prompt.user; igor -R filename.xml | less -RS Review the output and edit the file to fix any - problems shown, then - rerun the command to find any remaining - problems. Repeat until all of the errors that are - fixable are resolved. If an error seems unsolvable, + problems shown, then rerun the command to find any + remaining problems. Repeat until all of the errors that + are fixable are resolved. If an error seems unsolvable, ask for assistance on the &a.doc;. @@ -238,16 +234,16 @@ make in the top-level directory of the type of documentation being edited will generate that documentation in split HTML format. For example, to build - the English version of the Handbook in HTML, type - make in the - en_US.ISO8859-1/books/handbook/ - directory. This step is necessary to make sure that - edits do not break the build. + the English version of the Handbook in + HTML, type make in + the en_US.ISO8859-1/books/handbook/ + directory. This step is necessary to make sure that edits + do not break the build. - After successfully completing the previous steps, generate - a diff file of the changes: + After successfully completing the previous steps, + generate a diff file of the changes: &prompt.user; cd /usr/doc &prompt.user; svn diff > bsdinstall.diff.txt @@ -272,14 +268,14 @@ [ Browse... ] button to attach the .diff.txt. - Remember that the - FDP is comprised of volunteers who - review edits in their spare time and who live in different - time zones around the globe. It can take some time to review - changes. If a response is not received in a - reasonable amount of time, send a follow-up email to the - &a.doc; and ask if anyone has had a chance to review the - patch or if additional information is required. + Remember that the FDP is comprised + of volunteers who review edits in their spare time and who + live in different time zones around the globe. It can + take some time to review changes. If a response is not + received in a reasonable amount of time, send a follow-up + email to the &a.doc; and ask if anyone has had a chance to + review the patch or if additional information is + required.