From owner-freebsd-doc@FreeBSD.ORG Sat Apr 19 11:00:02 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3AEEB1065675 for ; Sat, 19 Apr 2008 11:00:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1362E8FC38 for ; Sat, 19 Apr 2008 11:00:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m3JB01jO066385 for ; Sat, 19 Apr 2008 11:00:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m3JB01bf066384; Sat, 19 Apr 2008 11:00:01 GMT (envelope-from gnats) Resent-Date: Sat, 19 Apr 2008 11:00:01 GMT Resent-Message-Id: <200804191100.m3JB01bf066384@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, Gabor PALI Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 24A52106566B for ; Sat, 19 Apr 2008 10:51:45 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from fk-out-0910.google.com (fk-out-0910.google.com [209.85.128.187]) by mx1.freebsd.org (Postfix) with ESMTP id 9E6F98FC38 for ; Sat, 19 Apr 2008 10:51:44 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by fk-out-0910.google.com with SMTP id b27so1453226fka.11 for ; Sat, 19 Apr 2008 03:51:43 -0700 (PDT) Received: by 10.82.127.14 with SMTP id z14mr6502666buc.86.1208602303260; Sat, 19 Apr 2008 03:51:43 -0700 (PDT) Received: from pgj@FreeBSD.org ( [80.98.116.90]) by mx.google.com with ESMTPS id w5sm3916814mue.2.2008.04.19.03.51.41 (version=TLSv1/SSLv3 cipher=OTHER); Sat, 19 Apr 2008 03:51:42 -0700 (PDT) Received: by pgj@FreeBSD.org (sSMTP sendmail emulation); Sat, 19 Apr 2008 12:51:39 +0200 Message-Id: <4809cebe.05ae660a.4813.1cd2@mx.google.com> Date: Sat, 19 Apr 2008 12:51:39 +0200 From: "Gabor PALI" Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/122906: [patch] Fix makevar, maketarget Tags in Handbook Chapter 4. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Gabor PALI List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 19 Apr 2008 11:00:02 -0000 >Number: 122906 >Category: docs >Synopsis: [patch] Fix makevar, maketarget Tags in Handbook Chapter 4. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Apr 19 11:00:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Gabor PALI >Release: FreeBSD 6.3-STABLE i386 >Organization: >Environment: System: FreeBSD disznohal 6.3-STABLE FreeBSD 6.3-STABLE #4: Fri Apr 4 23:29:43 CEST 2008 dezzy@disznohal:/usr/obj/usr/src/sys/GENERIC_ i386 >Description: I found a small inconsistency in the use of maketarget, makevar tags in SGML source of the Handbook chapter titled ``Packages and Ports''. So, I created a patch to unify their usage and make all consistent in the PORTS_CHAPTER :) >How-To-Repeat: >Fix: Apply the following patch: --- ports.patch.diff begins here --- Index: chapter.sgml =================================================================== RCS file: /doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml,v retrieving revision 1.279 diff -u -r1.279 chapter.sgml --- chapter.sgml 29 Mar 2008 04:00:09 -0000 1.279 +++ chapter.sgml 19 Apr 2008 10:42:24 -0000 @@ -318,7 +318,7 @@ Ports Collection's built-in search mechanism. To use the search feature, you will need to be in the /usr/ports directory. Once in that - directory, run make search + directory, run make search name=program-name where program-name is the name of the program you want to find. For example, if you were looking @@ -341,7 +341,8 @@ will not be covered here. For more in-depth searching you can also use make - search key=string where + 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 @@ -946,7 +947,7 @@ returned to your prompt. The next step is to install the port. In order to install it, you simply need to tack one word onto the make command, and that word is - install: + install: &prompt.root; make install ===> Installing for lsof-4.57 @@ -981,9 +982,11 @@ You can save two extra steps by just running make - install clean instead of make, - make install and make clean - as three separate steps. + install clean instead of + make, make + install and make + clean as three separate + steps. @@ -1042,7 +1045,7 @@ You can build all the ports in a category or as a whole by running make in the top level directory, just like the aforementioned make - fetch method. This is + fetch method. This is dangerous, however, as some ports cannot co-exist. In other cases, some ports can install two different files with the same filename. @@ -1128,15 +1131,15 @@ It is not uncommon for users to wish to revisit this menu to add, remove, or change these options after a port has been built. There are many ways to do this. One option is to go into the directory - containing the port and type make - config, which will simply present the menu - again with the same options selected. Another option is to use - make showconfig which + containing the port and type make + config, which will simply present + the menu again with the same options selected. Another option is to + use make showconfig which will show you all the configuration options for the port. Yet - another option is to execute make - rmconfig which will remove all selected - options and allow you to start over. All of these options, and - others, are explained in great detail in in the man page for + another option is to execute make + rmconfig which will remove all + selected options and allow you to start over. All of these options, + and others, are explained in great detail in in the man page for &man.ports.7;. @@ -1200,8 +1203,8 @@ The portupgrade utility is designed to easily upgrade installed ports. It is available from the ports-mgmt/portupgrade port. Install it like - any other port, using the make install - clean command: + any other port, using the make install + clean command: &prompt.root; cd /usr/ports/ports-mgmt/portupgrade &prompt.root; make install clean @@ -1267,9 +1270,9 @@ confirmation of every step Portmanager will perform. Portmanager can also be used to install new ports on the system. Unlike the usual - make install clean command, it will upgrade all - the dependencies prior to building and installing the - selected port. + make install clean command, + it will upgrade all the dependencies prior to building and installing + the selected port. &prompt.root; portmanager x11/gnome2 @@ -1385,9 +1388,9 @@ Using the Ports Collection will use up disk space over time. After building and installing software from the ports, you should always remember to clean up - the temporary work directories using the make - clean command. You can sweep the whole - Ports Collection with the following command: + the temporary work directories using the + make clean command. You can sweep + the whole Ports Collection with the following command: &prompt.root; portsclean -C @@ -1503,8 +1506,8 @@ Ask the maintainer of the port for help. Type - make maintainer or read the - Makefile to find the maintainer's + make maintainer + or read the Makefile to find the maintainer's email address. Remember to include the name and version of the port (send the $FreeBSD: line from the Makefile) and the --- ports.patch.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: