This is an old revision of the document!
Checking out the PHP Manual sources from SVN
Introduction
There are two main (and different) methods for checking out the PHP documentation sources.
- Using svn:externals
- Using sparse checkouts
Structure and layout
Regardless, the following descriptions will setup a structure like the following:
phpdoc/en/ phpdoc/doc-base/
Where en/ contains all the XML DocBook files specific to English, and doc-base/ contains the related helper files like PHP scripts for validation.
Methods for checking out (downloading) the sources
Using svn:externals
Several svn:externals already exist within phpdoc/modules and may be used. They are setup as doc-{lang} where {lang} is the language code for the desired language, and doc-all exists to include every language.
svn co http://svn.php.net/repository/phpdoc/modules/doc-en phpdoc
So, that checks out via the svn:externals to a new local directory named phpdoc.
Sparse checkouts
Sparse checkouts are another option.
svn co http://svn.php.net/repository --depth empty phpdoc svn co http://svn.php.net/repository/phpdoc/en/trunk --depth infinity phpdoc/en svn co http://svn.php.net/repository/phpdoc/doc-base/trunk --depth infinity phpdoc/doc-base
Conclusion
A directory named 'phpdoc' (although you can change this, but the above uses it) will contain the two directories (en/ and doc-base/) so a test might be:
cd phpdoc php doc-base/configure.php
That'll configure and validate the checkout.
Notes
The above instructions (for svn:externals and sparse checkouts) checkout trunk from SVN. This is because the manual rarely uses branches or tags, but checking out via one of the above methods is certainly not required, but rather is meant to keep things simple.