- Talk some more about web apps. Grammar police welcome!

svn path=/head/; revision=29862

en_US.ISO8859-1/books/porters-handbook/book.sgml

@@ -6191,7 +6191,7 @@ LIB_DEPENDS+=	QtCore:${PORTSDIR}/devel/qt4-corelib
     </sect1>
 
     <sect1 id="using-php">
-      <title>Using Apache and PHP</title>
+      <title>Web applications, Apache and PHP</title>
 
       <sect2 id="using-apache">
 	<title>Apache</title>
@@ -6330,11 +6330,26 @@ LIB_DEPENDS+=	QtCore:${PORTSDIR}/devel/qt4-corelib
 	    </tbody>
 	  </tgroup>
 	</table>
+      </sect2>
+
+      <sect2 id="web-apps">
+	<title>Web applications</title>
 
 	<para>Web applications should be installed into
-	  <makevar>PREFIX</makevar><filename>/www/<replaceable>appname</replaceable></filename>
-	  and should not assume Apache is present, unless they depend
-	  on Apache explicitly.  User may wish to run them on different
+	  <filename><makevar>PREFIX</makevar>/www/<replaceable>appname</replaceable></filename>.
+	  For your convenience, this path is available both in
+	  <filename>Makefile</filename> and in <filename>pkg-plist</filename>
+	  as <makevar>WWWDIR</makevar>.</para>
+
+	<para>The user and group of web server process are available as
+	  <makevar>WWWOWN</makevar> and <makevar>WWWGRP</makevar>, in case you
+	  need to change the ownership of some files.  The default values of
+	  both are <literal>www</literal>.  If you want different values for
+	  your port, use <literal>WWWOWN?= myuser</literal> notation, to allow
+	  user to override it easily.</para>
+
+	<para>Do not depend on Apache unless the web app explicitly needs
+	  Apache.  Respect that users may wish to run your web app on different
 	  web server than Apache.</para>
 
       </sect2>