From owner-freebsd-doc Sun May 16 22:30: 8 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id EDE2F1522B for ; Sun, 16 May 1999 22:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id WAA31646; Sun, 16 May 1999 22:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from leap.innerx.net (leap.innerx.net [38.179.176.25]) by hub.freebsd.org (Postfix) with ESMTP id C06E214F6B for ; Sun, 16 May 1999 22:28:06 -0700 (PDT) (envelope-from chris@holly.dyndns.org) Received: from holly.dyndns.org (ip150.houston13.tx.pub-ip.psi.net [38.27.213.150]) by leap.innerx.net (Postfix) with ESMTP id 26C003706D for ; Mon, 17 May 1999 01:28:01 -0400 (EDT) Received: (from chris@localhost) by holly.dyndns.org (8.9.3/8.9.3) id AAA10314; Mon, 17 May 1999 00:29:34 -0500 (CDT) (envelope-from chris) Message-Id: <199905170529.AAA10314@holly.dyndns.org> Date: Mon, 17 May 1999 00:29:34 -0500 (CDT) From: chris@calldei.com Reply-To: chris@calldei.com To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/11740: [Patch] doc/en/handbook/patch/chapter.sgml has various bugs (sorry Nik!) Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 11740 >Category: docs >Synopsis: [Patch] doc/en/handbook/patch/chapter.sgml has various bugs (sorry Nik!) >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun May 16 22:30:01 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Chris Costello >Release: FreeBSD 4.0-CURRENT i386 >Organization: CVS Diff Express, Inc. >Environment: Doc tree, CVSupped around 1:00 PM on 17 May. >Description: To make the handbook work like Nik's doc tutorial, I've changed many contractions to their respective expanded meanings. To keep the documentation up with the software, I have also updated the __FreeBSD_version table to include the latest -CURRENT changes and the introduction of 3.2-STABLE. >How-To-Repeat: http://www.freebsd.org/handbook/ports.html >Fix: Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en/handbook/ports/chapter.sgml,v retrieving revision 1.17 diff -u -1 -r1.17 chapter.sgml --- chapter.sgml 1999/05/16 13:28:26 1.17 +++ chapter.sgml 1999/05/17 05:17:37 @@ -119,3 +119,3 @@ - Fear not, gentle reader, all will become clear (hopefully). Let's + Fear not, gentle reader, all will become clear (hopefully). Let us see what happens if we try and install a port. I have chosen @@ -313,4 +313,4 @@ - Let's try something more ambitious now. Instead of getting a - single port skeleton, let's get a whole sub-directory, for example all + Let us try something more ambitious now. Instead of getting a + single port skeleton, we will get a whole sub-directory, for example all the database skeletons in the ports collection. It looks almost the @@ -764,3 +764,3 @@ used the option as well. - (Most of the ports don't use ). You + (Most of the ports do not use ). You should be able to specify the compiler options @@ -796,3 +796,3 @@ system suddenly stopped compiling it and starting compiling the - bar port. What's going on? + bar port. What is going on? @@ -948,3 +948,3 @@ include. Please refer to that file for more details on the inner - workings of the ports collection. Even if you don't hack Makefiles + workings of the ports collection. Even if you do not hack Makefiles daily, it is well commented, and you will still gain much knowledge from @@ -1179,3 +1179,3 @@ - Make sure that there aren't any warnings issued in any of the + Make sure that there are not any warnings issued in any of the package and @@ -1660,3 +1660,3 @@ If the patch is distributed with some other files, such as - documentation, in a gzip'd tarball, you can't just use + documentation, in a gzip'd tarball, you cannot just use PATCHFILES. If that is the case, add the name @@ -1849,3 +1849,3 @@ some versions of FreeBSD has perl5 as part of the base system - while others don't.) + while others do not.) @@ -1996,3 +1996,3 @@ /usr/local/lib and similar to an - aout subdirectory. (If you don't move them out + aout subdirectory. (If you do not move them out of the way, ELF ports will happily overwrite a.out libraries.) The @@ -2260,3 +2260,3 @@ NO_INSTALL_MANPAGES is not set, and to - no otherwise. You don't have to explicitly define + no otherwise. You do not have to explicitly define it unless the default is not suitable for your port. @@ -2315,3 +2315,3 @@ If your port requires Motif, define this variable in the - Makefile. This will prevent people who don't own a copy of Motif + Makefile. This will prevent people who do not own a copy of Motif from even attempting to build it. @@ -2405,3 +2405,3 @@ @dircategory and @direntry - statements to files that don't have them. This is part of my + statements to files that do not have them. This is part of my patch: @@ -2449,3 +2449,3 @@ to use the extra arguments to install-info - because makeinfo can't handle those texinfo + because makeinfo cannot handle those texinfo sources. (See Makefile and @@ -2461,3 +2461,3 @@ make; but many Makefiles - don't include correct dependencies for info files. In + do not include correct dependencies for info files. In emacs' case, I had to patch the main @@ -2585,5 +2585,5 @@ /usr/share/info/dir and the above command to - create a new info file. In fact, I'd add the first three lines of - the above patch to bsd.port.mk if you (the - porter) wouldn't have to do it in PLIST by + create a new info file. In fact, I would add the first three lines + of the above patch to bsd.port.mk if you (the + porter) would not have to do it in PLIST by yourself anyway. @@ -2645,3 +2645,3 @@ - There are some tricks we haven't mentioned yet about the + There are some tricks we have not mentioned yet about the pkg/ subdirectory that come in handy @@ -2849,3 +2849,3 @@ license, set the variable NO_CDROM to a string - describing the reason why. We will make sure such ports won't go + describing the reason why. We will make sure such ports will not go into the CD-ROM come release time. The distfile and package will @@ -2856,6 +2856,6 @@ If the resulting package needs to be built uniquely for each - site, or the resulting binary package can't be distributed due to + site, or the resulting binary package cannot be distributed due to licensing; set the variable NO_PACKAGE to a string describing the reason why. We will make sure such packages - won't go on the ftp site, nor into the CD-ROM come release time. + will not go on the ftp site, nor into the CD-ROM come release time. The distfile will still be included on both however. @@ -2898,3 +2898,3 @@ - If the maintainer asks you to do the upgrade or there isn't any + If the maintainer asks you to do the upgrade or there is not any such person to begin with, please make the upgrade and send the @@ -2971,3 +2971,3 @@ INSTALL_MAN is a command to install - manpages and other documentation (it doesn't compress + manpages and other documentation (it does not compress anything). @@ -2998,3 +2998,3 @@ Make sure your port honors WRKDIRPREFIX. - Most ports don't have to worry about this. In particular, if you + Most ports do not have to worry about this. In particular, if you are referring to a WRKDIR of another port, note @@ -3033,3 +3033,3 @@ sys/param.h. If you find a system that - doesn't, we would like to know. Please send mail to the + does not, we would like to know. Please send mail to the &a.ports;. @@ -3044,3 +3044,3 @@ - Don't forget to add -DHAVE_SYS_PARAM_H to the + Do not forget to add -DHAVE_SYS_PARAM_H to the CFLAGS in the Makefile for @@ -3301,2 +3301,12 @@ + + + 3.1-STABLE after C++ constructor/destructor order change + 310002 + + + + 3.2-STABLE + 320001 + @@ -3306,2 +3316,28 @@ + + + 4.0-CURRENT after change in dynamic linker handling + 400001 + + + + 4.0-CURRENT after C++ constructor/destructor order change + 400002 + + + + 4.0-CURRENT after functioning dladdr(3) + 400003 + + + + 4.0-CURRENT after newbus + 400004 + + + + 4.0-CURRENT after suser(9) API change + 400005 + + @@ -3319,3 +3355,3 @@ it infeasible to classify the releases simply by their real - release dates. If you are making a port now, you don't have to + release dates. If you are making a port now, you do not have to worry about old -CURRENTs; they are listed here just for your @@ -3343,3 +3379,3 @@ pre.mk/post.mk pair or - bsd.port.mk only; don't mix these two. + bsd.port.mk only; do not mix these two. @@ -3553,3 +3589,3 @@ diff to generate patches is fine, but please take - a look at the resulting patches to make sure you don't have any + a look at the resulting patches to make sure you do not have any unnecessary junk in there. In particular, diffs between two backup @@ -3689,3 +3725,3 @@ - Make sure you don't use a UID already used by the system or + Make sure you do not use a UID already used by the system or other ports. This is the current list of UIDs between 50 and @@ -3736,3 +3772,3 @@ The port should respect the CFLAGS variable. - If it doesn't, please add NO_PACKAGE=ignores + If it does not, please add NO_PACKAGE=ignores cflags to the Makefile. @@ -3783,6 +3819,6 @@ - Don't copy more copies of the GNU General Public License into + Do not copy more copies of the GNU General Public License into our system, please. - Please be careful to note any legal issues! Don't let us + Please be careful to note any legal issues! Do not let us illegally distribute software! @@ -3843,3 +3879,3 @@ [do not forget the trailing slash ("/")! - if you aren't using MASTER_SITE_* macros] + if you are not using MASTER_SITE_* macros] MASTER_SITES= ${MASTER_SITE_XCONTRIB} @@ -3909,3 +3945,3 @@ - If your DISTNAME doesn't look like that, set + If your DISTNAME does not look like that, set PKGNAME to something in that format. @@ -4171,4 +4207,4 @@ Development utilities. Do not put libraries here just - because they are libraries—unless they truly don't - belong to anywhere else, they shouldn't be in this + because they are libraries—unless they truly do not + belong to anywhere else, they should not be in this category. @@ -4253,3 +4289,3 @@ Miscellaneous utilities—basically things that - doesn't belong to anywhere else. This is the only category + does not belong to anywhere else. This is the only category that should not appear with any other non-virtual category. @@ -4444,3 +4480,3 @@ instance, an HTML editor should be listed as www - editors, not the other way around. Also, you don't + editors, not the other way around. Also, you do not need to list net when the port belongs to >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message