Clarify usage of "make search key=program-name" vs.

"make search name=program-name"

PR:		docs/34209
Submitted by:	Marian Cerny <cerny@spnv.sk>
Patch by:	Andrew McKay <andy@openirc.co.uk>

en_US.ISO8859-1/books/handbook/ports/chapter.sgml

@@ -652,13 +652,13 @@ lsof: /usr/ports/sysutils/lsof</screen>
         ports collection's built-in search mechanism.  To use the search
         feature, you will need to be in the
 	<filename>/usr/ports</filename> directory.  Once in that
-	directory, run <command>make search key=program-name</command>
+	directory, run <command>make search name=program-name</command>
 	where <quote>program-name</quote> is the name of the program you
 	want to find.  For example, if you were looking for 
 	<command>lsof</command>:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports</userinput>
-&prompt.root; <userinput>make search key=lsof</userinput>
+&prompt.root; <userinput>make search name=lsof</userinput>
 Port:   lsof-4.56.4
 Path:   /usr/ports/sysutils/lsof
 Info:   Lists information about open files (similar to fstat(1))
@@ -673,6 +673,17 @@ R-deps: </screen>
 	to install the port directly, so it will not be covered
 	here.</para>
 
+      <para>For more in-depth searching you can also use
+       <command>make search key=string</command> where 
+       <quote>string</quote> is some text to search for.  This searches 
+       port names, comments, descriptions and dependencies and can be used 
+       to find ports which relate to a particular subject if you don't 
+       know the name of the program you are looking for.</para>
+
+      <para>In both of these cases, the search string is case-insensitive.
+       Searching for <quote>LSOF</quote> will yield the same results as 
+       searching for <quote>lsof</quote>.</para>
+
       <note>
         <para>You must be the <username>root</username> user to install
           ports.</para>