From owner-freebsd-doc@FreeBSD.ORG Sun Nov 18 16:50:01 2012 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 9AFA5905 for ; Sun, 18 Nov 2012 16:50:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 6D38E8FC12 for ; Sun, 18 Nov 2012 16:50:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id qAIGo16O043378 for ; Sun, 18 Nov 2012 16:50:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id qAIGo1Tl043374; Sun, 18 Nov 2012 16:50:01 GMT (envelope-from gnats) Resent-Date: Sun, 18 Nov 2012 16:50:01 GMT Resent-Message-Id: <201211181650.qAIGo1Tl043374@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Edward Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 7A0128F5 for ; Sun, 18 Nov 2012 16:48:52 +0000 (UTC) (envelope-from edward@rdtan.net) Received: from mail-da0-f54.google.com (mail-da0-f54.google.com [209.85.210.54]) by mx1.freebsd.org (Postfix) with ESMTP id 477568FC08 for ; Sun, 18 Nov 2012 16:48:51 +0000 (UTC) Received: by mail-da0-f54.google.com with SMTP id z9so1940113dad.13 for ; Sun, 18 Nov 2012 08:48:51 -0800 (PST) Received: by 10.66.80.194 with SMTP id t2mr29225662pax.43.1353257331413; Sun, 18 Nov 2012 08:48:51 -0800 (PST) Received: from rdtan.net ([211.24.220.13]) by mx.google.com with ESMTPS id vi9sm4702240pbc.41.2012.11.18.08.48.48 (version=SSLv3 cipher=OTHER); Sun, 18 Nov 2012 08:48:50 -0800 (PST) Received: by rdtan.net (sSMTP sendmail emulation); Mon, 19 Nov 2012 00:48:45 +0800 Message-Id: <50a91172.49ee440a.152c.5dc2@mx.google.com> Date: Mon, 19 Nov 2012 00:48:45 +0800 From: "Edward" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/173704: [PATCH] Addition to port searching feature - quicksearch X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: Edward List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Nov 2012 16:50:01 -0000 >Number: 173704 >Category: docs >Synopsis: [PATCH] Addition to port searching feature - quicksearch >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sun Nov 18 16:50:01 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Edward >Release: FreeBSD 8.3-RELEASE amd64 >Organization: >Environment: System: FreeBSD docs 8.3-RELEASE FreeBSD 8.3-RELEASE #0: Mon Apr 9 21:23:18 UTC 2012 root@mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64 >Description: Searching for a port in /usr/ports has another feature other then "make search name=port-name", is "make quicksearch name=port-name". This patch attempt to add a brief intro and example of using this feature. >How-To-Repeat: >Fix: --- diff.txt begins here --- --- chapter.xml.original 2012-11-18 01:38:13.000000000 +0800 +++ chapter.xml 2012-11-19 00:15:49.000000000 +0800 @@ -349,19 +349,32 @@ provided is not needed in order to install the port, so it will not be covered here. + Alternatively, there is another search feature from ports that + achieves the same purpose but with less noise, the + quicksearch feature. This feature accepts the same + parameter as the search feature. For example, + searching for lsof would return: + + &prompt.root; cd /usr/ports +&prompt.root; make quicksearch name=lsof +Port: lsof-4.87.a,7 +Path: /usr/ports/sysutils/lsof +Info: Lists information about open files (similar to fstat(1)) + For more in-depth searching you can also use make search - key=string where - string 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. - - In both of these cases, the search string is - case-insensitive. Searching for LSOF will - yield the same results as searching for - lsof. + key=string or make + quicksearch + key=string, where + string 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. + + In both of these cases (search and + quicksearch), the search string is + case-insensitive. Searching for LSOF will yield the same + results as searching for lsof. --- diff.txt ends here --- >Release-Note: >Audit-Trail: >Unformatted: