diff --git a/en/handbook/ports/chapter.sgml b/en/handbook/ports/chapter.sgml index a3db8259cb..b876be11fd 100644 --- a/en/handbook/ports/chapter.sgml +++ b/en/handbook/ports/chapter.sgml @@ -1,7 +1,7 @@ @@ -117,7 +117,7 @@ “How on earth can this do anything?” I hear you cry. “There is no source code there!” - 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 ElectricFence, a useful tool for developers, as the skeleton is more straightforward than most. @@ -311,8 +311,8 @@ password. Remember to use binary (also known as image) mode!] did not have a copy of the source locally, so it fetched one before extracting, patching and building it. - 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 same:- @@ -762,7 +762,7 @@ do-install: version shipped with FreeBSD 2.1.0 and 2.1.5), the option could result in buggy code unless you 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 used by something like @@ -794,7 +794,7 @@ do-install: Q. I went to install the foo port but the system suddenly stopped compiling it and starting compiling the - bar port. What's going on? + bar port. What is going on? A. The foo port needs something that is supplied with bar — for instance, if @@ -946,7 +946,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc FreeBSD. The bulk of the work is done by /usr/ports/Mk/bsd.port.mk, which all port Makefiles 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 it. @@ -1177,7 +1177,7 @@ lib/X11/oneko/mouse.xpm - 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 deinstall stages, After step 3, check to see if all the new directories are correctly deleted. Also, try @@ -1658,7 +1658,7 @@ MASTER_SITE_SUBDIR= applications .gz or .Z. 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 and the location of the patch tarball to DISTFILES and MASTER_SITES. @@ -1847,7 +1847,7 @@ RUN_DEPENDS= ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ USE_PERL5=yes if your port requires version 5 of the perl language. (The last is especially important since some versions of FreeBSD has perl5 as part of the base system - while others don't.) + while others do not.) @@ -1994,7 +1994,7 @@ lib/libtvl80.so.1 A.out libraries should be moved out of /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 move-aout-libs target in the 3.0-CURRENT src/Makefile (called from @@ -2258,7 +2258,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 MANCOMPRESSED is automatically set to yes if USE_IMAKE is set and 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. If your port anchors its man tree somewhere other than @@ -2313,7 +2313,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz <makevar>REQUIRES_MOTIF</makevar> 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. @@ -2403,7 +2403,7 @@ Options: Look at the texinfo sources and make a patch to insert @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: @@ -2447,7 +2447,7 @@ Options: PLIST; see below). However, if you have a Japanese (or other multibyte encoding) info files, you will have 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 PLIST of japanese/skk for examples on how to do this). @@ -2459,7 +2459,7 @@ Options: from the texinfo sources. Since the texinfo sources are newer than the info files, they should be rebuilt when you type 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 Makefile.in so it will descend into the man subdirectory to rebuild the info @@ -2583,9 +2583,9 @@ diff -u -r1.26 Makefile Do not use anything other than /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. @@ -2643,7 +2643,7 @@ diff -u -r1.15 PLIST The <filename>pkg/</filename> subdirectory - 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 sometimes. @@ -2847,17 +2847,17 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} If the port has a “do not sell for profit” type of 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 still be available via ftp. 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. @@ -2896,7 +2896,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} port right now (because of, for example, stability problems of the new version). - 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 recursive diff (either unified or context diff is fine, but port committers appear to prefer unified diff more) of the new and old @@ -2969,7 +2969,7 @@ post-install: INSTALL_MAN is a command to install - manpages and other documentation (it doesn't compress + manpages and other documentation (it does not compress anything). @@ -2996,7 +2996,7 @@ post-install: <makevar>WRKDIRPREFIX</makevar> 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 that the correct location is WRKDIRPREFIXPORTSDIR/subdir/name/work not PORTSDIR/subdir/name/work or .CURDIR/../../subdir/name/work or some such. @@ -3031,7 +3031,7 @@ post-install: to the proper place in the .c file. We believe that every system that defines these two symbols has 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;. Another way is to use the GNU Autoconf style of doing @@ -3042,7 +3042,7 @@ post-install: #include <sys/param.h> #endif - 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 this method. @@ -3299,11 +3299,47 @@ post-install: 3.1-STABLE after 3.1-RELEASE 310001 + + + 3.1-STABLE after C++ constructor/destructor order change + 310002 + + + + 3.2-STABLE + 320001 + 4.0-CURRENT after 3/4 branch 400000 + + + 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 + + @@ -3317,7 +3353,7 @@ post-install: to a more straightforward major/minor system starting from 2.2. This is because the parallel development on several branches made 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 reference. @@ -3341,7 +3377,7 @@ post-install: You need to include either the pre.mk/post.mk pair or - bsd.port.mk only; don't mix these two. + bsd.port.mk only; do not mix these two. bsd.port.pre.mk only defines a few @@ -3551,7 +3587,7 @@ post-install: Using the recurse () option to 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 files, Makefiles when the port uses Imake or GNU configure, etc., @@ -3687,7 +3723,7 @@ lib/X11/oneko/sounds/cat.au choose a free UID from 50 to 99 and register it below. Look at japanese/Wnn for an example. - 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 99. @@ -3734,7 +3770,7 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh Respect <makevar>CFLAGS</makevar> 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. @@ -3781,10 +3817,10 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh should each be double-checked. If you are reviewing a port and feel they can be worded better, do so. - 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! @@ -3841,7 +3877,7 @@ DISTNAME= xdvi PKGNAME= xdvi-pl18 CATEGORIES= print [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} MASTER_SITE_SUBDIR= applications [set this if the source is not in the standard ".tar.gz" form] @@ -3907,7 +3943,7 @@ pre-install: The package name should look like language-name-compiled.specifics-version.numbers. - If your DISTNAME doesn't look like that, set + If your DISTNAME does not look like that, set PKGNAME to something in that format. @@ -4169,8 +4205,8 @@ pre-install: devel 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. @@ -4251,7 +4287,7 @@ pre-install: misc 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. If you have misc with something else in your CATEGORIES line, that means you can @@ -4442,7 +4478,7 @@ pre-install: Specific categories win over less-specific ones. For 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 either of mail, mbone, news, security, or diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml index a3db8259cb..b876be11fd 100644 --- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml @@ -1,7 +1,7 @@ @@ -117,7 +117,7 @@ “How on earth can this do anything?” I hear you cry. “There is no source code there!” - 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 ElectricFence, a useful tool for developers, as the skeleton is more straightforward than most. @@ -311,8 +311,8 @@ password. Remember to use binary (also known as image) mode!] did not have a copy of the source locally, so it fetched one before extracting, patching and building it. - 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 same:- @@ -762,7 +762,7 @@ do-install: version shipped with FreeBSD 2.1.0 and 2.1.5), the option could result in buggy code unless you 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 used by something like @@ -794,7 +794,7 @@ do-install: Q. I went to install the foo port but the system suddenly stopped compiling it and starting compiling the - bar port. What's going on? + bar port. What is going on? A. The foo port needs something that is supplied with bar — for instance, if @@ -946,7 +946,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc FreeBSD. The bulk of the work is done by /usr/ports/Mk/bsd.port.mk, which all port Makefiles 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 it. @@ -1177,7 +1177,7 @@ lib/X11/oneko/mouse.xpm - 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 deinstall stages, After step 3, check to see if all the new directories are correctly deleted. Also, try @@ -1658,7 +1658,7 @@ MASTER_SITE_SUBDIR= applications .gz or .Z. 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 and the location of the patch tarball to DISTFILES and MASTER_SITES. @@ -1847,7 +1847,7 @@ RUN_DEPENDS= ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ USE_PERL5=yes if your port requires version 5 of the perl language. (The last is especially important since some versions of FreeBSD has perl5 as part of the base system - while others don't.) + while others do not.) @@ -1994,7 +1994,7 @@ lib/libtvl80.so.1 A.out libraries should be moved out of /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 move-aout-libs target in the 3.0-CURRENT src/Makefile (called from @@ -2258,7 +2258,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 MANCOMPRESSED is automatically set to yes if USE_IMAKE is set and 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. If your port anchors its man tree somewhere other than @@ -2313,7 +2313,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz <makevar>REQUIRES_MOTIF</makevar> 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. @@ -2403,7 +2403,7 @@ Options: Look at the texinfo sources and make a patch to insert @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: @@ -2447,7 +2447,7 @@ Options: PLIST; see below). However, if you have a Japanese (or other multibyte encoding) info files, you will have 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 PLIST of japanese/skk for examples on how to do this). @@ -2459,7 +2459,7 @@ Options: from the texinfo sources. Since the texinfo sources are newer than the info files, they should be rebuilt when you type 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 Makefile.in so it will descend into the man subdirectory to rebuild the info @@ -2583,9 +2583,9 @@ diff -u -r1.26 Makefile Do not use anything other than /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. @@ -2643,7 +2643,7 @@ diff -u -r1.15 PLIST The <filename>pkg/</filename> subdirectory - 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 sometimes. @@ -2847,17 +2847,17 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} If the port has a “do not sell for profit” type of 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 still be available via ftp. 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. @@ -2896,7 +2896,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} port right now (because of, for example, stability problems of the new version). - 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 recursive diff (either unified or context diff is fine, but port committers appear to prefer unified diff more) of the new and old @@ -2969,7 +2969,7 @@ post-install: INSTALL_MAN is a command to install - manpages and other documentation (it doesn't compress + manpages and other documentation (it does not compress anything). @@ -2996,7 +2996,7 @@ post-install: <makevar>WRKDIRPREFIX</makevar> 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 that the correct location is WRKDIRPREFIXPORTSDIR/subdir/name/work not PORTSDIR/subdir/name/work or .CURDIR/../../subdir/name/work or some such. @@ -3031,7 +3031,7 @@ post-install: to the proper place in the .c file. We believe that every system that defines these two symbols has 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;. Another way is to use the GNU Autoconf style of doing @@ -3042,7 +3042,7 @@ post-install: #include <sys/param.h> #endif - 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 this method. @@ -3299,11 +3299,47 @@ post-install: 3.1-STABLE after 3.1-RELEASE 310001 + + + 3.1-STABLE after C++ constructor/destructor order change + 310002 + + + + 3.2-STABLE + 320001 + 4.0-CURRENT after 3/4 branch 400000 + + + 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 + + @@ -3317,7 +3353,7 @@ post-install: to a more straightforward major/minor system starting from 2.2. This is because the parallel development on several branches made 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 reference. @@ -3341,7 +3377,7 @@ post-install: You need to include either the pre.mk/post.mk pair or - bsd.port.mk only; don't mix these two. + bsd.port.mk only; do not mix these two. bsd.port.pre.mk only defines a few @@ -3551,7 +3587,7 @@ post-install: Using the recurse () option to 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 files, Makefiles when the port uses Imake or GNU configure, etc., @@ -3687,7 +3723,7 @@ lib/X11/oneko/sounds/cat.au choose a free UID from 50 to 99 and register it below. Look at japanese/Wnn for an example. - 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 99. @@ -3734,7 +3770,7 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh Respect <makevar>CFLAGS</makevar> 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. @@ -3781,10 +3817,10 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh should each be double-checked. If you are reviewing a port and feel they can be worded better, do so. - 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! @@ -3841,7 +3877,7 @@ DISTNAME= xdvi PKGNAME= xdvi-pl18 CATEGORIES= print [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} MASTER_SITE_SUBDIR= applications [set this if the source is not in the standard ".tar.gz" form] @@ -3907,7 +3943,7 @@ pre-install: The package name should look like language-name-compiled.specifics-version.numbers. - If your DISTNAME doesn't look like that, set + If your DISTNAME does not look like that, set PKGNAME to something in that format. @@ -4169,8 +4205,8 @@ pre-install: devel 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. @@ -4251,7 +4287,7 @@ pre-install: misc 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. If you have misc with something else in your CATEGORIES line, that means you can @@ -4442,7 +4478,7 @@ pre-install: Specific categories win over less-specific ones. For 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 either of mail, mbone, news, security, or diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 25106c50ca..5697de6cc5 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -1,7 +1,7 @@ @@ -117,7 +117,7 @@ “How on earth can this do anything?” I hear you cry. “There is no source code there!” - 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 ElectricFence, a useful tool for developers, as the skeleton is more straightforward than most. @@ -311,8 +311,8 @@ password. Remember to use binary (also known as image) mode!] did not have a copy of the source locally, so it fetched one before extracting, patching and building it. - 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 same:- @@ -762,7 +762,7 @@ do-install: version shipped with FreeBSD 2.1.0 and 2.1.5), the option could result in buggy code unless you 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 used by something like @@ -794,7 +794,7 @@ do-install: Q. I went to install the foo port but the system suddenly stopped compiling it and starting compiling the - bar port. What's going on? + bar port. What is going on? A. The foo port needs something that is supplied with bar — for instance, if @@ -946,7 +946,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc FreeBSD. The bulk of the work is done by /usr/ports/Mk/bsd.port.mk, which all port Makefiles 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 it. @@ -1177,7 +1177,7 @@ lib/X11/oneko/mouse.xpm - 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 deinstall stages, After step 3, check to see if all the new directories are correctly deleted. Also, try @@ -1658,7 +1658,7 @@ MASTER_SITE_SUBDIR= applications .gz or .Z. 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 and the location of the patch tarball to DISTFILES and MASTER_SITES. @@ -1847,7 +1847,7 @@ RUN_DEPENDS= ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ USE_PERL5=yes if your port requires version 5 of the perl language. (The last is especially important since some versions of FreeBSD has perl5 as part of the base system - while others don't.) + while others do not.) @@ -1994,7 +1994,7 @@ lib/libtvl80.so.1 A.out libraries should be moved out of /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 move-aout-libs target in the 3.0-CURRENT src/Makefile (called from @@ -2258,7 +2258,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 MANCOMPRESSED is automatically set to yes if USE_IMAKE is set and 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. If your port anchors its man tree somewhere other than @@ -2313,7 +2313,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz <makevar>REQUIRES_MOTIF</makevar> 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. @@ -2403,7 +2403,7 @@ Options: Look at the texinfo sources and make a patch to insert @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: @@ -2447,7 +2447,7 @@ Options: PLIST; see below). However, if you have a Japanese (or other multibyte encoding) info files, you will have 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 PLIST of japanese/skk for examples on how to do this). @@ -2459,7 +2459,7 @@ Options: from the texinfo sources. Since the texinfo sources are newer than the info files, they should be rebuilt when you type 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 Makefile.in so it will descend into the man subdirectory to rebuild the info @@ -2583,9 +2583,9 @@ diff -u -r1.26 Makefile Do not use anything other than /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. @@ -2643,7 +2643,7 @@ diff -u -r1.15 PLIST The <filename>pkg/</filename> subdirectory - 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 sometimes. @@ -2847,17 +2847,17 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} If the port has a “do not sell for profit” type of 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 still be available via ftp. 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. @@ -2896,7 +2896,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} port right now (because of, for example, stability problems of the new version). - 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 recursive diff (either unified or context diff is fine, but port committers appear to prefer unified diff more) of the new and old @@ -2969,7 +2969,7 @@ post-install: INSTALL_MAN is a command to install - manpages and other documentation (it doesn't compress + manpages and other documentation (it does not compress anything). @@ -2996,7 +2996,7 @@ post-install: <makevar>WRKDIRPREFIX</makevar> 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 that the correct location is WRKDIRPREFIXPORTSDIR/subdir/name/work not PORTSDIR/subdir/name/work or .CURDIR/../../subdir/name/work or some such. @@ -3031,7 +3031,7 @@ post-install: to the proper place in the .c file. We believe that every system that defines these two symbols has 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;. Another way is to use the GNU Autoconf style of doing @@ -3042,7 +3042,7 @@ post-install: #include <sys/param.h> #endif - 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 this method. @@ -3299,11 +3299,47 @@ post-install: 3.1-STABLE after 3.1-RELEASE 310001 + + + 3.1-STABLE after C++ constructor/destructor order change + 310002 + + + + 3.2-STABLE + 320001 + 4.0-CURRENT after 3/4 branch 400000 + + + 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 + + @@ -3317,7 +3353,7 @@ post-install: to a more straightforward major/minor system starting from 2.2. This is because the parallel development on several branches made 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 reference. @@ -3341,7 +3377,7 @@ post-install: You need to include either the pre.mk/post.mk pair or - bsd.port.mk only; don't mix these two. + bsd.port.mk only; do not mix these two. bsd.port.pre.mk only defines a few @@ -3551,7 +3587,7 @@ post-install: Using the recurse () option to 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 files, Makefiles when the port uses Imake or GNU configure, etc., @@ -3687,7 +3723,7 @@ lib/X11/oneko/sounds/cat.au choose a free UID from 50 to 99 and register it below. Look at japanese/Wnn for an example. - 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 99. @@ -3734,7 +3770,7 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh Respect <makevar>CFLAGS</makevar> 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. @@ -3781,10 +3817,10 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh should each be double-checked. If you are reviewing a port and feel they can be worded better, do so. - 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! @@ -3841,7 +3877,7 @@ DISTNAME= xdvi PKGNAME= xdvi-pl18 CATEGORIES= print [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} MASTER_SITE_SUBDIR= applications [set this if the source is not in the standard ".tar.gz" form] @@ -3907,7 +3943,7 @@ pre-install: The package name should look like language-name-compiled.specifics-version.numbers. - If your DISTNAME doesn't look like that, set + If your DISTNAME does not look like that, set PKGNAME to something in that format. @@ -4169,8 +4205,8 @@ pre-install: devel 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. @@ -4251,7 +4287,7 @@ pre-install: misc 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. If you have misc with something else in your CATEGORIES line, that means you can @@ -4442,7 +4478,7 @@ pre-install: Specific categories win over less-specific ones. For 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 either of mail, mbone, news, security, or diff --git a/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml index a3db8259cb..b876be11fd 100644 --- a/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml +++ b/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml @@ -1,7 +1,7 @@ @@ -117,7 +117,7 @@ “How on earth can this do anything?” I hear you cry. “There is no source code there!” - 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 ElectricFence, a useful tool for developers, as the skeleton is more straightforward than most. @@ -311,8 +311,8 @@ password. Remember to use binary (also known as image) mode!] did not have a copy of the source locally, so it fetched one before extracting, patching and building it. - 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 same:- @@ -762,7 +762,7 @@ do-install: version shipped with FreeBSD 2.1.0 and 2.1.5), the option could result in buggy code unless you 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 used by something like @@ -794,7 +794,7 @@ do-install: Q. I went to install the foo port but the system suddenly stopped compiling it and starting compiling the - bar port. What's going on? + bar port. What is going on? A. The foo port needs something that is supplied with bar — for instance, if @@ -946,7 +946,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc FreeBSD. The bulk of the work is done by /usr/ports/Mk/bsd.port.mk, which all port Makefiles 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 it. @@ -1177,7 +1177,7 @@ lib/X11/oneko/mouse.xpm - 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 deinstall stages, After step 3, check to see if all the new directories are correctly deleted. Also, try @@ -1658,7 +1658,7 @@ MASTER_SITE_SUBDIR= applications .gz or .Z. 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 and the location of the patch tarball to DISTFILES and MASTER_SITES. @@ -1847,7 +1847,7 @@ RUN_DEPENDS= ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ USE_PERL5=yes if your port requires version 5 of the perl language. (The last is especially important since some versions of FreeBSD has perl5 as part of the base system - while others don't.) + while others do not.) @@ -1994,7 +1994,7 @@ lib/libtvl80.so.1 A.out libraries should be moved out of /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 move-aout-libs target in the 3.0-CURRENT src/Makefile (called from @@ -2258,7 +2258,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 MANCOMPRESSED is automatically set to yes if USE_IMAKE is set and 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. If your port anchors its man tree somewhere other than @@ -2313,7 +2313,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz <makevar>REQUIRES_MOTIF</makevar> 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. @@ -2403,7 +2403,7 @@ Options: Look at the texinfo sources and make a patch to insert @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: @@ -2447,7 +2447,7 @@ Options: PLIST; see below). However, if you have a Japanese (or other multibyte encoding) info files, you will have 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 PLIST of japanese/skk for examples on how to do this). @@ -2459,7 +2459,7 @@ Options: from the texinfo sources. Since the texinfo sources are newer than the info files, they should be rebuilt when you type 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 Makefile.in so it will descend into the man subdirectory to rebuild the info @@ -2583,9 +2583,9 @@ diff -u -r1.26 Makefile Do not use anything other than /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. @@ -2643,7 +2643,7 @@ diff -u -r1.15 PLIST The <filename>pkg/</filename> subdirectory - 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 sometimes. @@ -2847,17 +2847,17 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} If the port has a “do not sell for profit” type of 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 still be available via ftp. 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. @@ -2896,7 +2896,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} port right now (because of, for example, stability problems of the new version). - 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 recursive diff (either unified or context diff is fine, but port committers appear to prefer unified diff more) of the new and old @@ -2969,7 +2969,7 @@ post-install: INSTALL_MAN is a command to install - manpages and other documentation (it doesn't compress + manpages and other documentation (it does not compress anything). @@ -2996,7 +2996,7 @@ post-install: <makevar>WRKDIRPREFIX</makevar> 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 that the correct location is WRKDIRPREFIXPORTSDIR/subdir/name/work not PORTSDIR/subdir/name/work or .CURDIR/../../subdir/name/work or some such. @@ -3031,7 +3031,7 @@ post-install: to the proper place in the .c file. We believe that every system that defines these two symbols has 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;. Another way is to use the GNU Autoconf style of doing @@ -3042,7 +3042,7 @@ post-install: #include <sys/param.h> #endif - 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 this method. @@ -3299,11 +3299,47 @@ post-install: 3.1-STABLE after 3.1-RELEASE 310001 + + + 3.1-STABLE after C++ constructor/destructor order change + 310002 + + + + 3.2-STABLE + 320001 + 4.0-CURRENT after 3/4 branch 400000 + + + 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 + + @@ -3317,7 +3353,7 @@ post-install: to a more straightforward major/minor system starting from 2.2. This is because the parallel development on several branches made 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 reference. @@ -3341,7 +3377,7 @@ post-install: You need to include either the pre.mk/post.mk pair or - bsd.port.mk only; don't mix these two. + bsd.port.mk only; do not mix these two. bsd.port.pre.mk only defines a few @@ -3551,7 +3587,7 @@ post-install: Using the recurse () option to 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 files, Makefiles when the port uses Imake or GNU configure, etc., @@ -3687,7 +3723,7 @@ lib/X11/oneko/sounds/cat.au choose a free UID from 50 to 99 and register it below. Look at japanese/Wnn for an example. - 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 99. @@ -3734,7 +3770,7 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh Respect <makevar>CFLAGS</makevar> 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. @@ -3781,10 +3817,10 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh should each be double-checked. If you are reviewing a port and feel they can be worded better, do so. - 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! @@ -3841,7 +3877,7 @@ DISTNAME= xdvi PKGNAME= xdvi-pl18 CATEGORIES= print [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} MASTER_SITE_SUBDIR= applications [set this if the source is not in the standard ".tar.gz" form] @@ -3907,7 +3943,7 @@ pre-install: The package name should look like language-name-compiled.specifics-version.numbers. - If your DISTNAME doesn't look like that, set + If your DISTNAME does not look like that, set PKGNAME to something in that format. @@ -4169,8 +4205,8 @@ pre-install: devel 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. @@ -4251,7 +4287,7 @@ pre-install: misc 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. If you have misc with something else in your CATEGORIES line, that means you can @@ -4442,7 +4478,7 @@ pre-install: Specific categories win over less-specific ones. For 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 either of mail, mbone, news, security, or diff --git a/en_US.ISO_8859-1/books/porters-handbook/book.sgml b/en_US.ISO_8859-1/books/porters-handbook/book.sgml index 25106c50ca..5697de6cc5 100644 --- a/en_US.ISO_8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO_8859-1/books/porters-handbook/book.sgml @@ -1,7 +1,7 @@ @@ -117,7 +117,7 @@ “How on earth can this do anything?” I hear you cry. “There is no source code there!” - 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 ElectricFence, a useful tool for developers, as the skeleton is more straightforward than most. @@ -311,8 +311,8 @@ password. Remember to use binary (also known as image) mode!] did not have a copy of the source locally, so it fetched one before extracting, patching and building it. - 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 same:- @@ -762,7 +762,7 @@ do-install: version shipped with FreeBSD 2.1.0 and 2.1.5), the option could result in buggy code unless you 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 used by something like @@ -794,7 +794,7 @@ do-install: Q. I went to install the foo port but the system suddenly stopped compiling it and starting compiling the - bar port. What's going on? + bar port. What is going on? A. The foo port needs something that is supplied with bar — for instance, if @@ -946,7 +946,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc FreeBSD. The bulk of the work is done by /usr/ports/Mk/bsd.port.mk, which all port Makefiles 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 it. @@ -1177,7 +1177,7 @@ lib/X11/oneko/mouse.xpm - 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 deinstall stages, After step 3, check to see if all the new directories are correctly deleted. Also, try @@ -1658,7 +1658,7 @@ MASTER_SITE_SUBDIR= applications .gz or .Z. 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 and the location of the patch tarball to DISTFILES and MASTER_SITES. @@ -1847,7 +1847,7 @@ RUN_DEPENDS= ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ USE_PERL5=yes if your port requires version 5 of the perl language. (The last is especially important since some versions of FreeBSD has perl5 as part of the base system - while others don't.) + while others do not.) @@ -1994,7 +1994,7 @@ lib/libtvl80.so.1 A.out libraries should be moved out of /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 move-aout-libs target in the 3.0-CURRENT src/Makefile (called from @@ -2258,7 +2258,7 @@ MASTERDIR= ${.CURDIR}/../xdvi300 MANCOMPRESSED is automatically set to yes if USE_IMAKE is set and 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. If your port anchors its man tree somewhere other than @@ -2313,7 +2313,7 @@ ${PREFIX}/man/ja/man4/baz.4.gz <makevar>REQUIRES_MOTIF</makevar> 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. @@ -2403,7 +2403,7 @@ Options: Look at the texinfo sources and make a patch to insert @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: @@ -2447,7 +2447,7 @@ Options: PLIST; see below). However, if you have a Japanese (or other multibyte encoding) info files, you will have 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 PLIST of japanese/skk for examples on how to do this). @@ -2459,7 +2459,7 @@ Options: from the texinfo sources. Since the texinfo sources are newer than the info files, they should be rebuilt when you type 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 Makefile.in so it will descend into the man subdirectory to rebuild the info @@ -2583,9 +2583,9 @@ diff -u -r1.26 Makefile Do not use anything other than /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. @@ -2643,7 +2643,7 @@ diff -u -r1.15 PLIST The <filename>pkg/</filename> subdirectory - 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 sometimes. @@ -2847,17 +2847,17 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} If the port has a “do not sell for profit” type of 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 still be available via ftp. 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. @@ -2896,7 +2896,7 @@ PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION} port right now (because of, for example, stability problems of the new version). - 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 recursive diff (either unified or context diff is fine, but port committers appear to prefer unified diff more) of the new and old @@ -2969,7 +2969,7 @@ post-install: INSTALL_MAN is a command to install - manpages and other documentation (it doesn't compress + manpages and other documentation (it does not compress anything). @@ -2996,7 +2996,7 @@ post-install: <makevar>WRKDIRPREFIX</makevar> 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 that the correct location is WRKDIRPREFIXPORTSDIR/subdir/name/work not PORTSDIR/subdir/name/work or .CURDIR/../../subdir/name/work or some such. @@ -3031,7 +3031,7 @@ post-install: to the proper place in the .c file. We believe that every system that defines these two symbols has 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;. Another way is to use the GNU Autoconf style of doing @@ -3042,7 +3042,7 @@ post-install: #include <sys/param.h> #endif - 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 this method. @@ -3299,11 +3299,47 @@ post-install: 3.1-STABLE after 3.1-RELEASE 310001 + + + 3.1-STABLE after C++ constructor/destructor order change + 310002 + + + + 3.2-STABLE + 320001 + 4.0-CURRENT after 3/4 branch 400000 + + + 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 + + @@ -3317,7 +3353,7 @@ post-install: to a more straightforward major/minor system starting from 2.2. This is because the parallel development on several branches made 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 reference. @@ -3341,7 +3377,7 @@ post-install: You need to include either the pre.mk/post.mk pair or - bsd.port.mk only; don't mix these two. + bsd.port.mk only; do not mix these two. bsd.port.pre.mk only defines a few @@ -3551,7 +3587,7 @@ post-install: Using the recurse () option to 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 files, Makefiles when the port uses Imake or GNU configure, etc., @@ -3687,7 +3723,7 @@ lib/X11/oneko/sounds/cat.au choose a free UID from 50 to 99 and register it below. Look at japanese/Wnn for an example. - 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 99. @@ -3734,7 +3770,7 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh Respect <makevar>CFLAGS</makevar> 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. @@ -3781,10 +3817,10 @@ msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh should each be double-checked. If you are reviewing a port and feel they can be worded better, do so. - 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! @@ -3841,7 +3877,7 @@ DISTNAME= xdvi PKGNAME= xdvi-pl18 CATEGORIES= print [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} MASTER_SITE_SUBDIR= applications [set this if the source is not in the standard ".tar.gz" form] @@ -3907,7 +3943,7 @@ pre-install: The package name should look like language-name-compiled.specifics-version.numbers. - If your DISTNAME doesn't look like that, set + If your DISTNAME does not look like that, set PKGNAME to something in that format. @@ -4169,8 +4205,8 @@ pre-install: devel 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. @@ -4251,7 +4287,7 @@ pre-install: misc 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. If you have misc with something else in your CATEGORIES line, that means you can @@ -4442,7 +4478,7 @@ pre-install: Specific categories win over less-specific ones. For 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 either of mail, mbone, news, security, or