svn commit: r46893 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

Mathieu Arnold <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]> 
Author: mat
Date: Mon Jun 29 15:17:22 2015
New Revision: 46893
URL: https://svnweb.freebsd.org/changeset/doc/46893

Log:
  Catch up with newly created macros.
  
  Approved by:	wblock (mentor)
  Sponsored by:	Absolight
  Differential Revision:	https://reviews.freebsd.org/D2539

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	Mon Jun 29 15:16:38 2015	(r46892)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Mon Jun 29 15:17:22 2015	(r46893)
@@ -1654,15 +1654,16 @@ PORTEPOCH=	1</programlisting>
 	  Variables</title>
 
 	<para>Shortcut abbreviations are available for popular
-	  archives like SourceForge (<literal>SF</literal>), GNU
-	  (<literal>GNU</literal>), or Perl CPAN
-	  (<literal>CPAN</literal>).  <varname>MASTER_SITES</varname>
-	  can use them directly:</para>
+	  archives like SourceForge (<literal>SOURCEFORGE</literal>),
+	  GNU (<literal>GNU</literal>), or Perl CPAN
+	  (<literal>PERL_CPAN</literal>).
+	  <varname>MASTER_SITES</varname> can use them
+	  directly:</para>
 
 	<programlisting>MASTER_SITES=	GNU/make</programlisting>
 
 	<para>The older expanded format still works, but all ports
-	  should be converted to the compact format.  The expanded
+	  have been converted to the compact format.  The expanded
 	  format looks like this:</para>
 
 	<programlisting>MASTER_SITES=		${MASTER_SITE_GNU}
@@ -1687,24 +1688,89 @@ MASTER_SITE_SUBDIR=	make</programlisting
 
 	  <programlisting>MASTER_SITES=	<replaceable>FOO</replaceable>/<replaceable>bar</replaceable></programlisting>
 	</tip>
+
+	<note>
+	  <para>Some
+	    <varname>MASTER_SITE_<replaceable>*</replaceable></varname>
+	    names are quite long, and for ease of use, shortcuts have
+	    been defined:</para>
+
+	  <table frame="none" xml:id="makefile-master_sites-shortcut">
+	    <title>Shortcuts for
+	      <varname>MASTER_SITE_<replaceable>*</replaceable></varname>
+	      Macros</title>
+
+	    <tgroup cols="2">
+	      <thead>
+		<row>
+		  <entry>Macro</entry>
+		  <entry>Shortcut</entry>
+		</row>
+	      </thead>
+
+	      <tbody>
+		<row>
+		  <entry><varname>PERL_CPAN</varname></entry>
+		  <entry><varname>CPAN</varname></entry>
+		</row>
+
+		<row>
+		  <entry><varname>GITHUB</varname></entry>
+		  <entry><varname>GH</varname></entry>
+		</row>
+
+		<row>
+		  <entry><varname>GITHUB_CLOUD</varname></entry>
+		  <entry><varname>GHC</varname></entry>
+		</row>
+
+		<row>
+		  <entry><varname>LIBREOFFICE_DEV</varname></entry>
+		  <entry><varname>LODEV</varname></entry>
+		</row>
+
+		<row>
+		  <entry><varname>NETLIB</varname></entry>
+		  <entry><varname>NL</varname></entry>
+		</row>
+
+		<row>
+		  <entry><varname>RUBYGEMS</varname></entry>
+		  <entry><varname>RG</varname></entry>
+		</row>
+
+		<row>
+		  <entry><varname>SOURCEFORGE</varname></entry>
+		  <entry><varname>SF</varname></entry>
+		</row>
+
+		<row>
+		  <entry><varname>SOURCEFORGE_JP</varname></entry>
+		  <entry><varname>SFJP</varname></entry>
+		</row>
+	      </tbody>
+	    </tgroup>
+	  </table>
+	</note>
       </sect3>
 
       <sect3 xml:id="makefile-master_sites-magic">
 	<title>Magic MASTER_SITES Macros</title>
 
-	<para>Several <emphasis>magic</emphasis> macros exist for
+	<para>Several <quote>magic</quote> 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.  For a port
+	  these, just use the abbreviation and the system will choose
+	  a subdirectory automatically.  For a port
 	  named <literal>Stardict</literal>, of version
 	  <literal>1.2.3</literal>, and hosted on SourceForge, adding
 	  this line:</para>
 
 	<programlisting>MASTER_SITES=	SF</programlisting>
 
