cleanup code generation config and instructions

Author: dbu

composer.json

@@ -5,6 +5,8 @@
     "homepage": "http://phpcr.github.com",
     "license": "MIT",
     "require": {
-        "phpdocumentor/template-phpcr": "dev-master@dev"
+        "phpdocumentor/template-phpcr": "dev-master@dev",
+        "phpcr/phpcr": "dev-master@dev",
+        "phpcr/phpcr-utils": "dev-master@dev"
     }
 }

composer.lock

@@ -1 +1,14 @@
-See phpcr doc/config/ directory for information how to generate the configuration
+This is using the phpDocumentor2, see phpdoc.org
+
+To generate the doc, you currently need to run phpdoc as root (see https://github.com/phpDocumentor/phpDocumentor2/pull/728)
+
+1. Run composer to get the phpDocumentor templates and the source code to be documented
+
+    php composer.phar update
+
+(You want to genrate the latest doc, so update and not install)
+
+2. Generate the doc
+
+    sudo phpdoc -c phpdoc.dist.xml
+    sudo phpdoc -c phpdoc-all.dist.xml

doc/config/README

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!-- documentation file for phpDocumentor2 -->
+<phpdoc>
+    <title>PHPCR API and PHPCR-Utils</title>
+    <parser>
+        <target>../html-all/</target>
+    </parser>
+    <transformer>
+        <target>../html-all/</target>
+    </transformer>
+    <transformations>
+        <template name="../../data/templates/phpcr" />
+    </transformations>
+    <files>
+        <directory>../../vendor/phpcr/phpcr/src</directory>
+        <directory>../../vendor/phpcr/phpcr-utils/src</directory>
+    </files>
+</phpdoc>

doc/config/phpdoc-all.dist.xml

@@ -3,16 +3,15 @@
 <phpdoc>
     <title>PHPCR API and PHPCR-Utils</title>
     <parser>
-        <target>../html-all/</target>
+        <target>../html/</target>
     </parser>
     <transformer>
-        <target>../html-all/</target>
+        <target>../html/</target>
     </transformer>
     <transformations>
         <template name="../../data/templates/phpcr" />
     </transformations>
     <files>
-        <directory>../../../phpcr/src</directory>
-        <directory>../../../phpcr-utils/src</directory>
+        <directory>../../vendor/phpcr/phpcr/src</directory>
     </files>
 </phpdoc>