Date: Wed, 2 Oct 2013 11:47:12 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42801 - head/en_US.ISO8859-1/books/handbook/ports Message-ID: <201310021147.r92BlCCp094636@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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@FreeBSD.org +Maint: ler@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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201310021147.r92BlCCp094636>