From owner-freebsd-doc Fri Aug 16 9: 0:27 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 0FD1337B401 for ; Fri, 16 Aug 2002 09:00:14 -0700 (PDT) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id EF7DB43E4A for ; Fri, 16 Aug 2002 09:00:11 -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 g7GG0BJU020857 for ; Fri, 16 Aug 2002 09:00:11 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g7GG0BMg020856; Fri, 16 Aug 2002 09:00:11 -0700 (PDT) Date: Fri, 16 Aug 2002 09:00:11 -0700 (PDT) Message-Id: <200208161600.g7GG0BMg020856@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Christian Brueffer Subject: Re: docs/41534: [PATCH] Various fixes to books/porters-handbook/book.sgml Reply-To: Christian Brueffer 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 The following reply was made to PR docs/41534; it has been noted by GNATS. From: Christian Brueffer To: FreeBSD-gnats-submit@FreeBSD.ORG Cc: Subject: Re: docs/41534: [PATCH] Various fixes to books/porters-handbook/book.sgml Date: Fri, 16 Aug 2002 18:01:18 +0000 I've created new patches with the changes recently made by blackend to the porters-handbook removed. Also this one fixes some stupidities I've made. The whole thing is separated into real fixes (first patch) and whitespace fixes (second patch). --- book.sgml Tue Aug 13 20:24:21 2002 +++ book.sgml.fixes Fri Aug 16 17:14:00 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,7 @@ textproc Text processing utilities. It does not include - desktop publishing tools, which go to print/. + desktop publishing tools, which go to print. @@ -2263,8 +2263,8 @@ To depend on another port unconditionally, use the 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 + RUN_DEPENDS. Use this only when you need + the port to get to the source of the other port. You can often save compilation time by specifying the target too. For instance @@ -2291,7 +2291,7 @@ 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 + make users happy, and effectively provide 2 or more ports for the price of one. The easiest of these to use is @@ -2341,7 +2341,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 +2431,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 @@ -3680,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. @@ -3799,12 +3799,12 @@ <makevar>PREFIX</makevar> Do try to make your port install relative to - PREFIX. (The value of this variable will be set + PREFIX (the value of this variable will be set to LOCALBASE (default /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 @@ -3832,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 @@ -3885,7 +3885,7 @@ 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 + 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 --- book.sgml.fixes Fri Aug 16 17:14:00 2002 +++ book.sgml.whitespace Fri Aug 16 17:19:14 2002 @@ -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. @@ -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 users 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 @@ -3885,8 +3886,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 - Christian -- http://www.unixpages.org chris@unixpages.org GPG Pub-Key : www.unixpages.org/cbrueffer.asc GPG Fingerprint: 0DB5 8563 2473 C72A A8D1 56EA DAD2 B05D 5F3C 3185 GPG Key ID : DAD2B05D5F3C3185 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message