From nobody@FreeBSD.org  Fri May 17 01:49:58 2013
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
	by hub.freebsd.org (Postfix) with ESMTP id F0B79CB3
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 17 May 2013 01:49:58 +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 E3A09BDF
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 17 May 2013 01:49:58 +0000 (UTC)
Received: from oldred.FreeBSD.org ([127.0.1.6])
	by oldred.FreeBSD.org (8.14.5/8.14.5) with ESMTP id r4H1nwlX024185
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 17 May 2013 01:49:58 GMT
	(envelope-from nobody@oldred.FreeBSD.org)
Received: (from nobody@localhost)
	by oldred.FreeBSD.org (8.14.5/8.14.5/Submit) id r4H1nwEM024184;
	Fri, 17 May 2013 01:49:58 GMT
	(envelope-from nobody)
Message-Id: <201305170149.r4H1nwEM024184@oldred.FreeBSD.org>
Date: Fri, 17 May 2013 01:49:58 GMT
From: Drahos Cagan <drahos_1@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] adds a tip about a missing index file
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         178700
>Category:       docs
>Synopsis:       [patch] adds a tip about a missing index file
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    wblock
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri May 17 02:00:01 UTC 2013
>Closed-Date:    Thu May 23 10:30:46 UTC 2013
>Last-Modified:  Thu May 23 10:40: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:
The patch adds a tip to the ports chapter, what to do before running 'make search' command, if the index file is missing.
>How-To-Repeat:
1. Install fresh ports or delete INDEX from /usr/ports.
2. Run 'make search name=port-name'.
>Fix:
Apply the attached patch.

Patch attached with submission follows:

Index: chapter.xml
===================================================================
--- chapter.xml	(revision 41636)
+++ chapter.xml	(working copy)
@@ -292,6 +292,13 @@
 B-deps:
 R-deps: </screen>
 
+	<tip>
+	  <para>If <command>make search
+	      name=<replacable>lsof</replacable></command> shows a
+	    message indicating an INDEX is required, run
+	  <command>make fetchindex</command> first.</para>
+ 	</tip>
+
 	<para>The <quote>Path:</quote> line indicates where to find
 	  the port.</para>
 


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Fri May 17 02:00:01 UTC 2013 
Responsible-Changed-Why:  
I'll take it 

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

From: Eitan Adler <lists@eitanadler.com>
To: Drahos Cagan <drahos_1@yahoo.com>
Cc: bug-followup <bug-followup@freebsd.org>
Subject: Re: docs/178700: [patch] adds a tip about a missing index file
Date: Sat, 18 May 2013 00:35:53 -0400

 On 16 May 2013 21:49, Drahos Cagan <drahos_1@yahoo.com> wrote:
 
 ...
 
 Two issues
 
 a) replacable is not a valid tag: I think you meant 'replaceable'
 b) generally, diffs from the root are preferred so we know which file
 is changing ('chapter.xml' is not very descriptive)
 
 would you like to change the patch or shall I fix it?
 
 
 -- 
 Eitan Adler
Responsible-Changed-From-To: eadler->wblock 
Responsible-Changed-By: wblock 
Responsible-Changed-When: Sat May 18 11:36:26 UTC 2013 
Responsible-Changed-Why:  
Take. 

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

