docs/178700: [patch] adds a tip about a missing index file

[Drahos Cagan]

>Number:         178700
>Category:       docs
>Synopsis:       [patch] adds a tip about a missing index file
>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:   Fri May 17 02:00:01 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:
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:
>Unformatted: