From owner-svn-doc-head@FreeBSD.ORG Fri Apr 3 11:38:45 2015 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id DBB0120A; Fri, 3 Apr 2015 11:38:44 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id C64E9C75; Fri, 3 Apr 2015 11:38:44 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t33BcilB007545; Fri, 3 Apr 2015 11:38:44 GMT (envelope-from mat@FreeBSD.org) Received: (from mat@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t33Bcikw007543; Fri, 3 Apr 2015 11:38:44 GMT (envelope-from mat@FreeBSD.org) Message-Id: <201504031138.t33Bcikw007543@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: mat set sender to mat@FreeBSD.org using -f From: Mathieu Arnold Date: Fri, 3 Apr 2015 11:38:44 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46445 - head/en_US.ISO8859-1/books/porters-handbook/makefiles X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 03 Apr 2015 11:38:45 -0000 Author: mat Date: Fri Apr 3 11:38:43 2015 New Revision: 46445 URL: https://svnweb.freebsd.org/changeset/doc/46445 Log: Improve and update MASTER_SITES section. Differential Revision: https://reviews.freebsd.org/D2134 Approved by: wblock (mentor) Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Fri Apr 3 05:11:59 2015 (r46444) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Fri Apr 3 11:38:43 2015 (r46445) @@ -1643,36 +1643,63 @@ PORTEPOCH= 1 set. - 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. - Here is an example: + + Using + <varname>MASTER_SITE_<replaceable>*</replaceable></varname> + Variables + + Shortcut abbreviations are available for popular archives + like SourceForge (SF), GNU + (GNU), or Perl CPAN + (CPAN). MASTER_SITES can + use them directly: MASTER_SITES= GNU/make - The older expanded format can still be used, although there - really is no reason to do so: + The older expanded format still works, but all ports + should be converted to the compact format. The expanded + format looks like this: MASTER_SITES= ${MASTER_SITE_GNU} MASTER_SITE_SUBDIR= make - These values and variables are defined in - /usr/ports/Mk/bsd.sites.mk. There are - new entries added all the time, so make sure to check the - latest version of this file before submitting a port. + These values and variables are defined in Mk/bsd.sites.mk. + New entries are added often, 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, use: + + MASTER_SITES= FOO + + If MASTER_SITE_SUBDIR is needed, use + this: + + 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 +1723,112 @@ MASTER_SITE_SUBDIR= stardict/WyabdcRealP APACHE_JAKARTA - /dist/jakarta/${PORTNAME:S,-,,/,}/source + ${PORTNAME:S,-,/,}/source BERLIOS - /${PORTNAME:L} + ${PORTNAME:tl}.berlios CHEESESHOP - /packages/source/source/${DISTNAME:C/(.).*/\1/}/${DISTNAME:C/(.*)-[0-9].*/\1/} + source/${DISTNAME:C/(.).*/\1/}/${DISTNAME:C/(.*)-[0-9].*/\1/} DEBIAN - /debian/pool/main/${PORTNAME:C/^((lib)?.).*$/\1/}/${PORTNAME} + pool/main/${PORTNAME:C/^((lib)?.).*$/\1/}/${PORTNAME} + + + + FARSIGHT + ${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} - HORDE - /pub/${PORTNAME} + GNU_ALPHA + ${PORTNAME} - LOGILAB - /pub/${PORTNAME} + HORDE + ${PORTNAME} - MATE - /releases/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/} + LODEV + ${PORTNAME} - MOZDEV - /pub/mozdev/${PORTNAME:L} + MATE + ${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/} - CPAN - /pub/CPAN/modules/by-module/${PORTNAME:C/-.*//} + MOZDEV + ${PORTNAME:tl} - PYTHON - /ftp/python/${PYTHON_PORTVERSION:C/rc[0-9]//} + NL + ${PORTNAME} - RUBYFORGE - /${PORTNAME:L} + CPAN + ${PORTNAME:C/-.*//} SAVANNAH - /${PORTNAME:L} + ${PORTNAME:tl} SF - /project/${PORTNAME:L}/${PORTNAME:L}/${PORTVERSION} + ${PORTNAME:tl}/${PORTNAME:tl}/${PORTVERSION} + <varname>USE_GITHUB</varname>