Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 3 Feb 2014 15:30:15 +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: r43733 - head/en_US.ISO8859-1/books/porters-handbook
Message-ID:  <201402031530.s13FUFD2034899@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: mat (ports committer)
Date: Mon Feb  3 15:30:15 2014
New Revision: 43733
URL: http://svnweb.freebsd.org/changeset/doc/43733

Log:
  Try and complete the missing USES that exist.
  
  Sponsored by:	Absolight

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/book.xml	Mon Feb  3 09:09:52 2014	(r43732)
+++ head/en_US.ISO8859-1/books/porters-handbook/book.xml	Mon Feb  3 15:30:15 2014	(r43733)
@@ -5854,6 +5854,36 @@ IGNORE=	may not be redistributed because
 	  </tgroup>
 	</table>
 
+	<table frame="none">
+	  <title>Variables the Users can define for
+	    <command>cmake</command> builds</title>
+
+	  <tgroup cols="2">
+	    <thead>
+	      <row>
+		<entry>Variable</entry>
+		<entry>Means</entry>
+	      </row>
+	    </thead>
+
+	    <tbody>
+	      <row>
+		<entry><varname>CMAKE_VERBOSE</varname></entry>
+		<entry>Enable verbose build output.  Default not set,
+		  unless <varname>BATCH</varname> or
+		  <varname>PACKAGE_BUILDING</varname> are set.</entry>
+	      </row>
+
+	      <row>
+		<entry><varname>CMAKE_NOCOLOR</varname></entry>
+		<entry>Disables colour build output.  Default not set,
+		  unless <varname>BATCH</varname> or
+		  <varname>PACKAGE_BUILDING</varname> are set.</entry>
+	      </row>
+	    </tbody>
+	  </tgroup>
+	</table>
+
 	<para><application>CMake</application> supports the following
 	  build profiles: <literal>Debug</literal>,
 	  <literal>Release</literal>,

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Mon Feb  3 09:09:52 2014	(r43732)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Mon Feb  3 15:30:15 2014	(r43733)
@@ -57,11 +57,14 @@
 <row>
   <entry><literal>cmake</literal></entry>
 
-  <entry>(none), <literal>outsource</literal></entry>
+  <entry>(none), <literal>outsource</literal>,
+    <literal>run</literal></entry>
 
   <entry>Uses <application>CMake</application> for configuring and
     building.  With the <literal>outsource</literal> argument, an
-    out-of-source build will be performed.  For more information see
+    out-of-source build will be performed.  With the
+    <literal>run</literal> argument, a run-time dependency is
+    registered.  For more information see
     <xref linkend="using-cmake"/>.</entry>
 </row>
 
@@ -132,16 +135,6 @@
 </row>
 
 <row>
-  <entry><literal>desthack</literal></entry>
-
-  <entry>(none)</entry>
-
-  <entry>Changes the behavior of GNU configure to properly support
-    <varname>DESTDIR</varname> in case the original software does
-    not.</entry>
-</row>
-
-<row>
   <entry><literal>desktop-file-utils</literal></entry>
 
   <entry>(none)</entry>
@@ -156,9 +149,19 @@
 </row>
 
 <row>
+  <entry><literal>desthack</literal></entry>
+
+  <entry>(none)</entry>
+
+  <entry>Changes the behavior of GNU configure to properly support
+    <varname>DESTDIR</varname> in case the original software does
+    not.</entry>
+</row>
+
+<row>
   <entry><literal>display</literal></entry>
 
-  <entry>(none), <literal>ARGS</literal></entry>
+  <entry>(none), ARGS</entry>
 
   <entry>Set up a virtual display environment.  If the environment
     variable <varname>DISPLAY</varname> is not set, then
@@ -241,15 +244,15 @@
 <row>
   <entry><literal>gettext</literal></entry>
 
-  <entry>(none), <literal>lib</literal>, <literal>build</literal>,
-    <literal>run</literal></entry>
+  <entry>(none), <literal>lib</literal> (default),
+    <literal>build</literal>, <literal>run</literal></entry>
 
   <entry>Uses <package role="port">devel/gettext</package>.  By
     default, with no arguments or with the <literal>lib</literal>
-    argument, implies <command>gettext</command> with build-time and
-    run-time dependencies.  <literal>build</literal> implies a
-    build-time dependency, and <literal>run</literal> implies a
-    run-time dependency.</entry>
+    argument, implies a library dependency on
+    <filename>libintl.so</filename>.  <literal>build</literal> and
+    <literal>run</literal> implies, respectively a build-time and a
+    run-time dependency on <filename>xgettext</filename>.</entry>
 </row>
 
 <row>
@@ -258,7 +261,9 @@
   <entry>(none)</entry>
 
   <entry>Uses <package role="port">devel/gmake</package> as a
-    build-time dependency.</entry>
+    build-time dependency and sets up the environment to use
+    <command>gmake</command> as the default <command>make</command>
+    for the build.</entry>
 </row>
 
 <row>
@@ -283,10 +288,14 @@
 <row>
   <entry><literal>imake</literal></entry>
 
-  <entry>(none)</entry>
+  <entry>(none), <literal>env</literal>,
+    <literal>notall</literal></entry>
 
   <entry>Uses <package role="port">devel/imake</package> as
-    build-time dependency.</entry>
+    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>
 </row>
 
 <row>
