Date: Sun, 18 Nov 2012 17:57:31 +0000 (UTC) From: Benedict Reuschling <bcr@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r40082 - head/en_US.ISO8859-1/books/handbook/ports Message-ID: <201211181757.qAIHvV10080133@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: bcr Date: Sun Nov 18 17:57:31 2012 New Revision: 40082 URL: http://svnweb.freebsd.org/changeset/doc/40082 Log: Add a section describing the use of the quicksearch feature to find ports. PR: docs/173704 Submitted by: Edward (edward rdtan net) 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 Sun Nov 18 17:29:59 2012 (r40081) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sun Nov 18 17:57:31 2012 (r40082) @@ -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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201211181757.qAIHvV10080133>