Index: en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
@@ -1643,12 +1643,17 @@
set.
+
+ Using
+ <varname>MASTER_SITE_<replaceable>*</replaceable></varname>
+ variables
+
If the original tarball is part of one of the popular
- archives such as SourceForge, GNU, or Perl CPAN, it may be
- possible refer to those sites in an easy compact form using
- predefined macros (for example, SF,
- GNU or CPAN).
- Set MASTER_SITES to one of these values.
+ archives such as SourceForge, GNU, or Perl CPAN, it might be
+ possible to refer to those sites in an easy compact form.
+ MASTER_SITES can be set to numerous predefined macros such as
+ SF, GNU, or
+ CPAN.
Here is an example:
MASTER_SITES= GNU/make
@@ -1664,15 +1669,47 @@
new entries added all the time, so make sure to check the
latest version of this file before submitting a port.
+
+ For any
+ MASTER_SITE_FOO
+ variable, the shorthand
+ FOO can be
+ used. For example:
+
+ MASTER_SITES= ${MASTER_SITE_FOO}
+
+ Is better written as:
+
+ MASTER_SITES= FOO
+
+ If MASTER_SITE_SUBDIR needs to be
+ used, this:
+
+ MASTER_SITES= ${MASTER_SITE_FOO}
+MASTER_SITE_SUBDIR= bar
+
+ Is better written as:
+
+ MASTER_SITES= FOO/bar
+
+
+
+
+ Magic MASTER_SITES Macros
+
Several magic macros exist for
popular sites with a predictable directory structure. For
these, just use the abbreviation and the system will try to
- guess the correct subdirectory automatically.
+ guess the correct subdirectory automatically. For a port
+ named Stardict, of version
+ 1.2.3, and hosted on SourceForge, adding
+ this line:
MASTER_SITES= SF
- If the guess is incorrect, it can be overridden as
- follows.
+ Will infer a subdirectory named
+ /project/stardict/stardict/1.2.3. If the
+ guess is incorrect, it can be overridden as follows.
MASTER_SITES= SF/stardict/WyabdcRealPeopleTTS/${PORTVERSION}
@@ -1696,96 +1733,137 @@
APACHE_JAKARTA
- /dist/jakarta/${PORTNAME:S,-,,/,}/source
+ ${PORTNAME:S,-,/,}/source
BERLIOS
- /${PORTNAME:L}
+ ${PORTNAME:tl}.berlios
+
+
+
+ CENKES
+ myports
CHEESESHOP
- /packages/source/source/${DISTNAME:C/(.).*/\1/}/${DISTNAME:C/(.*)-[0-9].*/\1/}
+ source/${DISTNAME:C/(.).*/\1/}/${DISTNAME:C/(.*)-[0-9].*/\1/}
+
+
+
+ CSME
+ myports
DEBIAN
- /debian/pool/main/${PORTNAME:C/^((lib)?.).*$/\1/}/${PORTNAME}
+ pool/main/${PORTNAME:C/^((lib)?.).*$/\1/}/${PORTNAME}
GCC
- /pub/gcc/releases/${DISTNAME}
+ releases/${DISTNAME}
GH
- /${GH_ACCOUNT}/${GH_PROJECT}/tar.gz/${GH_TAGNAME}
+ ${GH_ACCOUNT}/${GH_PROJECT}/tar.gz/${GH_TAGNAME}?dummy=/
GHC
- /downloads/${GH_ACCOUNT}/${GH_PROJECT}/
+ ${GH_ACCOUNT}/${GH_PROJECT}/
+
+
+
+ GHL
+ ${GH_ACCOUNT}/${GH_PROJECT}/legacy.tar.gz/${GH_TAGNAME}?dummy=/
GNOME
- /pub/GNOME/sources/${PORTNAME}/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/}
+ sources/${PORTNAME}/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/}
+
+
+
+ GIMP
+ ${PORTNAME}/${PORTVERSION:R}/
GNU
- /gnu/${PORTNAME}
+ ${PORTNAME}
+
+
+
+ GNU_ALPHA
+ ${PORTNAME}
HORDE
- /pub/${PORTNAME}
+ ${PORTNAME}
LOGILAB
- /pub/${PORTNAME}
+ ${PORTNAME}
+
+
+
+ LODEV
+ ${PORTNAME}
MATE
- /releases/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/}
+ ${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/}
MOZDEV
- /pub/mozdev/${PORTNAME:L}
+ ${PORTNAME:tl}
+
+
+
+ NL
+ ${PORTNAME}
CPAN
- /pub/CPAN/modules/by-module/${PORTNAME:C/-.*//}
+ ${PORTNAME:C/-.*//}
- PYTHON
- /ftp/python/${PYTHON_PORTVERSION:C/rc[0-9]//}
+ PNET
+ ${PNET_MASTER_SITE_SUBDIR}
- RUBYFORGE
- /${PORTNAME:L}
+ RUBY_DBI
+ ${RUBY_DBI_MASTER_SITE_SUBDIR}
+
+
+
+ RUBY_GNOME
+ ${RUBY_GNOME_MASTER_SITE_SUBDIR}
SAVANNAH
- /${PORTNAME:L}
+ ${PORTNAME:tl}
SF
- /project/${PORTNAME:L}/${PORTNAME:L}/${PORTVERSION}
+ ${PORTNAME:tl}/${PORTNAME:tl}/${PORTVERSION}
+
<varname>USE_GITHUB</varname>