@@ -335,6 +344,15 @@
 </row>
 
 <row>
+  <entry><literal>libtool</literal></entry>
+
+  <entry>(none)</entry>
+
+  <entry>Patches <command>libtool</command> scripts.  This should be
+    added to all ports that use <command>libtool</command>.</entry>
+</row>
+
+<row>
   <entry><literal>lua</literal></entry>
 
   <entry>(none), <literal>XY+</literal>, <literal>XY</literal>,
@@ -353,11 +371,11 @@
 
   <entry>(none)</entry>
 
-  <entry>Uses <package role="port">devel/open-motif</package> as a
-    library dependency.  End users can set
+  <entry>Uses <package role="port">x11-toolkits/open-motif</package>
+    as a library dependency.  End users can set
     <varname>WANT_LESSTIF</varname> for the dependency to be on
-    <package role="port">devel/lesstif</package> instead of
-    <package role="port">devel/open-motif</package>.</entry>
+    <package role="port">x11-toolkits/lesstif</package> instead of
+    <package role="port">x11-toolkits/open-motif</package>.</entry>
 </row>
 
 <row>
@@ -456,10 +474,29 @@
 </row>
 
 <row>
+  <entry><literal>pgsql</literal></entry>
+
+  <entry>(none), <literal>X.Y</literal>, <literal>X.Y+</literal>,
+    <literal>X.Y-</literal></entry>
+
+  <entry>
+    <para>Provide support for PostgreSQL.  Maintainer can set version
+      required.  Minimum and maximum versions can be specified; e.g.,
+      9.0-, 8.4+.</para>
+
+    <para>Add PostgreSQL component dependency, using
+      <literal>WANT_PGSQL=component[:target]</literal>.  e.g.,
+      <literal>WANT_PGSQL=server:configure pltcl plperl</literal> For
+      the full list use <command>make -V
+	_USE_PGSQL_DEP</command>.</para>
+  </entry>
+</row>
+
+<row>
   <entry><literal>pkgconfig</literal></entry>
 
-  <entry>(none), <literal>build</literal>, <literal>run</literal>,
-    <literal>both</literal></entry>
+  <entry>(none), <literal>build</literal> (default),
+    <literal>run</literal>, <literal>both</literal></entry>
 
   <entry>Uses <package role="port">devel/pkgconf</package>.  With no
     arguments or with the <literal>build</literal> argument, it
@@ -499,7 +536,8 @@
 <row>
   <entry><literal>qmake</literal></entry>
 
-  <entry>(none), <literal>norecursive</literal></entry>
+  <entry>(none), <literal>norecursive</literal>,
+    <literal>outsource</literal></entry>
 
   <entry>Uses <application>QMake</application> for configuring.  For
     more information see <xref linkend="using-qmake"/>.</entry>
@@ -508,11 +546,22 @@
 <row>
   <entry><literal>readline</literal></entry>
 
-  <entry>(none), port</entry>
+  <entry>(none), <literal>port</literal></entry>
 
   <entry>Uses <application>readline</application> as library
     dependency, and sets <varname>CPPFLAGS</varname> and
-    <varname>LDFLAGS</varname> as necessary.</entry>
+    <varname>LDFLAGS</varname> as necessary.  If the
+    <literal>port</literal> argument is used, force the use of
+    <package role="port">devel/readline</package></entry>
+</row>
+
+<row>
+  <entry><literal>scons</literal></entry>
+
+  <entry>(none)</entry>
+
+  <entry>Provide support for the use of
+    <package role="port">devel/scons</package></entry>
 </row>
 
 <row>
@@ -662,6 +711,39 @@
 </row>
 
 <row>
+  <entry><literal>uniquefiles</literal></entry>
+
+  <entry>(none), <literal>dirs</literal></entry>
+
+  <entry>
+    Make files or directories 'unique', by adding a prefix or suffix.
+    If the <literal>dirs</literal> argument is used, the port needs a
+    prefix (a only a prefix) based on <varname>UNIQUE_PREFIX</varname>
+    for standard directories <varname>DOCSDIR</varname>,
+    <varname>EXAMPLESDIR</varname>, <varname>DATADIR</varname>,
+    <varname>WWWDIR</varname>, <varname>ETCDIR</varname>.  The
+    following variables are available for ports:
+    <itemizedlist>
+      <listitem><para><varname>UNIQUE_PREFIX</varname>: The prefix to
+	be used for directories and files.  Default:
+	<varname>${PKGNAMEPREFIX}</varname>.</para></listitem>
+
+      <listitem><para><varname>UNIQUE_PREFIX_FILES</varname>: A list
+	of files that need to be prefixed.  Default:
+	empty.</para></listitem>
+
+      <listitem><para><varname>UNIQUE_SUFFIX</varname>: The suffix to
+	be used for files.  Default:
+	<varname>${PKGNAMESUFFIX}</varname>.</para></listitem>
+
+      <listitem><para><varname>UNIQUE_SUFFIX_FILES</varname>: A list
+	of files that need to be suffixed.  Default:
+	empty.</para></listitem>
+    </itemizedlist>
+  </entry>
+</row>
+
+<row>
   <entry><literal>webplugin</literal></entry>
 
   <entry>(none), <literal>ARGS</literal></entry>



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201402031530.s13FUFD2034899>