-	<para>Will infer a subdirectory named
+	<para>infers a subdirectory named
 	  <literal>/project/stardict/stardict/1.2.3</literal>.  If the
-	  guess is incorrect, it can be overridden as follows.</para>
+	  inferred directory is incorrect, it can be
+	  overridden:</para>
 
 	<programlisting>MASTER_SITES=	SF/stardict/WyabdcRealPeopleTTS/${PORTVERSION}</programlisting>
 
@@ -1714,7 +1780,7 @@ MASTER_SITE_SUBDIR=	make</programlisting
 MASTER_SITE_SUBDIR=	stardict/WyabdcRealPeopleTTS/${PORTVERSION}</programlisting>
 
 	<table frame="none" xml:id="makefile-master_sites-popular">
-	  <title>Popular Magic <varname>MASTER_SITES</varname>
+	  <title>Magic <varname>MASTER_SITES</varname>
 	    Macros</title>
 
 	  <tgroup cols="2">
@@ -1752,6 +1818,11 @@ MASTER_SITE_SUBDIR=	stardict/WyabdcRealP
 	      </row>
 
 	      <row>
+		<entry><varname>CPAN</varname></entry>
+		<entry><literal>${PORTNAME:C/-.*//}</literal></entry>
+	      </row>
+
+	      <row>
 		<entry><varname>DEBIAN</varname></entry>
 		<entry><literal>pool/main/${PORTNAME:C/^((lib)?.).*$/\1/}/${PORTNAME}</literal></entry>
 	      </row>
@@ -1762,11 +1833,26 @@ MASTER_SITE_SUBDIR=	stardict/WyabdcRealP
 	      </row>
 
 	      <row>
+		<entry><varname>FESTIVAL</varname></entry>
+		<entry><literal>${PORTREVISION}</literal></entry>
+	      </row>
+
+	      <row>
 		<entry><varname>GCC</varname></entry>
 		<entry><literal>releases/${DISTNAME}</literal></entry>
 	      </row>
 
 	      <row>
+		<entry><varname>GENTOO</varname></entry>
+		<entry><literal>distfiles</literal></entry>
+	      </row>
+
+	      <row>
+		<entry><varname>GIMP</varname></entry>
+		<entry><literal>${PORTNAME}/${PORTVERSION:R}/</literal></entry>
+	      </row>
+
+	      <row>
 		<entry><varname>GH</varname></entry>
 		<entry><literal>${GH_ACCOUNT}/${GH_PROJECT}/tar.gz/${GH_TAGNAME}?dummy=/</literal></entry>
 	      </row>
@@ -1777,22 +1863,17 @@ MASTER_SITE_SUBDIR=	stardict/WyabdcRealP
 	      </row>
 
 	      <row>
-		<entry><varname>GHL</varname></entry>
-		<entry><literal>${GH_ACCOUNT}/${GH_PROJECT}/legacy.tar.gz/${GH_TAGNAME}?dummy=/</literal></entry>
-	      </row>
-
-	      <row>
 		<entry><varname>GNOME</varname></entry>
 		<entry><literal>sources/${PORTNAME}/${PORTVERSION:C/^([0-9]+\.[0-9]+).*/\1/}</literal></entry>
 	      </row>
 
 	      <row>
-		<entry><varname>GIMP</varname></entry>
-		<entry><literal>${PORTNAME}/${PORTVERSION:R}/</literal></entry>
+		<entry><varname>GNU</varname></entry>
+		<entry><literal>${PORTNAME}</literal></entry>
 	      </row>
 
 	      <row>
-		<entry><varname>GNU</varname></entry>
+		<entry><varname>GNUPG</varname></entry>
 		<entry><literal>${PORTNAME}</literal></entry>
 	      </row>
 
@@ -1827,8 +1908,13 @@ MASTER_SITE_SUBDIR=	stardict/WyabdcRealP
 	      </row>
 
 	      <row>
-		<entry><varname>CPAN</varname></entry>
-		<entry><literal>${PORTNAME:C/-.*//}</literal></entry>
+		<entry><varname>QT</varname></entry>
+		<entry><literal>archive/qt/${PORTVERSION:R}</literal></entry>
+	      </row>
+
+	      <row>
+		<entry><varname>SAMBA</varname></entry>
+		<entry><literal>${PORTNAME}</literal></entry>
 	      </row>
 
 	      <row>
_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "[email protected]"
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.