An important part of making contributions to the PHP documentation is being able to validate your changes and to be able to see what they will look like in their various forms, whether that is in HTML, Adobe PDF, RTF or other formats.
Configure (configure.php) has several options that are used to help validate XML changes before commit, and also setup the build environment. A few examples.
Example #1 configure.php examples
# List the configure usage options $ php configure.php --help # Choose a language (like Japanese), the default is English # Note: This assumes you checked out ja either as phpdoc-ja or phpdoc-all $ php configure.php --with-lang=ja # If a validation error occurred that requires additional debugging info then # this (--enable-xml-details) memory intensive option may help $ php configure.php --enable-xml-details # Force a save even when the XML document is invalid $ php configure.php --force-dom-save # To configure one specific book, with APC as an example. This will create # .manual.book.apc.xml instead of .manual.xml and although slightly faster # it's not preferred. Consider creating .manual.xml and use PhD to choose ids # as later described in this HOWTO $ php configure.php --partial=book.apc
Note: The future of configure.php
The configure.php script (which replaced autoconf/configure/make) will be replaced by "PhD Setup" in the future. However, feel free to report bugs and problems as they occur.