svn commit: r42801 - head/en_US.ISO8859-1/books/handbook/ports

[Dru Lavigne]

Author: dru
Date: Wed Oct  2 11:47:11 2013
New Revision: 42801
URL: http://svnweb.freebsd.org/changeset/doc/42801

Log:
  This patch does the following:
  
  - makes it clear that the ports collection has to be installed
   before performing a search
  
  - updates the listings to latest output
  
  - spells out the hyperlinks so that they render in the print
   edition
  
  - rewords Tip so that it doesn't start with a command
  
  Approved by:  bcr (mentor)

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	Wed Oct  2 09:25:21 2013	(r42800)
+++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Wed Oct  2 11:47:11 2013	(r42801)
@@ -237,7 +237,7 @@
 	<indexterm><primary>FreshPorts</primary></indexterm>
 
 	<para>Dan Langille maintains <ulink
-	    url="http://www.FreshPorts.org/">FreshPorts</ulink> which
+	    url="http://www.FreshPorts.org/">FreshPorts.org</ulink> which
 	  provides a comprehensive search utility and also tracks
 	  changes to the applications in the Ports Collection.
 	  Registered users can create a customized watch list in order
@@ -248,15 +248,17 @@
       <listitem>
 	<indexterm><primary>Freecode</primary></indexterm>
 
-	<para>If you do not know the name of the application you want,
-	  try using a site like Freecode (<ulink
-	    url="http://www.freecode.com/"></ulink>) to find an
+	<para>If you do not know the name of an application,
+	  try using a site like <ulink
+	    url="http://www.freecode.com/">Freecode.com</ulink> to find an
 	  application, then check back at the &os; site to see if
 	  the application has been ported yet.</para>
       </listitem>
 
       <listitem>
-	<para>To find out which category a port is in, type
+	<para>If the Ports Collection is already installed, there are
+	  several methods to query the local version of the ports tree.
+	  To find out which category a port is in, type
 	  <command>whereis <replaceable>file</replaceable></command>,
 	  where <replaceable>file</replaceable> is the program to be
 	  installed:</para>
@@ -270,7 +272,7 @@ lsof: /usr/ports/sysutils/lsof</screen>
 	<screen>&prompt.root; <userinput>echo /usr/ports/*/*lsof*</userinput>
 /usr/ports/sysutils/lsof</screen>
 
-	<para>Note that this will return any matched files downloaded
+	<para>Note that this will also return any matched files downloaded
 	  into the <filename
 	    class="directory">/usr/ports/distfiles</filename>
 	  directory.</para>
@@ -280,7 +282,7 @@ lsof: /usr/ports/sysutils/lsof</screen>
 	<para>Another way to find software is by using the Ports
 	  Collection's built-in search mechanism.  To use
 	    the search feature, <application>cd</application> to
-	  <filename>/usr/ports</filename> then run <command>make
+	  <filename class="directory">/usr/ports</filename> then run <command>make
 	    <maketarget>search</maketarget>
 	    name=<replaceable>program-name</replaceable></command>
 	  where <replaceable>program-name</replaceable> is the name of
@@ -289,17 +291,17 @@ lsof: /usr/ports/sysutils/lsof</screen>
 
 	<screen>&prompt.root; <userinput>cd /usr/ports</userinput>
 &prompt.root; <userinput>make search name=lsof</userinput>
-Port:   lsof-4.56.4
+Port:   lsof-4.88.d,8
 Path:   /usr/ports/sysutils/lsof
 Info:   Lists information about open files (similar to fstat(1))
-Maint:  obrien at FreeBSD.org
+Maint:  ler at lerctr.org
 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
+	  <para>The built-in search mechanism uses a file
+	    of index information.  If a message indicates that the
 	    <filename>INDEX</filename> is required, run
 	    <command>make fetchindex</command> to download the current
 	    index file.  With the <filename>INDEX</filename> present,
@@ -315,7 +317,7 @@ R-deps: </screen>
 
 	<screen>&prompt.root; <userinput>cd /usr/ports</userinput>
 &prompt.root; <userinput>make quicksearch name=lsof</userinput>
-Port:   lsof-4.87.a,7
+Port:   lsof-4.88.d,8
 Path:   /usr/ports/sysutils/lsof
 Info:   Lists information about open files (similar to fstat(1))</screen>
 
@@ -329,8 +331,8 @@ Info:   Lists information about open fil
 	  in order to find ports which relate to a particular subject
 	  when the name of the program is unknown.</para>
 
-	<para>When using (<maketarget>search</maketarget> and
-	  <maketarget>quicksearch</maketarget>), the search string
+	<para>When using <maketarget>search</maketarget> or
+	  <maketarget>quicksearch</maketarget>, the search string
 	  is case-insensitive.  Searching for <quote>LSOF</quote> will
 	  yield the same results as searching for
 	  <quote>lsof</quote>.</para>