diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 6b4c448a97..09c822c0f5 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/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>