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

[Mark Linimon]

Author: linimon
Date: Mon Jun  4 22:43:05 2018
New Revision: 51775
URL: https://svnweb.freebsd.org/changeset/doc/51775

Log:
  The text describing compiler.mk was unclear.
  
  Add explanatory text for c++11-lang, and remove a bogus choice.
  
  Reviewed by:		mat
  Approved by:		mat
  Differential Revision:	D14804

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

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Mon Jun  4 18:37:37 2018	(r51774)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Mon Jun  4 22:43:05 2018	(r51775)
@@ -277,7 +277,8 @@
   <sect1 xml:id="uses-compiler">
     <title><literal>compiler</literal></title>
 
-    <para>Possible arguments: (none), <literal>c++14-lang</literal>,
+    <para>Possible arguments: (none), <literal>env</literal>
+      (default, implicit), <literal>c++14-lang</literal>,
       <literal>c++11-lang</literal>, <literal>gcc-c++11-lib</literal>,
       <literal>c++11-lib</literal>, <literal>c++0x</literal>,
       <literal>c11</literal>, <literal>openmp</literal>,
@@ -285,12 +286,16 @@
 
     <para>Determines which compiler to use based on any given wishes.
       Use <literal>c++14-lang</literal> if the port needs a
-      C++14-capable compiler, <literal>gcc-c++11-lib</literal> if the
+      C++14-capable compiler, <literal>c++11-lang</literal>
+      if the port 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, or <literal>c++11-lib</literal> if the port needs
       a C++11-ready standard library.  If the port needs a compiler
-      understanding C++11, C++0X, C11, OpenMP, or nested functions,
-      the corresponding parameters can be used.  Use
+      understanding C++0X, C11, OpenMP, or nested functions,
+      the corresponding parameters should be used.</para>
+
+    <para>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