From owner-svn-doc-head@FreeBSD.ORG Wed Oct 2 11:47:12 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 56A63524; Wed, 2 Oct 2013 11:47:12 +0000 (UTC) (envelope-from dru@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 353012204; Wed, 2 Oct 2013 11:47:12 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r92BlCbL094637; Wed, 2 Oct 2013 11:47:12 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r92BlCCp094636; Wed, 2 Oct 2013 11:47:12 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310021147.r92BlCCp094636@svn.freebsd.org> From: Dru Lavigne Date: Wed, 2 Oct 2013 11:47:12 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Oct 2013 11:47:12 -0000 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 @@ FreshPorts Dan Langille maintains FreshPorts which + url="http://www.FreshPorts.org/">FreshPorts.org 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 @@ Freecode - If you do not know the name of the application you want, - try using a site like Freecode () to find an + If you do not know the name of an application, + try using a site like Freecode.com to find an application, then check back at the &os; site to see if the application has been ported yet. - To find out which category a port is in, type + 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 whereis file, where file is the program to be installed: @@ -270,7 +272,7 @@ lsof: /usr/ports/sysutils/lsof &prompt.root; echo /usr/ports/*/*lsof* /usr/ports/sysutils/lsof - Note that this will return any matched files downloaded + Note that this will also return any matched files downloaded into the /usr/ports/distfiles directory. @@ -280,7 +282,7 @@ lsof: /usr/ports/sysutils/lsof Another way to find software is by using the Ports Collection's built-in search mechanism. To use the search feature, cd to - /usr/ports then run make + /usr/ports then run make search name=program-name where program-name is the name of @@ -289,17 +291,17 @@ lsof: /usr/ports/sysutils/lsof &prompt.root; cd /usr/ports &prompt.root; make search name=lsof -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: - make search searches through a file - of index information. If a message indicates the + The built-in search mechanism uses a file + of index information. If a message indicates that the INDEX is required, run make fetchindex to download the current index file. With the INDEX present, @@ -315,7 +317,7 @@ R-deps: &prompt.root; cd /usr/ports &prompt.root; make quicksearch name=lsof -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)) @@ -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. - When using (search and - quicksearch), the search string + When using search or + quicksearch, the search string is case-insensitive. Searching for LSOF will yield the same results as searching for lsof.