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

[Rene Ladan]

Author: rene
Date: Fri Nov 22 16:34:57 2013
New Revision: 43217
URL: http://svnweb.freebsd.org/changeset/doc/43217

Log:
  Add a description for USES=compiler.
  
  Reviewed by:	bapt

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Fri Nov 22 15:29:45 2013	(r43216)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses.xml	Fri Nov 22 16:34:57 2013	(r43217)
@@ -60,6 +60,42 @@
 </row>
 
 <row>
+  <entry><literal>compiler</literal></entry>
+  <entry>(none), <literal>c++11-lang</literal>,
+    <literal>c++11-lib</literal>, <literal>c11</literal>,
+    <literal>openmp</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 <literal>c++11-lib</literal> if the port also needs
+    a C++11-ready standard library.  If the port needs a compiler
+    understanding C11 or OpenMP, the corresponding parameters can be
+    used.  Use <literal>features</literal> to request a list of features
+    supported by the default compiler.  After including
+    <filename>bsd.port.pre.mk</filename> the port can inspect the results
+    using these variables:
+    <itemizedlist>
+      <listitem><para><varname>COMPILER_TYPE</varname>: the default
+	    compiler on the system, either gcc or clang</para></listitem>
+      <listitem><para><varname>ALT_COMPILER_TYPE</varname>: the
+	    alternative compiler on the system, either gcc or clang.
+	    Only set if two compilers are present in the base
+	    system.</para></listitem>
+      <listitem><para><varname>COMPILER_VERSION</varname>: the first two
+	    digits of the version of the default
+	    compiler.</para></listitem>
+      <listitem><para><varname>ALT_COMPILER_VERSION</varname>: the first
+	    two digits of the version of the alternative compiler, if
+	    present.</para></listitem>
+      <listitem><para><varname>CHOSEN_COMPILER_TYPE</varname>: the
+	    chosen compiler, either gcc or clang</para></listitem>
+      <listitem><para><varname>COMPILER_FEATURES</varname>: the features
+	    supported by the default compiler.  It currently lists the
+	    C++ library.</para></listitem>
+    </itemizedlist></entry>
+</row>
+
+<row>
   <entry><literal>desktop-file-utils</literal></entry>
   <entry>(none)</entry>