From: drahos_1@yahoo.com
To: "bug-followup@FreeBSD.org" <bug-followup@FreeBSD.org>
Cc:  
Subject: Re: docs/178700: [patch] adds a tip about a missing index file
Date: Sat, 18 May 2013 16:26:22 -0700 (PDT)

 --329289550-1950908052-1368919582=:87986
 Content-Type: multipart/alternative; boundary="329289550-1757251995-1368919582=:87986"
 
 --329289550-1757251995-1368919582=:87986
 Content-Type: text/plain; charset=us-ascii
 
 
 
 --329289550-1757251995-1368919582=:87986
 Content-Type: text/html; charset=us-ascii
 
 <html><body><div style="color:#000; background-color:#fff; font-family:Courier New, courier, monaco, monospace, sans-serif;font-size:10pt"><div></div></div></body></html>
 --329289550-1757251995-1368919582=:87986--
 --329289550-1950908052-1368919582=:87986
 Content-Type: application/octet-stream; name="patch-ports.diff"
 Content-Transfer-Encoding: base64
 Content-Disposition: attachment; filename="patch-ports.diff"
 
 SW5kZXg6IGVuX1VTLklTTzg4NTktMS9ib29rcy9oYW5kYm9vay9wb3J0cy9j
 aGFwdGVyLnhtbAo9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09Ci0tLSBlbl9VUy5J
 U084ODU5LTEvYm9va3MvaGFuZGJvb2svcG9ydHMvY2hhcHRlci54bWwJKHJl
 dmlzaW9uIDQxNjYwKQorKysgZW5fVVMuSVNPODg1OS0xL2Jvb2tzL2hhbmRi
 b29rL3BvcnRzL2NoYXB0ZXIueG1sCSh3b3JraW5nIGNvcHkpCkBAIC0yOTIs
 NiArMjkyLDE2IEBACiBCLWRlcHM6CiBSLWRlcHM6IDwvc2NyZWVuPgogCisJ
 PHRpcD4KKwkgIDxwYXJhPjxjb21tYW5kPm1ha2Ugc2VhcmNoPC9jb21tYW5k
 PiBzZWFyY2hlcyB0aHJvdWdoIGEgZmlsZQorCSAgICBvZiBpbmRleCBpbmZv
 cm1hdGlvbi4gIElmIGEgbWVzc2FnZSBpbmRpY2F0ZXMgdGhlCisJICAgIDxm
 aWxlbmFtZT5JTkRFWDwvZmlsZW5hbWU+IGlzIHJlcXVpcmVkLCBydW4KKwkg
 ICAgPGNvbW1hbmQ+bWFrZSBmZXRjaGluZGV4PC9jb21tYW5kPiB0byBkb3du
 bG9hZCB0aGUgY3VycmVudAorCSAgICBpbmRleCBmaWxlLiAgV2l0aCB0aGUg
 PGZpbGVuYW1lPklOREVYPC9maWxlbmFtZT4gcHJlc2VudCwKKwkgICAgPGNv
 bW1hbmQ+bWFrZSBzZWFyY2g8L2NvbW1hbmQ+IHdpbGwgYmUgYWJsZSB0byBw
 ZXJmb3JtIHRoZQorCSAgICByZXF1ZXN0ZWQgc2VhcmNoLjwvcGFyYT4KKwk8
 L3RpcD4KKwogCTxwYXJhPlRoZSA8cXVvdGU+UGF0aDo8L3F1b3RlPiBsaW5l
 IGluZGljYXRlcyB3aGVyZSB0byBmaW5kCiAJICB0aGUgcG9ydC48L3BhcmE+
 CiAK
 
 --329289550-1950908052-1368919582=:87986--
State-Changed-From-To: open->closed 
State-Changed-By: wblock 
State-Changed-When: Thu May 23 10:30:21 UTC 2013 
State-Changed-Why:  
Patch committed, thanks! 

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

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

 Author: wblock
 Date: Thu May 23 10:29:53 2013
 New Revision: 41717
 URL: http://svnweb.freebsd.org/changeset/doc/41717
 
 Log:
   Add tip about downloading the INDEX file if it is not present.
   
   PR:		docs/178700
   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 09:55:34 2013	(r41716)
 +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Thu May 23 10:29:53 2013	(r41717)
 @@ -292,6 +292,16 @@ Index:  sysutils
  B-deps:
  R-deps: </screen>
  
 +	<tip>
 +	  <para><command>make search</command> searches through a file
 +	    of index information.  If a message indicates the
 +	    <filename>INDEX</filename> is required, run
 +	    <command>make fetchindex</command> to download the current
 +	    index file.  With the <filename>INDEX</filename> present,
 +	    <command>make search</command> will be able to perform the
 +	    requested search.</para>
 +	</tip>
 +
  	<para>The <quote>Path:</quote> line indicates where to find
  	  the port.</para>
  
 _______________________________________________
 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:
