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

Add a section describing the use of the quicksearch feature to

Browse source 
find ports.

PR:		docs/173704
Submitted by:	Edward (edward rdtan net)
This commit is contained in:
Benedict Reuschling 2012-11-18 17:57:31 +00:00
parent 846f80518f
commit fa12d0d4db
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=40082
1 changed files with 19 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

22
en_US.ISO8859-1/books/handbook/ports/chapter.xml
View file

@ -349,17 +349,33 @@ R-deps: </screen>
provided is not needed in order to install the port, so it
will not be covered here.</para>
<para>Alternatively, there is another search feature from
ports that achieves the same purpose but with less noise,
the <command>quicksearch</command> feature. This feature
accepts the same parameter as the <command>search</command>
feature. For example, searching for <command>lsof</command>
would return:</para>
<screen>&prompt.root; <userinput>cd /usr/ports</userinput>
&prompt.root; <userinput>make quicksearch name=lsof</userinput>
Port: lsof-4.87.a,7
Path: /usr/ports/sysutils/lsof
Info: Lists information about open files (similar to fstat(1))</screen>
<para>For more in-depth searching you can also use
<command>make <maketarget>search</maketarget>
key=<replaceable>string</replaceable></command> where
key=<replaceable>string</replaceable></command> or
<command>make <maketarget>quicksearch</maketarget>
key=<replaceable>string</replaceable></command>, where
<replaceable>string</replaceable> 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 do not 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
<para>In both of these cases (<maketarget>search</maketarget>
and <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>
</listitem>