docs/178763: Consistency updates for packages and ports docs

[Drahos Cagan]

>Number:         178763
>Category:       docs
>Synopsis:       Consistency updates for packages and ports docs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun May 19 01:40:00 UTC 2013
>Closed-Date:
>Last-Modified:
>Originator:     Drahos Cagan
>Release:        9.1
>Organization:
>Environment:
FreeBSD 9.1-RELEASE FreeBSD 9.1-RELEASE #0 r243825: Tue Dec  4 09:23:10 UTC 2012     root at farrell.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  amd64
>Description:
I am submitting a patch for a few inconsistencies that I found in the ports documentation (attached below).
>How-To-Repeat:
Look at the file en_US.ISO8859-1/books/handbook/ports/chapter.xml
>Fix:
Apply the patch attached below.

Patch attached with submission follows:

Index: en_US.ISO8859-1/books/handbook/ports/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/handbook/ports/chapter.xml	(revision 41665)
+++ en_US.ISO8859-1/books/handbook/ports/chapter.xml	(working copy)
@@ -310,7 +320,7 @@
 	  <command>make <maketarget>quicksearch</maketarget>
 	  key=<replaceable>string</replaceable></command>, where
 	  <replaceable>string</replaceable> is some text to search
-	  for.  The text can be comments, descriptions or dependencies
+	  for.  The text can be in comments, descriptions, or dependencies
 	  in order to find ports which relate to a particular subject
 	  when the name of the program is unknown.</para>
 
@@ -413,7 +423,7 @@
 	<envar>FTP_PASSIVE_MODE</envar>, <envar>FTP_PROXY</envar>, and
 	<envar>FTP_PASSWORD</envar>.  You may need to set one or more
 	of these if you are behind a firewall, or need to use an
-	FTP/HTTP proxy.  See &man.fetch.3; for the complete list.
+	FTP/HTTP proxy.  See &man.fetch.3; for the complete list of variables.
 	Note that in the example above <literal>lsof</literal> is used
 	instead of <literal>lsof-4.56.4</literal>.  When the remote
 	fetching feature is used, the version number of the package
@@ -439,7 +449,7 @@
 	available from <ulink
 	url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/"></ulink>,
 	or the <filename>/packages</filename> directory of the &os;
-	DVD distribution.  The layout of the packages is similar to
+	DVD distribution.  The layout of the packages directory is similar to
 	that of the <filename>/usr/ports</filename> tree.  Each
 	category has its own directory, and every package can be found
 	within the <filename>All</filename> directory.</para>
@@ -494,18 +504,19 @@
 	    <row>
 	      <entry>=</entry>
 	      <entry>The version of the installed package matches the
-		one found in the local ports tree.</entry>
+		one in the local ports tree.</entry>
 	    </row>
 
 	    <row>
 	      <entry><</entry>
-	      <entry>The installed version is older than the one
-		available in the local ports tree.</entry>
+	      <entry>The version of the installed package is older
+		than the one in the local ports tree.</entry>
 	    </row>
 
 	    <row>
-	      <entry>></entry><entry>The installed version is newer
-		than the one found in the local ports tree, meaning
+	      <entry>></entry>
+	      <entry>The version of the installed package is newer
+		than the one in the local ports tree, meaning
 		that the local ports tree is probably out of
 		date.</entry>
 	    </row>


>Release-Note:
>Audit-Trail:
>Unformatted: