From owner-freebsd-doc Sat Aug 10 17:20:16 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 069DB37B400 for ; Sat, 10 Aug 2002 17:20:03 -0700 (PDT) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3C77D43E70 for ; Sat, 10 Aug 2002 17:20:02 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.4/8.12.4) with ESMTP id g7B0K2JU046575 for ; Sat, 10 Aug 2002 17:20:02 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g7B0K2lH046574; Sat, 10 Aug 2002 17:20:02 -0700 (PDT) Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A2B5337B400 for ; Sat, 10 Aug 2002 17:16:35 -0700 (PDT) Received: from milan.hitnet.rwth-aachen.de (milan.hitnet.RWTH-Aachen.DE [137.226.181.144]) by mx1.FreeBSD.org (Postfix) with ESMTP id AC52843E7B for ; Sat, 10 Aug 2002 17:16:34 -0700 (PDT) (envelope-from chris@milan.hitnet.rwth-aachen.de) Received: by milan.hitnet.rwth-aachen.de (Postfix, from userid 1001) id 34F43ABAE; Sun, 11 Aug 2002 02:16:33 +0200 (CEST) Message-Id: <20020811001633.34F43ABAE@milan.hitnet.rwth-aachen.de> Date: Sun, 11 Aug 2002 02:16:33 +0200 (CEST) From: Christian Brueffer Reply-To: Christian Brueffer To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/41534: [PATCH] Various fixes to books/porters-handbook/book.sgml Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 41534 >Category: docs >Synopsis: [PATCH] Various fixes to books/porters-handbook/book.sgml >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 Aug 10 17:20:01 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Christian Brueffer >Release: FreeBSD 4.6-STABLE i386 >Organization: >Environment: System: FreeBSD milan.hitnet.rwth-aachen.de 4.6-STABLE FreeBSD 4.6-STABLE #2: Fri Jun 28 12:47:08 CEST 2002 chris@milan.hitnet.rwth-aachen.de:/usr/obj/usr/src/sys/LORIEN i386 >Description: - add missing tags - fix some typos and missing characters - grammar fixes >How-To-Repeat: >Fix: --- porters-handbook.diff begins here --- --- book.sgml.orig Fri Aug 9 17:56:36 2002 +++ book.sgml Sun Aug 11 02:09:49 2002 @@ -325,7 +325,7 @@ port_dir` in a bug report and send it with the &man.send-pr.1; program (see Bug Reports and General Commentary for more information about - &man.send-pr.1;. If the uncompressed port is larger than 20KB, + &man.send-pr.1;). If the uncompressed port is larger than 20KB, you should compress it into a tarfile and use &man.uuencode.1; before including it in the bug report (uuencoded tarfiles are acceptable even if the bug report is smaller than 20KB but are not @@ -1552,7 +1552,8 @@ textproc Text processing utilities. It does not include - desktop publishing tools, which go to print/. + desktop publishing tools, which go to + print. @@ -1603,7 +1604,7 @@ - x11 + x11 The X window system and friends. This category is only for software that directly supports the window system. Do not put regular X applications here. If your port is an X @@ -2264,7 +2265,7 @@ variable ${NONEXISTENT} as the first field of BUILD_DEPENDS or RUN_DEPENDS. Use this only when you need to - the to get to the source of the other port. You can often save + get to the source of the other port. You can often save compilation time by specifying the target too. For instance @@ -2291,8 +2292,8 @@ want those libraries or applications, the ports system provides hooks that the port author can use to decide which configuration should be built. Supporting these properly will - make uses happy, and effectively provide 2 or more ports for the - price of one. + make users happy, and effectively provide 2 or more ports for + the price of one. The easiest of these to use is WITHOUT_X11. If the port can be built both @@ -2341,7 +2342,7 @@ <makevar>WRKSRC</makevar> - The variable lists the name of the directoy that is created when + The variable lists the name of the directory that is created when the application's distfiles are extracted. If our previous example extracted into a directory called foo (and not foo-1.0) you would write: @@ -2431,8 +2432,8 @@ deinstallation will not cause the system to still believe the library is there. - If you need, you can override default location where the new - library is installed by defining LDCONFIG_DIRS + If you need, you can override the default location where the new + library is installed by defining the LDCONFIG_DIRS make variable, which should contain a list of directories into which shared libraries are to be installed. For example if your port installs shared libraries into @@ -3679,7 +3680,7 @@ PLIST_SUB variable with a list of VAR=VALUE pairs and instances of - %%VAR%%' will be + %%VAR%% will be substituted with VALUE in the pkg-plist. @@ -3803,7 +3804,7 @@ /usr/local), unless USE_X_PREFIX or USE_IMAKE is set, in which case it will be X11BASE (default - /usr/X11R6).) + /usr/X11R6). Not hard-coding /usr/local or /usr/X11R6 anywhere in the source will make the @@ -3831,7 +3832,7 @@ or correct use of LOCALBASE for references to files from other ports. Testing the installation in /var/tmp/port-name - to do that that while you have it installed would do that. + to do that while you have it installed would do that. Do not set USE_X_PREFIX unless your port truly requires it (i.e., it links against X libs or it needs to @@ -3868,8 +3869,9 @@ version from the original authors, first make sure you have the latest port. You can find them in the ports/ports-current directory of the FTP mirror - sites. You may also use CVSup to keep your whole ports collection - up-to-date, as described in the Handbook. + sites. You may also use CVSup to + keep your whole ports collection up-to-date, as described in + the Handbook. The next step is to send a mail to the maintainer, if one is listed in the port's Makefile. That person may --- porters-handbook.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message