diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml index 32787399ed..6dd2d2c9e1 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 @@ @@ -40,7 +40,7 @@ The base FreeBSD system comes with a very wide range of tools and system utilities, but a lot of popular programs are not in the base - system, for good reasons:- + system, for good reasons: @@ -147,7 +147,7 @@ install -c -o root -g wheel -m 444 /usr/ports/devel/ElectricFence/work/ElectricF output. If you tried this yourself, you may well have got something like - this at the start:- + this at the start: &prompt.root; make install >> ElectricFence-2.0.5.tar.gz doesn't seem to exist on this system. @@ -281,7 +281,7 @@ WRKDIRPREFIX= /tmp on-the-fly tarballs for you. Here is how it works, with the gnats program in the databases directory as an example (the bits in square brackets are comments. Do - not type them in if you are trying this yourself!):- + not type them in if you are trying this yourself!): &prompt.root; cd /usr/ports &prompt.root; mkdir databases @@ -314,7 +314,7 @@ password. Remember to use binary (also known as image) mode!] 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:- + same: &prompt.root; cd /usr/ports &prompt.root; ftp ftp.FreeBSD.org @@ -355,7 +355,7 @@ password. Remember to use binary (also known as image) mode!] The most important component of a skeleton is the Makefile. This contains various statements that specify how the port should be compiled and installed. Here is the Makefile for - ElectricFence:- + ElectricFence: # New ports collection makefile for: Electric Fence @@ -446,7 +446,7 @@ do-install: The <filename>pkg</filename> directory - This program contains three quite useful files:- + This program contains three quite useful files: @@ -548,7 +548,7 @@ do-install: - Several reasons:- + Several reasons: @@ -578,7 +578,7 @@ do-install: Some people like having code around, so they can read it if - they get bored, hack around with it, borrow from it (licence + they get bored, hack around with it, borrow from it (license terms permitting, of course!) and so on. @@ -626,7 +626,7 @@ do-install: You can see what files are in them, or even extract them yourself, by using the standard Unix tar program, which comes with - the base FreeBSD system, like this:- + the base FreeBSD system, like this: &prompt.user; tar tvzf foobar.tar.gz &prompt.user; tar xzvf foobar.tar.gz @@ -689,7 +689,7 @@ do-install: /usr/ports/distfiles, but you will not be able to copy anything there because it is sym-linked to the CDROM, which is read-only. You can tell it to look somewhere else by - doing + doing: &prompt.root; make DISTDIR=/where/you/put/it install @@ -769,8 +769,7 @@ do-install: Yes. If you know, for example, ftp.FreeBSD.org is much closer than sites - listed in MASTER_SITES, do as following - example. + listed in MASTER_SITES, do as follows: &prompt.root; cd /usr/ports/directory &prompt.root; make MASTER_SITE_OVERRIDE=ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch @@ -888,11 +887,11 @@ do-install: - No problem, just do + No problem, just do: &prompt.root; pkg_delete grizzle-6.5 - Alternatively, you can do + Alternatively, you can do: &prompt.root; cd /usr/ports/somewhere/grizzle &prompt.root; make deinstall @@ -945,7 +944,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Yes, if you are sure you have finished with them, those can - go as well. + go as well. They can be removed manually, or by using + make distclean. @@ -987,7 +987,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc OK, do this before you go to bed/work/the local - park:- + park: &prompt.root cd /usr/ports &prompt.root; make -DBATCH install @@ -1012,7 +1012,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc No problem, assuming you know how to make patches for your - changes:- + changes: &prompt.root; cd /usr/ports/somewhere/frobble &prompt.root; make extract @@ -1031,8 +1031,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Nothing secret about it at all, just look at the - bsd.ports.mk and - bsd.ports.subdir.mk files in your bsd.port.mk and + bsd.port.subdir.mk files in your makefiles directory. @@ -1063,14 +1063,15 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Additionally, you may send specific questions to &a.ports;. - Only a fraction of the overridable variables - (VAR) are mentioned in - this document. Most (if not all) are documented at the start of - bsd.port.mk. This file users a non-standard tab - setting. Emacs and - Vim should recognise the setting on loading - the file. Both vi and ex can be - set to use the correct value by typing :set tabstop=4 + Only a fraction of the variables + (VAR) that can be + overridden are mentioned in this document. Most (if not all) are + documented at the start of bsd.port.mk. This + file uses a non-standard tab setting. + Emacs and Vim + should recognise the setting on loading the file. Both + vi and ex can be set to use + the correct value by typing :set tabstop=4 once the file has been loaded. @@ -1355,7 +1356,7 @@ lib/X11/oneko/mouse.xpm it in the tree. Your name will also appear in the list of “Additional FreeBSD contributors” on the FreeBSD Handbook and other files. Isn't that great?!? :) + -->:-) @@ -1377,7 +1378,7 @@ lib/X11/oneko/mouse.xpm But do not worry if you do not really understand what bsd.port.mk is doing, not many people do... - :> + :-> @@ -1517,7 +1518,7 @@ lib/X11/oneko/mouse.xpm by putting it on ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/LOCAL_PORTS/ as the last resort. Please refer to this location as - MASTER_SITE_LOCAL. Send mail to the &a.ports;if + MASTER_SITE_LOCAL. Send mail to the &a.ports; if you are not sure what to do. If your port's distfile changes all the time for no good reason, @@ -1705,7 +1706,7 @@ lib/X11/oneko/mouse.xpm linkend="porting-categories">categories section for more discussion about how to pick the right categories. - If you port truly belongs to something that is different from + If your port truly belongs to something that is different from all the existing ones, you can even create a new category name. In that case, please send mail to the &a.ports; to propose a new category. @@ -1802,7 +1803,7 @@ MASTER_SITE_SUBDIR= applications <makevar>MAINTAINER</makevar> Set your mail-address here. Please. :) + -->:-) For detailed description of the responsibility of maintainers, refer to MAINTAINER on @@ -2042,7 +2043,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract install.man target, NO_INSTALL_MANPAGES=yes should be set. In addition, the author of the original port should be shot. :> + smiley -->:-> If your port's source Makefile has something else than all as the main build @@ -2111,7 +2112,7 @@ lib/libtvl80.so.1 Moving a.out libraries out of the way - A.out libraries should be moved out of + Any a.out libraries should be moved out of /usr/local/lib and similar to an aout subdirectory. (If you do not move them out of the way, ELF ports will happily overwrite a.out libraries.) The @@ -2298,7 +2299,7 @@ RESOLUTION?= 300 build the port normally. As for other resolutions, this is the entire - xdvi118/Makefile; + xdvi118/Makefile: RESOLUTION= 118 @@ -2758,7 +2759,7 @@ diff -u -r1.15 PLIST Test and admire your - work. :). Check the + work. :-). Check the dir file before and after each step. @@ -3253,7 +3254,7 @@ post-install: - 2.1-CURRENTs + 2.1-CURRENT 199501, 199503 @@ -3558,7 +3559,7 @@ post-install: bsd.port.mk Do not write anything after the .include - <bsd.port.mk> line. it usually can be avoided by + <bsd.port.mk> line. It usually can be avoided by including bsd.port.pre.mk somewhere in the middle of your Makefile and bsd.port.post.mk at the end. @@ -4023,7 +4024,7 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin Do ask us questions if you have any trouble! Do not just beat your head against a wall! :) + -->:-) @@ -4789,7 +4790,7 @@ pre-install: following us to here, really. Now that you know how to do a port, have at it and convert everything in the world into ports! That is the easiest way to start contributing to the FreeBSD Project! - :) + :-) diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 32787399ed..6dd2d2c9e1 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 @@ @@ -40,7 +40,7 @@ The base FreeBSD system comes with a very wide range of tools and system utilities, but a lot of popular programs are not in the base - system, for good reasons:- + system, for good reasons: @@ -147,7 +147,7 @@ install -c -o root -g wheel -m 444 /usr/ports/devel/ElectricFence/work/ElectricF output. If you tried this yourself, you may well have got something like - this at the start:- + this at the start: &prompt.root; make install >> ElectricFence-2.0.5.tar.gz doesn't seem to exist on this system. @@ -281,7 +281,7 @@ WRKDIRPREFIX= /tmp on-the-fly tarballs for you. Here is how it works, with the gnats program in the databases directory as an example (the bits in square brackets are comments. Do - not type them in if you are trying this yourself!):- + not type them in if you are trying this yourself!): &prompt.root; cd /usr/ports &prompt.root; mkdir databases @@ -314,7 +314,7 @@ password. Remember to use binary (also known as image) mode!] 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:- + same: &prompt.root; cd /usr/ports &prompt.root; ftp ftp.FreeBSD.org @@ -355,7 +355,7 @@ password. Remember to use binary (also known as image) mode!] The most important component of a skeleton is the Makefile. This contains various statements that specify how the port should be compiled and installed. Here is the Makefile for - ElectricFence:- + ElectricFence: # New ports collection makefile for: Electric Fence @@ -446,7 +446,7 @@ do-install: The <filename>pkg</filename> directory - This program contains three quite useful files:- + This program contains three quite useful files: @@ -548,7 +548,7 @@ do-install: - Several reasons:- + Several reasons: @@ -578,7 +578,7 @@ do-install: Some people like having code around, so they can read it if - they get bored, hack around with it, borrow from it (licence + they get bored, hack around with it, borrow from it (license terms permitting, of course!) and so on. @@ -626,7 +626,7 @@ do-install: You can see what files are in them, or even extract them yourself, by using the standard Unix tar program, which comes with - the base FreeBSD system, like this:- + the base FreeBSD system, like this: &prompt.user; tar tvzf foobar.tar.gz &prompt.user; tar xzvf foobar.tar.gz @@ -689,7 +689,7 @@ do-install: /usr/ports/distfiles, but you will not be able to copy anything there because it is sym-linked to the CDROM, which is read-only. You can tell it to look somewhere else by - doing + doing: &prompt.root; make DISTDIR=/where/you/put/it install @@ -769,8 +769,7 @@ do-install: Yes. If you know, for example, ftp.FreeBSD.org is much closer than sites - listed in MASTER_SITES, do as following - example. + listed in MASTER_SITES, do as follows: &prompt.root; cd /usr/ports/directory &prompt.root; make MASTER_SITE_OVERRIDE=ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch @@ -888,11 +887,11 @@ do-install: - No problem, just do + No problem, just do: &prompt.root; pkg_delete grizzle-6.5 - Alternatively, you can do + Alternatively, you can do: &prompt.root; cd /usr/ports/somewhere/grizzle &prompt.root; make deinstall @@ -945,7 +944,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Yes, if you are sure you have finished with them, those can - go as well. + go as well. They can be removed manually, or by using + make distclean. @@ -987,7 +987,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc OK, do this before you go to bed/work/the local - park:- + park: &prompt.root cd /usr/ports &prompt.root; make -DBATCH install @@ -1012,7 +1012,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc No problem, assuming you know how to make patches for your - changes:- + changes: &prompt.root; cd /usr/ports/somewhere/frobble &prompt.root; make extract @@ -1031,8 +1031,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Nothing secret about it at all, just look at the - bsd.ports.mk and - bsd.ports.subdir.mk files in your bsd.port.mk and + bsd.port.subdir.mk files in your makefiles directory. @@ -1063,14 +1063,15 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Additionally, you may send specific questions to &a.ports;. - Only a fraction of the overridable variables - (VAR) are mentioned in - this document. Most (if not all) are documented at the start of - bsd.port.mk. This file users a non-standard tab - setting. Emacs and - Vim should recognise the setting on loading - the file. Both vi and ex can be - set to use the correct value by typing :set tabstop=4 + Only a fraction of the variables + (VAR) that can be + overridden are mentioned in this document. Most (if not all) are + documented at the start of bsd.port.mk. This + file uses a non-standard tab setting. + Emacs and Vim + should recognise the setting on loading the file. Both + vi and ex can be set to use + the correct value by typing :set tabstop=4 once the file has been loaded. @@ -1355,7 +1356,7 @@ lib/X11/oneko/mouse.xpm it in the tree. Your name will also appear in the list of “Additional FreeBSD contributors” on the FreeBSD Handbook and other files. Isn't that great?!? :) + -->:-) @@ -1377,7 +1378,7 @@ lib/X11/oneko/mouse.xpm But do not worry if you do not really understand what bsd.port.mk is doing, not many people do... - :> + :-> @@ -1517,7 +1518,7 @@ lib/X11/oneko/mouse.xpm by putting it on ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/LOCAL_PORTS/ as the last resort. Please refer to this location as - MASTER_SITE_LOCAL. Send mail to the &a.ports;if + MASTER_SITE_LOCAL. Send mail to the &a.ports; if you are not sure what to do. If your port's distfile changes all the time for no good reason, @@ -1705,7 +1706,7 @@ lib/X11/oneko/mouse.xpm linkend="porting-categories">categories section for more discussion about how to pick the right categories. - If you port truly belongs to something that is different from + If your port truly belongs to something that is different from all the existing ones, you can even create a new category name. In that case, please send mail to the &a.ports; to propose a new category. @@ -1802,7 +1803,7 @@ MASTER_SITE_SUBDIR= applications <makevar>MAINTAINER</makevar> Set your mail-address here. Please. :) + -->:-) For detailed description of the responsibility of maintainers, refer to MAINTAINER on @@ -2042,7 +2043,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract install.man target, NO_INSTALL_MANPAGES=yes should be set. In addition, the author of the original port should be shot. :> + smiley -->:-> If your port's source Makefile has something else than all as the main build @@ -2111,7 +2112,7 @@ lib/libtvl80.so.1 Moving a.out libraries out of the way - A.out libraries should be moved out of + Any a.out libraries should be moved out of /usr/local/lib and similar to an aout subdirectory. (If you do not move them out of the way, ELF ports will happily overwrite a.out libraries.) The @@ -2298,7 +2299,7 @@ RESOLUTION?= 300 build the port normally. As for other resolutions, this is the entire - xdvi118/Makefile; + xdvi118/Makefile: RESOLUTION= 118 @@ -2758,7 +2759,7 @@ diff -u -r1.15 PLIST Test and admire your - work. :). Check the + work. :-). Check the dir file before and after each step. @@ -3253,7 +3254,7 @@ post-install: - 2.1-CURRENTs + 2.1-CURRENT 199501, 199503 @@ -3558,7 +3559,7 @@ post-install: bsd.port.mk Do not write anything after the .include - <bsd.port.mk> line. it usually can be avoided by + <bsd.port.mk> line. It usually can be avoided by including bsd.port.pre.mk somewhere in the middle of your Makefile and bsd.port.post.mk at the end. @@ -4023,7 +4024,7 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin Do ask us questions if you have any trouble! Do not just beat your head against a wall! :) + -->:-) @@ -4789,7 +4790,7 @@ pre-install: following us to here, really. Now that you know how to do a port, have at it and convert everything in the world into ports! That is the easiest way to start contributing to the FreeBSD Project! - :) + :-) 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 32787399ed..6dd2d2c9e1 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 @@ @@ -40,7 +40,7 @@ The base FreeBSD system comes with a very wide range of tools and system utilities, but a lot of popular programs are not in the base - system, for good reasons:- + system, for good reasons: @@ -147,7 +147,7 @@ install -c -o root -g wheel -m 444 /usr/ports/devel/ElectricFence/work/ElectricF output. If you tried this yourself, you may well have got something like - this at the start:- + this at the start: &prompt.root; make install >> ElectricFence-2.0.5.tar.gz doesn't seem to exist on this system. @@ -281,7 +281,7 @@ WRKDIRPREFIX= /tmp on-the-fly tarballs for you. Here is how it works, with the gnats program in the databases directory as an example (the bits in square brackets are comments. Do - not type them in if you are trying this yourself!):- + not type them in if you are trying this yourself!): &prompt.root; cd /usr/ports &prompt.root; mkdir databases @@ -314,7 +314,7 @@ password. Remember to use binary (also known as image) mode!] 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:- + same: &prompt.root; cd /usr/ports &prompt.root; ftp ftp.FreeBSD.org @@ -355,7 +355,7 @@ password. Remember to use binary (also known as image) mode!] The most important component of a skeleton is the Makefile. This contains various statements that specify how the port should be compiled and installed. Here is the Makefile for - ElectricFence:- + ElectricFence: # New ports collection makefile for: Electric Fence @@ -446,7 +446,7 @@ do-install: The <filename>pkg</filename> directory - This program contains three quite useful files:- + This program contains three quite useful files: @@ -548,7 +548,7 @@ do-install: - Several reasons:- + Several reasons: @@ -578,7 +578,7 @@ do-install: Some people like having code around, so they can read it if - they get bored, hack around with it, borrow from it (licence + they get bored, hack around with it, borrow from it (license terms permitting, of course!) and so on. @@ -626,7 +626,7 @@ do-install: You can see what files are in them, or even extract them yourself, by using the standard Unix tar program, which comes with - the base FreeBSD system, like this:- + the base FreeBSD system, like this: &prompt.user; tar tvzf foobar.tar.gz &prompt.user; tar xzvf foobar.tar.gz @@ -689,7 +689,7 @@ do-install: /usr/ports/distfiles, but you will not be able to copy anything there because it is sym-linked to the CDROM, which is read-only. You can tell it to look somewhere else by - doing + doing: &prompt.root; make DISTDIR=/where/you/put/it install @@ -769,8 +769,7 @@ do-install: Yes. If you know, for example, ftp.FreeBSD.org is much closer than sites - listed in MASTER_SITES, do as following - example. + listed in MASTER_SITES, do as follows: &prompt.root; cd /usr/ports/directory &prompt.root; make MASTER_SITE_OVERRIDE=ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch @@ -888,11 +887,11 @@ do-install: - No problem, just do + No problem, just do: &prompt.root; pkg_delete grizzle-6.5 - Alternatively, you can do + Alternatively, you can do: &prompt.root; cd /usr/ports/somewhere/grizzle &prompt.root; make deinstall @@ -945,7 +944,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Yes, if you are sure you have finished with them, those can - go as well. + go as well. They can be removed manually, or by using + make distclean. @@ -987,7 +987,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc OK, do this before you go to bed/work/the local - park:- + park: &prompt.root cd /usr/ports &prompt.root; make -DBATCH install @@ -1012,7 +1012,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc No problem, assuming you know how to make patches for your - changes:- + changes: &prompt.root; cd /usr/ports/somewhere/frobble &prompt.root; make extract @@ -1031,8 +1031,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Nothing secret about it at all, just look at the - bsd.ports.mk and - bsd.ports.subdir.mk files in your bsd.port.mk and + bsd.port.subdir.mk files in your makefiles directory. @@ -1063,14 +1063,15 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Additionally, you may send specific questions to &a.ports;. - Only a fraction of the overridable variables - (VAR) are mentioned in - this document. Most (if not all) are documented at the start of - bsd.port.mk. This file users a non-standard tab - setting. Emacs and - Vim should recognise the setting on loading - the file. Both vi and ex can be - set to use the correct value by typing :set tabstop=4 + Only a fraction of the variables + (VAR) that can be + overridden are mentioned in this document. Most (if not all) are + documented at the start of bsd.port.mk. This + file uses a non-standard tab setting. + Emacs and Vim + should recognise the setting on loading the file. Both + vi and ex can be set to use + the correct value by typing :set tabstop=4 once the file has been loaded. @@ -1355,7 +1356,7 @@ lib/X11/oneko/mouse.xpm it in the tree. Your name will also appear in the list of “Additional FreeBSD contributors” on the FreeBSD Handbook and other files. Isn't that great?!? :) + -->:-) @@ -1377,7 +1378,7 @@ lib/X11/oneko/mouse.xpm But do not worry if you do not really understand what bsd.port.mk is doing, not many people do... - :> + :-> @@ -1517,7 +1518,7 @@ lib/X11/oneko/mouse.xpm by putting it on ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/LOCAL_PORTS/ as the last resort. Please refer to this location as - MASTER_SITE_LOCAL. Send mail to the &a.ports;if + MASTER_SITE_LOCAL. Send mail to the &a.ports; if you are not sure what to do. If your port's distfile changes all the time for no good reason, @@ -1705,7 +1706,7 @@ lib/X11/oneko/mouse.xpm linkend="porting-categories">categories section for more discussion about how to pick the right categories. - If you port truly belongs to something that is different from + If your port truly belongs to something that is different from all the existing ones, you can even create a new category name. In that case, please send mail to the &a.ports; to propose a new category. @@ -1802,7 +1803,7 @@ MASTER_SITE_SUBDIR= applications <makevar>MAINTAINER</makevar> Set your mail-address here. Please. :) + -->:-) For detailed description of the responsibility of maintainers, refer to MAINTAINER on @@ -2042,7 +2043,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract install.man target, NO_INSTALL_MANPAGES=yes should be set. In addition, the author of the original port should be shot. :> + smiley -->:-> If your port's source Makefile has something else than all as the main build @@ -2111,7 +2112,7 @@ lib/libtvl80.so.1 Moving a.out libraries out of the way - A.out libraries should be moved out of + Any a.out libraries should be moved out of /usr/local/lib and similar to an aout subdirectory. (If you do not move them out of the way, ELF ports will happily overwrite a.out libraries.) The @@ -2298,7 +2299,7 @@ RESOLUTION?= 300 build the port normally. As for other resolutions, this is the entire - xdvi118/Makefile; + xdvi118/Makefile: RESOLUTION= 118 @@ -2758,7 +2759,7 @@ diff -u -r1.15 PLIST Test and admire your - work. :). Check the + work. :-). Check the dir file before and after each step. @@ -3253,7 +3254,7 @@ post-install: - 2.1-CURRENTs + 2.1-CURRENT 199501, 199503 @@ -3558,7 +3559,7 @@ post-install: bsd.port.mk Do not write anything after the .include - <bsd.port.mk> line. it usually can be avoided by + <bsd.port.mk> line. It usually can be avoided by including bsd.port.pre.mk somewhere in the middle of your Makefile and bsd.port.post.mk at the end. @@ -4023,7 +4024,7 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin Do ask us questions if you have any trouble! Do not just beat your head against a wall! :) + -->:-) @@ -4789,7 +4790,7 @@ pre-install: following us to here, really. Now that you know how to do a port, have at it and convert everything in the world into ports! That is the easiest way to start contributing to the FreeBSD Project! - :) + :-) 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 32787399ed..6dd2d2c9e1 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 @@ @@ -40,7 +40,7 @@ The base FreeBSD system comes with a very wide range of tools and system utilities, but a lot of popular programs are not in the base - system, for good reasons:- + system, for good reasons: @@ -147,7 +147,7 @@ install -c -o root -g wheel -m 444 /usr/ports/devel/ElectricFence/work/ElectricF output. If you tried this yourself, you may well have got something like - this at the start:- + this at the start: &prompt.root; make install >> ElectricFence-2.0.5.tar.gz doesn't seem to exist on this system. @@ -281,7 +281,7 @@ WRKDIRPREFIX= /tmp on-the-fly tarballs for you. Here is how it works, with the gnats program in the databases directory as an example (the bits in square brackets are comments. Do - not type them in if you are trying this yourself!):- + not type them in if you are trying this yourself!): &prompt.root; cd /usr/ports &prompt.root; mkdir databases @@ -314,7 +314,7 @@ password. Remember to use binary (also known as image) mode!] 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:- + same: &prompt.root; cd /usr/ports &prompt.root; ftp ftp.FreeBSD.org @@ -355,7 +355,7 @@ password. Remember to use binary (also known as image) mode!] The most important component of a skeleton is the Makefile. This contains various statements that specify how the port should be compiled and installed. Here is the Makefile for - ElectricFence:- + ElectricFence: # New ports collection makefile for: Electric Fence @@ -446,7 +446,7 @@ do-install: The <filename>pkg</filename> directory - This program contains three quite useful files:- + This program contains three quite useful files: @@ -548,7 +548,7 @@ do-install: - Several reasons:- + Several reasons: @@ -578,7 +578,7 @@ do-install: Some people like having code around, so they can read it if - they get bored, hack around with it, borrow from it (licence + they get bored, hack around with it, borrow from it (license terms permitting, of course!) and so on. @@ -626,7 +626,7 @@ do-install: You can see what files are in them, or even extract them yourself, by using the standard Unix tar program, which comes with - the base FreeBSD system, like this:- + the base FreeBSD system, like this: &prompt.user; tar tvzf foobar.tar.gz &prompt.user; tar xzvf foobar.tar.gz @@ -689,7 +689,7 @@ do-install: /usr/ports/distfiles, but you will not be able to copy anything there because it is sym-linked to the CDROM, which is read-only. You can tell it to look somewhere else by - doing + doing: &prompt.root; make DISTDIR=/where/you/put/it install @@ -769,8 +769,7 @@ do-install: Yes. If you know, for example, ftp.FreeBSD.org is much closer than sites - listed in MASTER_SITES, do as following - example. + listed in MASTER_SITES, do as follows: &prompt.root; cd /usr/ports/directory &prompt.root; make MASTER_SITE_OVERRIDE=ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch @@ -888,11 +887,11 @@ do-install: - No problem, just do + No problem, just do: &prompt.root; pkg_delete grizzle-6.5 - Alternatively, you can do + Alternatively, you can do: &prompt.root; cd /usr/ports/somewhere/grizzle &prompt.root; make deinstall @@ -945,7 +944,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Yes, if you are sure you have finished with them, those can - go as well. + go as well. They can be removed manually, or by using + make distclean. @@ -987,7 +987,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc OK, do this before you go to bed/work/the local - park:- + park: &prompt.root cd /usr/ports &prompt.root; make -DBATCH install @@ -1012,7 +1012,7 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc No problem, assuming you know how to make patches for your - changes:- + changes: &prompt.root; cd /usr/ports/somewhere/frobble &prompt.root; make extract @@ -1031,8 +1031,8 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Nothing secret about it at all, just look at the - bsd.ports.mk and - bsd.ports.subdir.mk files in your bsd.port.mk and + bsd.port.subdir.mk files in your makefiles directory. @@ -1063,14 +1063,15 @@ grizzle-6.5 - the combined piano tutorial, LOGO interpreter and shoot 'em up arc Additionally, you may send specific questions to &a.ports;. - Only a fraction of the overridable variables - (VAR) are mentioned in - this document. Most (if not all) are documented at the start of - bsd.port.mk. This file users a non-standard tab - setting. Emacs and - Vim should recognise the setting on loading - the file. Both vi and ex can be - set to use the correct value by typing :set tabstop=4 + Only a fraction of the variables + (VAR) that can be + overridden are mentioned in this document. Most (if not all) are + documented at the start of bsd.port.mk. This + file uses a non-standard tab setting. + Emacs and Vim + should recognise the setting on loading the file. Both + vi and ex can be set to use + the correct value by typing :set tabstop=4 once the file has been loaded. @@ -1355,7 +1356,7 @@ lib/X11/oneko/mouse.xpm it in the tree. Your name will also appear in the list of “Additional FreeBSD contributors” on the FreeBSD Handbook and other files. Isn't that great?!? :) + -->:-) @@ -1377,7 +1378,7 @@ lib/X11/oneko/mouse.xpm But do not worry if you do not really understand what bsd.port.mk is doing, not many people do... - :> + :-> @@ -1517,7 +1518,7 @@ lib/X11/oneko/mouse.xpm by putting it on ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/LOCAL_PORTS/ as the last resort. Please refer to this location as - MASTER_SITE_LOCAL. Send mail to the &a.ports;if + MASTER_SITE_LOCAL. Send mail to the &a.ports; if you are not sure what to do. If your port's distfile changes all the time for no good reason, @@ -1705,7 +1706,7 @@ lib/X11/oneko/mouse.xpm linkend="porting-categories">categories section for more discussion about how to pick the right categories. - If you port truly belongs to something that is different from + If your port truly belongs to something that is different from all the existing ones, you can even create a new category name. In that case, please send mail to the &a.ports; to propose a new category. @@ -1802,7 +1803,7 @@ MASTER_SITE_SUBDIR= applications <makevar>MAINTAINER</makevar> Set your mail-address here. Please. :) + -->:-) For detailed description of the responsibility of maintainers, refer to MAINTAINER on @@ -2042,7 +2043,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract install.man target, NO_INSTALL_MANPAGES=yes should be set. In addition, the author of the original port should be shot. :> + smiley -->:-> If your port's source Makefile has something else than all as the main build @@ -2111,7 +2112,7 @@ lib/libtvl80.so.1 Moving a.out libraries out of the way - A.out libraries should be moved out of + Any a.out libraries should be moved out of /usr/local/lib and similar to an aout subdirectory. (If you do not move them out of the way, ELF ports will happily overwrite a.out libraries.) The @@ -2298,7 +2299,7 @@ RESOLUTION?= 300 build the port normally. As for other resolutions, this is the entire - xdvi118/Makefile; + xdvi118/Makefile: RESOLUTION= 118 @@ -2758,7 +2759,7 @@ diff -u -r1.15 PLIST Test and admire your - work. :). Check the + work. :-). Check the dir file before and after each step. @@ -3253,7 +3254,7 @@ post-install: - 2.1-CURRENTs + 2.1-CURRENT 199501, 199503 @@ -3558,7 +3559,7 @@ post-install: bsd.port.mk Do not write anything after the .include - <bsd.port.mk> line. it usually can be avoided by + <bsd.port.mk> line. It usually can be avoided by including bsd.port.pre.mk somewhere in the middle of your Makefile and bsd.port.post.mk at the end. @@ -4023,7 +4024,7 @@ mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin Do ask us questions if you have any trouble! Do not just beat your head against a wall! :) + -->:-) @@ -4789,7 +4790,7 @@ pre-install: following us to here, really. Now that you know how to do a port, have at it and convert everything in the world into ports! That is the easiest way to start contributing to the FreeBSD Project! - :) + :-)