Date: Thu, 14 Aug 2014 06:30:44 +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: r45451 - in head/en_US.ISO8859-1/books/porters-handbook: special uses Message-ID: <201408140630.s7E6Ui8w003970@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat (ports committer) Date: Thu Aug 14 06:30:44 2014 New Revision: 45451 URL: http://svnweb.freebsd.org/changeset/doc/45451 Log: Catch up with last months updates in ports/Mk/Uses. Reviewed by: wblock, antoine Sponsored by: Absolight Differential Revision: https://phabric.freebsd.org/D534 Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Wed Aug 13 22:48:26 2014 (r45450) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Thu Aug 14 06:30:44 2014 (r45451) @@ -489,19 +489,13 @@ IGNORE= may not be redistributed because <command>make</command> implementation expected by the ported software.</para> - <para>If your port is an X application that creates - <filename>Makefile</filename> files from - <filename>Imakefile</filename> files using - <application>imake</application>, then set - <literal>USES= imake</literal>. This will cause the - configure stage to automatically do an - <command>xmkmf -a</command>. If the <option>-a</option> - flag is a problem for your port, set - <literal>XMKMF=xmkmf</literal>. If the port uses - <application>imake</application> but does not understand the - <buildtarget>install.man</buildtarget> target, - <literal>NO_INSTALL_MANPAGES=yes</literal> should be - set.</para> + <para>If the port is an X application that uses + <application>imake</application> to create + <filename>Makefile</filename>s from + <filename>Imakefile</filename>s, set <literal>USES= + imake</literal>.. See the <link + linkend="uses-imake"><literal>USES=imake</literal></link> + section of <xref linkend="uses"/> for more details.</para> <para>If your port's source <filename>Makefile</filename> has something else than <buildtarget>all</buildtarget> as the @@ -816,13 +810,9 @@ CMAKE_SOURCE_PATH= ${WRKSRC}/subp libtool (search for a file named ltmain.sh) need to have <literal>USES=libtool</literal>. Also, if a port has <literal>USE_AUTOTOOLS=libtoolize</literal> it probably also - needs <literal>USES=libtool</literal>.</para> + needs <literal>USES=libtool</literal>. See the <link linkend="uses-libtool">USES=libtool</link> + section in <xref linkend="uses"/> for more details.</para> - <para>Some ports do not ship with their own copy of libtool and - expect libtool to be provided by the build system. In that - case simply add:</para> - - <programlisting>BUILD_DEPENDS= libtool:${PORTSDIR}/devel/libtool.</programlisting> </sect2> <sect2 xml:id="using-libltdl"> Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Wed Aug 13 22:48:26 2014 (r45450) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Thu Aug 14 06:30:44 2014 (r45451) @@ -8,6 +8,8 @@ <!-- + Document up-to date with r364718 revision of the ports tree. + This file documents the values of the USES make variable. The format is easy to grasp from the already-added entries below (or use this scheme below as a skeleton): @@ -45,11 +47,13 @@ <row xml:id="uses-ada"> <entry><literal>ada</literal></entry> - <entry>(none)</entry> + <entry>(none), <literal>47</literal></entry> <entry>Depends on an <application>Ada</application>-capable - compiler, and sets <varname>CC</varname> - accordingly.</entry> + compiler, and sets <varname>CC</varname> accordingly. + Defaults to a <application>gcc</application> 4.9 based + compiler, use <literal>:47</literal> to use the older + <application>gcc</application> 4.7 based one.</entry> </row> <row xml:id="uses-bison"> @@ -101,13 +105,16 @@ <entry>(none), <literal>c++0x</literal>, <literal>c++11-lang</literal>, + <literal>gcc-c++11-lib</literal>, <literal>c++11-lib</literal>, <literal>c11</literal>, <literal>openmp</literal>, <literal>nestedfct</literal>, <literal>features</literal></entry> <entry>Determines which compiler to use based on any given wishes. Use <literal>c++11-lang</literal> if the port - needs a C++11-capable compiler, and + needs a C++11-capable compiler, + <literal>gcc-c++11-lib</literal> if the port needs the + <command>g++</command> compiler with a C++11 library, and <literal>c++11-lib</literal> if the port also needs a C++11-ready standard library. If the port needs a compiler understanding C++0X, C11, OpenMP, or nested @@ -329,6 +336,33 @@ </itemizedlist></entry> </row> + <row xml:id="uses-drupal"> + <entry><literal>drupal</literal></entry> + + <entry><literal>6</literal>, <literal>7</literal>, + <literal>module</literal>, + <literal>theme</literal></entry> + + <entry>Automate installation of a port that is a + <application>Drupal</application> + theme or module. Use with the version of Drupal that the + port is expecting. For example, + <literal>USES=drupal:6,module</literal> says that this + port creates a Drupal 6 module. A Drupal 7 theme can be + specified with + <literal>USES=drupal:7,theme</literal>.</entry> + </row> + + <row xml:id="uses-execinfo"> + <entry><literal>execinfo</literal></entry> + + <entry>(none)</entry> + + <entry>Add a runtime dependency on + <filename>libexecinfo.so</filename> depending on its + presence in the base system.</entry> + </row> + <row xml:id="uses-fam"> <entry><literal>fam</literal></entry> @@ -370,6 +404,28 @@ version of &os;.</entry> </row> + <row xml:id="uses-gecko"> + <entry><literal>gecko</literal></entry> + + <entry><literal>libxul</literal> (default), + <literal>firefox</literal>, <literal>seamonkey</literal>, + <literal>thunderbird</literal>, <literal>build</literal>, + <literal><replaceable>XY</replaceable></literal>, + <literal><replaceable>XY</replaceable>+</literal></entry> + + <entry>Add a dependency on different + <application>gecko</application> based applications. If + <literal>libxul</literal> is used, it is the only argument + allowed. When the argument is not + <literal>libxul</literal>, the <literal>firefox</literal>, + <literal>seamonkey</literal>, or + <literal>thunderbird</literal> arguments can be used, + along with optional <literal>build</literal> and + <literal><replaceable>XY</replaceable></literal>/<literal><replaceable>XY</replaceable>+</literal> + version + arguments.</entry> + </row> + <row xml:id="uses-gettext"> <entry><literal>gettext</literal></entry> @@ -388,9 +444,11 @@ <row xml:id="uses-gmake"> <entry><literal>gmake</literal></entry> - <entry>(none)</entry> + <entry>(none), <literal>lite</literal></entry> - <entry>Uses <package role="port">devel/gmake</package> as a + <entry>Uses <package role="port">devel/gmake</package>, or + <package role="port">devel/gmake-lite</package> if the + <literal>lite</literal> argument is used, as a build-time dependency and sets up the environment to use <command>gmake</command> as the default <command>make</command> for the build.</entry> @@ -494,7 +552,8 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa <entry>(none), <literal>lib</literal>, <literal>build</literal>, - <literal>patch</literal></entry> + <literal>patch</literal>, <literal>translit</literal>, + <literal>wchar_t</literal></entry> <entry>Uses <command>iconv</command> functions, either from the port @@ -507,7 +566,11 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa implies <command>iconv</command> with build-time and run-time dependencies. <literal>build</literal> implies a build-time dependency, and <literal>patch</literal> - implies a patch-time dependency. For more information see + implies a patch-time dependency. If the port uses the + <literal>WCHAR_T</literal> or + <literal>//TRANSLIT</literal> iconv extensions, add the + relevant arguments so that the correct iconv is used. For + more information see <xref linkend="using-iconv"/>.</entry> </row> @@ -515,14 +578,19 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa <entry><literal>imake</literal></entry> <entry>(none), <literal>env</literal>, - <literal>notall</literal></entry> + <literal>notall</literal>, + <literal>noman</literal></entry> - <entry>Uses <package role="port">devel/imake</package> as - build-time dependency. If the <literal>env</literal> - argument is given, only setup the environment and do not - define any target. If the <literal>notall</literal> - argument is given does not pass <literal>-a</literal> to - <command>xmkmf</command>.</entry> + <entry>Add <package role="port">devel/imake</package> as a + build-time dependency and run <command>xmkmf -a</command> + during the <buildtarget>configure</buildtarget> stage. If + the <literal>env</literal> argument is given, the + <buildtarget>configure</buildtarget> target is not set. + If the <option>-a</option> flag is a problem for the port, + add the <literal>notall</literal> argument. If + <command>xmkmf</command> does not generate a + <buildtarget>install.man</buildtarget> target, add the + <literal>noman</literal> argument.</entry> </row> <row xml:id="uses-kmod"> @@ -584,29 +652,49 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa <row xml:id="uses-libtool"> <entry><literal>libtool</literal></entry> - <entry>(none)</entry> + <entry>(none), <literal>keepla</literal>, + <literal>build</literal></entry> <entry>Patches <command>libtool</command> scripts. This should be added to all ports that use - <command>libtool</command>.</entry> + <command>libtool</command>. The <literal>keepla</literal> + argument can be used to keep the <filename>.la</filename> + files. Some ports do not ship with their own copy of + libtool and need a build time dependency on <package + role="port">devel/libtool</package>, use the + <literal>:build</literal> argument to add such + dependency.</entry> </row> <row xml:id="uses-lua"> <entry><literal>lua</literal></entry> - <entry>(none), <literal>XY+</literal>, - <literal>XY</literal>, <literal>build</literal>, + <entry>(none), + <literal><replaceable>XY</replaceable>+</literal>, + <literal><replaceable>XY</replaceable></literal>, + <literal>build</literal>, <literal>run</literal></entry> <entry>Adds a dependency on <application>Lua</application>. By default this is a library undependency, unless overridden by the <literal>build</literal> or <literal>run</literal> option. The default version is - 5.2, unless set by the <literal>XY</literal> parameter + 5.2, unless set by the + <literal><replaceable>XY</replaceable></literal> parameter (e.g., <literal>51</literal> or <literal>52+</literal>).</entry> </row> + <row xml:id="uses-makeinfo"> + <entry><literal>makeinfo</literal></entry> + + <entry><literal>build</literal> (default), + <literal>run</literal>, <literal>both</literal></entry> + + <entry>Add the corresponding dependencies on + <command>makeinfo</command>.</entry> + </row> + <row xml:id="uses-makeself"> <entry><literal>makeself</literal></entry> @@ -660,6 +748,15 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa for verbose output.</entry> </row> + <row xml:id="uses-objc"> + <entry><literal>objc</literal></entry> + + <entry>(none)</entry> + + <entry>Add objective C dependencies (compiler, runtime + library) if the base system does not support it.</entry> + </row> + <row xml:id="uses-openal"> <entry><literal>openal</literal></entry> @@ -683,7 +780,10 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa <entry>Look for the <filename>Makefile.in</filename> and <filename>configure</filename> files in the port's associated sources and fix common paths to make sure they - respect the &os; hierarchy.</entry> + respect the &os; hierarchy. If the port uses + <command>automake</command>, set + <varname>PATHFIX_MAKEFILEIN</varname> to + <filename>Makefile.am</filename> if needed.</entry> </row> <row xml:id="uses-perl5"> @@ -746,9 +846,10 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa <row xml:id="uses-pgsql"> <entry><literal>pgsql</literal></entry> - <entry>(none), <literal>X.Y</literal>, - <literal>X.Y+</literal>, - <literal>X.Y-</literal></entry> + <entry>(none), + <literal><replaceable>X.Y</replaceable></literal>, + <literal><replaceable>X.Y</replaceable>+</literal>, + <literal><replaceable>X.Y</replaceable>-</literal></entry> <entry> <para>Provide support for PostgreSQL. Maintainer can @@ -864,30 +965,35 @@ GSSAPI_NONE_CONFIGURE_ON= --without-gssa <filename>/usr/bin/perl</filename> and <filename>/bin/bash</filename>. This fixes shebang lines in scripts listed in <varname>SHEBANG_FILES</varname>. - Currently <application>Perl</application>, + Currently <application>Bash</application>, + <application>Java</application>, + <application>Perl</application>, + <application>PHP</application>, <application>Python</application>, - <application>Bash</application>, - <application>Ruby</application>, and - <application>PHP</application> are supported by default. + <application>Ruby</application>, + <application>Tcl</application>, and + <application>Tk</application> are supported by default. To support another interpreter, set - <varname>SHEBANG_LANG</varname> (for example - <literal>SHEBANG_LANG=lua</literal>), then + <varname>SHEBANG_LANG</varname>, <varname>lua_OLD_CMD</varname> and - <varname>lua_CMD</varname>.</entry> + <varname>lua_CMD</varname>. For example + <literal>SHEBANG_LANG=lua</literal>, then + <varname>lua_OLD_CMD=/usr/bin/lua</varname> and + <varname>lua_CMD=${LOCALBASE}/bin/lua</varname>.</entry> </row> <row xml:id="uses-tar"> <entry><literal>tar</literal></entry> - <entry>(none), <literal>Z</literal>, + <entry>(none), <literal>Z</literal>, <literal>bz2</literal>, <literal>bzip2</literal>, <literal>lzma</literal>, - <literal>tbz</literal>, <literal>tgz</literal>, + <literal>tbz</literal>, <literal>tgz</literal>, <literal>txz</literal>, <literal>xz</literal></entry> <entry>Set <varname>EXTRACT_SUFX</varname> to <literal>.tar</literal>, <literal>.tar.Z</literal>, - <literal>.tar.bz2</literal>, <literal>.tar.lzma</literal>, - <literal>.tbz</literal>, <literal>.tgz</literal> or + <literal>.tar.bz2</literal>, <literal>.tar.bz2</literal>, <literal>.tar.lzma</literal>, + <literal>.tbz</literal>, <literal>.tgz</literal>, <literal>.txz</literal> or <literal>.tar.xz</literal> respectively.</entry> </row>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201408140630.s7E6Ui8w003970>