From owner-freebsd-doc@FreeBSD.ORG Tue Apr 22 21:30: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 928FB106564A for ; Tue, 22 Apr 2008 21:30: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 71F228FC23 for ; Tue, 22 Apr 2008 21:30: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 m3MLU2gG075688 for ; Tue, 22 Apr 2008 21:30:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m3MLU2Y6075685; Tue, 22 Apr 2008 21:30:02 GMT (envelope-from gnats) Resent-Date: Tue, 22 Apr 2008 21:30:02 GMT Resent-Message-Id: <200804222130.m3MLU2Y6075685@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 27045106566C for ; Tue, 22 Apr 2008 21:25:10 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.187]) by mx1.freebsd.org (Postfix) with ESMTP id A12308FC14 for ; Tue, 22 Apr 2008 21:25:09 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by nf-out-0910.google.com with SMTP id b2so995511nfb.33 for ; Tue, 22 Apr 2008 14:25:08 -0700 (PDT) Received: by 10.78.120.15 with SMTP id s15mr45060huc.108.1208899508372; Tue, 22 Apr 2008 14:25:08 -0700 (PDT) Received: from pgj@FreeBSD.org ( [80.98.116.90]) by mx.google.com with ESMTPS id 34sm4204075nfu.4.2008.04.22.14.25.06 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 22 Apr 2008 14:25:07 -0700 (PDT) Received: by pgj@FreeBSD.org (sSMTP sendmail emulation); Tue, 22 Apr 2008 23:25:04 +0200 Message-Id: <480e57b3.2215300a.6654.6407@mx.google.com> Date: Tue, 22 Apr 2008 23:25:04 +0200 From: "Gabor PALI" Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/122997: [patch] Fix makevar, maketarget Tags in Handbook Chapter 4. (corrected) 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: Tue, 22 Apr 2008 21:30:02 -0000 >Number: 122997 >Category: docs >Synopsis: [patch] Fix makevar, maketarget Tags in Handbook Chapter 4. (corrected) >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: Tue Apr 22 21:30:02 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: This is the revisited version of doc/122906, without whitespace related changes (I hope at least): 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: Here is the corrected 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 12:25:59 -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,7 @@ 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 +946,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,8 +981,8 @@ You can save two extra steps by just running make - install clean instead of make, - make install and make clean + install clean instead of make, + make install and make clean as three separate steps. @@ -1042,7 +1042,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,13 +1128,13 @@ 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 + 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 + 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 + 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 +1200,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,7 +1267,7 @@ 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 + make install clean command, it will upgrade all the dependencies prior to building and installing the selected port. @@ -1386,7 +1386,7 @@ 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 + clean command. You can sweep the whole Ports Collection with the following command: &prompt.root; portsclean -C @@ -1503,7 +1503,7 @@ Ask the maintainer of the port for help. Type - make maintainer or read the + 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: --- ports.patch.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: