svn commit: r48999 - in head/en_US.ISO8859-1/books/porters-handbook: special uses

[Mathieu Arnold]

Author: mat
Date: Fri Jun 24 10:44:46 2016
New Revision: 48999
URL: https://svnweb.freebsd.org/changeset/doc/48999

Log:
  Document USES=php.
  
  Reviewed by:	wblock
  Sponsored by:	Absolight
  Differential Revision:	https://reviews.freebsd.org/D6932

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	Fri Jun 24 10:44:38 2016	(r48998)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Fri Jun 24 10:44:46 2016	(r48999)
@@ -3425,19 +3425,25 @@ do-install:
 
       <important>
 	<para>Use <varname>WWWOWN</varname> and
-	  <varname>WWWGRP</varname>, with parsimony, and remember that
-	  every file the web server can write to is a security risk
-	  waiting to happen.</para>
+	  <varname>WWWGRP</varname> sparingly. Remember that every
+	  file the web server can write to is a security risk waiting
+	  to happen.</para>
       </important>
 
       <para>Do not depend on Apache unless the web app explicitly
 	needs Apache.  Respect that users may wish to run a web
-	app on different web server than Apache.</para>
+	application on a web server other than
+	<application>Apache</application>.</para>
     </sect2>
 
     <sect2 xml:id="php-variables">
       <title>PHP</title>
 
+      <para><application>PHP</application> web applications declare
+	their dependency on it with <literal>USES=php</literal>.
+	Variables are used to specify which
+	<application>PHP</application> modules are required.</para>
+
       <table frame="none" xml:id="using-php-variables">
 	<title>Variables for Ports That Use PHP</title>
 
@@ -3445,10 +3451,7 @@ do-install:
 	  <tbody>
 	    <row>
 	      <entry><varname>USE_PHP</varname></entry>
-	      <entry>The port requires PHP.  The value
-		<literal>yes</literal> adds a dependency on PHP.
-		The list of required PHP extensions can be specified
-		instead.  Example:
+	      <entry>The list of required PHP extensions.  Example:
 		<literal>pcre xml gettext</literal></entry>
 	    </row>
 

Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Fri Jun 24 10:44:38 2016	(r48998)
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml	Fri Jun 24 10:44:46 2016	(r48999)
@@ -1722,6 +1722,15 @@ USE_MATE=	menus:build intlhack</programl
 	_USE_PGSQL_DEP</command>.</para>
   </sect1>
 
+  <sect1 xml:id="uses-php">
+    <title><literal>php</literal></title>
+
+    <para>Possible arguments: (none)</para>
+
+    <para>Provide support for <application>PHP</application>.  See
+      <xref linkend="php-variables"/> for more information.</para>
+  </sect1>
+
   <sect1 xml:id="uses-pkgconfig">
     <title><literal>pkgconfig</literal></title>