There are several stylesheets available for generating viewable documentation, the most useful will probably be:
html, the plain html manual found at http://www.php.net/manual/html/
bightml, one big HTML file, only available for download at http://www.php.net/get/docs
phpweb, the main PHP online manual found at http://www.php.net/manual/
install-win.txt, the text version of the Windows install instructions that goes into the PHP source (as php-src/win32/install.txt). It's based off HTML (via lynx) using install-win.xml. Before commit, be sure Unix style (\n) line endings are used as the Windows packaging script later converts them to Windows format (\r\n). Both install-win.txt and install-win.html are generated.
Be sure the &install.windows.building; entity is removed from en/install/windows/index.xml before building this file.
install-unix.txt, the text version of the Unix install instructions that goes into the PHP source (as php-src/INSTALL). It's based off HTML (via lynx) using install-unix.xml. Before commit, be sure Unix style (\n) line endings are used. Both install-unix.txt and install-unix.html are generated.
pdf, a PDF version of the manual, currently not available online
rtf, a RTF (Rich Text Format) version of the manual, currently not available online
howto, this HOWTO document in a simple HTML format: http://php.net/get/dochowto
There are also XSL stylesheets available, that are equivalents to the above DSSSL sheets. The list includes: html_xsl, bightml_xsl, phpweb_xsl, howto_xsl, chm_xsl and fo (produces a FO file, that can be later transformed to PDF using a FO processor, like Apache FOP)
To generate a viewable copy of the documentation, cd to the phpdoc directory and issue one of the following commands:
To make an actual copy of this HOWTO: The plain text version of the PHP documentation is made by filtering the bightml output through lynx.Note: Generating viewable documentation is CPU intensive and can take a little while to complete. E.g. generating the simple HTML manual takes about 1 hour on a normal computer.
Where the output files are placed depends on the format you built. HTML manuals generate in the html subdirectory of phpdoc, similarly the make phpweb command will place the files in the php directory. The place for the HOWTO HTML files is howto/html.
If all goes well, you should have your own copy of the documentation, including any changes you've made.
Tip: Instead of generating the whole manual (which takes too much time), you can generate just a single section, by issuing the following command: xsltproc --stringparam rootid "<ID>" xsl/html.xsl manual.xml (replacing <ID> by the ID of the file/section you want to build.