os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

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

Browse source 
"make search name=program-name"

PR:		docs/34209
Submitted by:	Marian Cerny <cerny@spnv.sk>
Patch by:	Andrew McKay <andy@openirc.co.uk>
This commit is contained in:
Chern Lee 2002-01-28 19:11:49 +00:00
parent 9bd531049d
commit 8b859ee56e
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=11956
1 changed files with 13 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
en_US.ISO8859-1/books/handbook/ports/chapter.sgml
View file

@ -652,13 +652,13 @@ lsof: /usr/ports/sysutils/lsof</screen>
ports collection's built-in search mechanism. To use the search ports collection's built-in search mechanism. To use the search
feature, you will need to be in the feature, you will need to be in the
<filename>/usr/ports</filename> directory. Once in that <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 where <quote>program-name</quote> is the name of the program you
want to find. For example, if you were looking for want to find. For example, if you were looking for
<command>lsof</command>:</para> <command>lsof</command>:</para>
<screen>&prompt.root; <userinput>cd /usr/ports</userinput> <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 Port: lsof-4.56.4
Path: /usr/ports/sysutils/lsof Path: /usr/ports/sysutils/lsof
Info: Lists information about open files (similar to fstat(1)) 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 to install the port directly, so it will not be covered
here.</para> 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> <note>
<para>You must be the <username>root</username> user to install <para>You must be the <username>root</username> user to install
ports.</para> ports.</para>