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

[Mathieu Arnold]

Author: mat (ports committer)
Date: Wed Mar 12 10:12:42 2014
New Revision: 44219
URL: http://svnweb.freebsd.org/changeset/doc/44219

Log:
  Document the two new tar and lha uses.
  
  Sponsored by:	Absolight

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
  head/en_US.ISO8859-1/books/porters-handbook/uses.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Wed Mar 12 09:39:23 2014	(r44218)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Wed Mar 12 10:12:42 2014	(r44219)
@@ -1742,18 +1742,19 @@ MASTER_SITE_SUBDIR=	stardict/WyabdcRealP
 	<varname>EXTRACT_SUFX</varname>.</para>
 
       <para>For example, if the distribution file was named
-	<filename>foo.tgz</filename> instead of the more normal
+	<filename>foo.tar.gzip</filename> instead of the more normal
 	<filename>foo.tar.gz</filename>, you would write:</para>
 
       <programlisting>DISTNAME=	foo
-EXTRACT_SUFX=	.tgz</programlisting>
+EXTRACT_SUFX=	.tar.gzip</programlisting>
 
-      <para>The <varname>USE_BZIP2</varname>,
-	<varname>USE_XZ</varname> and <varname>USE_ZIP</varname>
-	variables automatically set <varname>EXTRACT_SUFX</varname> to
-	<literal>.tar.bz2</literal>, <literal>.tar.xz</literal> or
-	<literal>.zip</literal> as necessary.  If neither of these are
-	set then <varname>EXTRACT_SUFX</varname> defaults to
+      <para>The
+	<literal>USES=tar[:<replaceable>xxx</replaceable>]</literal>,
+	<literal>USES=lha</literal> or <literal>USES=zip</literal>
+	automatically set <varname>EXTRACT_SUFX</varname> to the most
+	common archives extensions as necessary, see <xref
+	  linkend="uses-values"/> for more details.  If neither of
+	these are set then <varname>EXTRACT_SUFX</varname> defaults to
 	<literal>.tar.gz</literal>.</para>
 
       <note>
@@ -2891,10 +2892,11 @@ ALWAYS_KEEP_DISTFILES=	yes
 
       <note>
 	<para>Use this variable only if the extraction does not
-	  already work (the default assumes <command>gzip</command>)
-	  and cannot be made to work using <varname>USE_ZIP</varname>
-	  or <varname>USE_BZIP2</varname> described in
-	  <xref linkend="use-vars"/>.</para>
+	  already work (the default assumes <command>tar</command>)
+	  and cannot be made to work using
+	  <literal>USES=tar</literal>, <literal>USES=lha</literal> or
+	  <literal>USES=zip</literal> described in <xref
+	    linkend="uses-values"/>.</para>
       </note>
     </sect2>
 
@@ -2977,18 +2979,6 @@ ALWAYS_KEEP_DISTFILES=	yes
 
 	  <tbody>
 	    <row>
-	      <entry><varname>USE_BZIP2</varname></entry>
-	      <entry>The port's tarballs are compressed with
-		<command>bzip2</command>.</entry>
-	    </row>
-
-	    <row>
-	      <entry><varname>USE_ZIP</varname></entry>
-	      <entry>The port's tarballs are compressed with
-		<command>zip</command>.</entry>
-	    </row>
-
-	    <row>
 	      <entry><varname>USE_GCC</varname></entry>
 	      <entry>The port requires GCC (<command>gcc</command> or
 		<command>g++</command>) to build.  Some ports need any

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Wed Mar 12 09:39:23 2014	(r44218)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Wed Mar 12 10:12:42 2014	(r44219)
@@ -343,6 +343,13 @@
     </itemizedlist></entry>
 </row>
 
+<row xml:id="uses-lha">
+  <entry><literal>lha</literal></entry>
+  <entry>(none)</entry>
+  <entry>Set <varname>EXTRACT_SUFX</varname> to
+    <literal>.lzh</literal></entry>
+</row>
+
 <row xml:id="uses-libtool">
   <entry><literal>libtool</literal></entry>
 
@@ -605,6 +612,16 @@
     <varname>lua_CMD</varname>.</entry>
 </row>
 
+<row xml:id="uses-tar">
+  <entry><literal>tar</literal></entry>
+  <entry>(none), <literal>bzip2</literal>, <literal>xz</literal>,
+    <literal>Z</literal>, <literal>tgz</literal></entry>
+  <entry>Set <varname>EXTRACT_SUFX</varname> to
+    <literal>.tar</literal>, <literal>.tar.bz2</literal>,
+    <literal>.tar.xz</literal>, <literal>.tar.Z</literal> or
+    <literal>.tgz</literal>, respectively.</entry>
+</row>
+
 <row xml:id="uses-tcl">
   <entry><literal>tcl</literal></entry>