From nobody@FreeBSD.org  Sun May 19 01:38:10 2013
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	by hub.freebsd.org (Postfix) with ESMTP id C8AE3287
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 19 May 2013 01:38:10 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from oldred.FreeBSD.org (oldred.freebsd.org [8.8.178.121])
	by mx1.freebsd.org (Postfix) with ESMTP id A9CD2D4C
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 19 May 2013 01:38:10 +0000 (UTC)
Received: from oldred.FreeBSD.org ([127.0.1.6])
	by oldred.FreeBSD.org (8.14.5/8.14.5) with ESMTP id r4J1cAaY074614
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 19 May 2013 01:38:10 GMT
	(envelope-from nobody@oldred.FreeBSD.org)
Received: (from nobody@localhost)
	by oldred.FreeBSD.org (8.14.5/8.14.5/Submit) id r4J1cA9t074613;
	Sun, 19 May 2013 01:38:10 GMT
	(envelope-from nobody)
Message-Id: <201305190138.r4J1cA9t074613@oldred.FreeBSD.org>
Date: Sun, 19 May 2013 01:38:10 GMT
From: Drahos Cagan <drahos_1@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Consistency updates for packages and ports docs
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         178763
>Category:       docs
>Synopsis:       Consistency updates for packages and ports docs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    wblock
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun May 19 01:40:00 UTC 2013
>Closed-Date:    Thu May 23 10:43:53 UTC 2013
>Last-Modified:  Thu May 23 10:50:00 UTC 2013
>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@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>&lt;</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>&gt;</entry><entry>The installed version is newer
-		than the one found in the local ports tree, meaning
+	      <entry>&gt;</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:
Responsible-Changed-From-To: freebsd-doc->wblock 
Responsible-Changed-By: wblock 
Responsible-Changed-When: Tue May 21 14:18:44 UTC 2013 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=178763 
State-Changed-From-To: open->closed 
State-Changed-By: wblock 
State-Changed-When: Thu May 23 10:43:33 UTC 2013 
State-Changed-Why:  
Patch committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=178763 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/178763: commit references a PR
Date: Thu, 23 May 2013 10:43:29 +0000 (UTC)

 Author: wblock
 Date: Thu May 23 10:43:17 2013
 New Revision: 41718
 URL: http://svnweb.freebsd.org/changeset/doc/41718
 
 Log:
   Make some wording in the ports/packages section more clear and
   consistent.
   
   PR:		docs/178763
   Submitted by:	Drahos Cagan <drahos_1@yahoo.com>
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
 
 Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Thu May 23 10:29:53 2013	(r41717)
 +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Thu May 23 10:43:17 2013	(r41718)
 @@ -320,7 +320,7 @@ Info:   Lists information about open fil
  	  <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>
  
 @@ -426,7 +426,7 @@ local: lsof-4.56.4.tgz remote: lsof-4.56
  	<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
 @@ -452,7 +452,7 @@ local: lsof-4.56.4.tgz remote: lsof-4.56
  	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>
 @@ -507,22 +507,22 @@ docbook                     =
  	    <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>&lt;</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>&gt;</entry><entry>The installed version is newer
 -		than the one found in the local ports tree, meaning
 +	      <entry>&gt;</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>
 -
  	    <row>
  	      <entry>?</entry>
  	      <entry>The installed package cannot be found in the
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
>Unformatted:
