Date: Wed, 12 Mar 2014 10:12:42 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44219 - in head/en_US.ISO8859-1/books/porters-handbook: . makefiles Message-ID: <201403121012.s2CACgvL012535@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201403121012.s2CACgvL012535>