2009/1/20 Richard Quadling <rquadl...@googlemail.com>: > 2009/1/20 Richard Quadling <rquadl...@googlemail.com>: >> 2009/1/20 Laurent Laville <p...@laurent-laville.org>: >>> Hello, >>> >>> I've just upgraded my windows platform from PhD 0.4.2 to PhD 0.4.3 (without >>> error or problem). >>> >>> Before to include my external guide of HTML_CSS to PEAR Manual, I've built a >>> fresh version, and I got surprises. >>> >>> Step1 : php configure.php >>> >>> Output: >>> Generating chapters.ent for en >>> 3324 xml files >>> 2 php examples files >>> done >>> Loading manual into one giant file >>> Validating >>> done >>> Now call phd: >>> phd -f xhtml -t pearchunkedhtml -o build/en -d giant.xml >>> >>> Step2 : Until now no surprises, but when I run the call to phd >>> >>> Output: >>> [11:13:37 - VERBOSE_INDEXING] Indexing... >>> [11:13:58 - VERBOSE_INDEXING] Indexing done >>> [11:13:58 - VERBOSE_FORMAT_RENDERING] Starting xhtml rendering >>> [11:13:58 - VERBOSE_THEME_RENDERING] Using the php theme () >>> [11:13:58 - VERBOSE_THEME_RENDERING] Using the pear theme (pearchunkedhtml) >>> [11:13:58 - VERBOSE_RENDER_STYLE] Running full build >>> Array >>> ( >>> [0] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 7 >>> [message] => Opening and ending tag mismatch: div line 1 and p >>> >>> [file] => >>> [line] => 2 >>> ) >>> >>> [1] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 5 >>> [column] => 7 >>> [message] => Extra content at the end of the document >>> >>> [file] => >>> [line] => 2 >>> ) >>> >>> ) >>> Array >>> ( >>> [0] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: dd line 71 and p >>> >>> [file] => >>> [line] => 77 >>> ) >>> >>> [1] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: p line 86 and dd >>> >>> [file] => >>> [line] => 92 >>> ) >>> >>> [2] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: dd line 115 and p >>> >>> [file] => >>> [line] => 123 >>> ) >>> >>> [3] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: p line 140 and dd >>> >>> [file] => >>> [line] => 141 >>> ) >>> >>> ) >>> Array >>> ( >>> [0] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: dd line 9 and p >>> >>> [file] => >>> [line] => 15 >>> ) >>> >>> [1] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: p line 34 and dd >>> >>> [file] => >>> [line] => 35 >>> ) >>> >>> ) >>> Array >>> ( >>> [0] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 7 >>> [message] => Opening and ending tag mismatch: div line 1 and p >>> >>> [file] => >>> [line] => 2 >>> ) >>> >>> [1] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 5 >>> [column] => 7 >>> [message] => Extra content at the end of the document >>> >>> [file] => >>> [line] => 2 >>> ) >>> >>> ) >>> Array >>> ( >>> [0] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 7 >>> [message] => Opening and ending tag mismatch: div line 1 and p >>> >>> [file] => >>> [line] => 2 >>> ) >>> >>> [1] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 5 >>> [column] => 7 >>> [message] => Extra content at the end of the document >>> >>> [file] => >>> [line] => 2 >>> ) >>> >>> ) >>> Array >>> ( >>> [0] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: dd line 9 and p >>> >>> [file] => >>> [line] => 23 >>> ) >>> >>> [1] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: p line 30 and dd >>> >>> [file] => >>> [line] => 31 >>> ) >>> >>> [2] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: dd line 39 and p >>> >>> [file] => >>> [line] => 44 >>> ) >>> >>> [3] => LibXMLError Object >>> ( >>> [level] => 3 >>> [code] => 76 >>> [column] => 10 >>> [message] => Opening and ending tag mismatch: p line 70 and dd >>> >>> [file] => >>> [line] => 81 >>> ) >>> >>> ) >>> [11:15:35 - VERBOSE_FORMAT_RENDERING] Finished rendering >>> >>> >>> BTW, the PEAR manual was built. >>> What's wrong ? PEAR Manual structure or anything else >>> >>> Laurent >>> >> >> If you add --no-hide-xml-errors --verbose to the peardoc/configure.php >> call you get ... >> >> Warning: DOMDocument::validate(): Element para is not declared in para >> list of possible children in D:\Personal >> Files\Downloads\Software\Programming\PHP\Checkouts\peardoc\configure.php >> on line 228 >> Manual has errors. Use >> xmllint --valid --noout manual.xml >> xmllint --valid --noout giant.xml >> to get detailled error messages. >> >> The xmllint leads to the error ... > > en/package/xml/xml-dtd/usage.xml:38: element para: validity error : > Element para is not declared in para list of possible children > </para> > ^ > >> >> That leads to this patch ... >> >> Index: usage.xml >> =================================================================== >> RCS file: /repository/peardoc/en/package/xml/xml-dtd/usage.xml,v >> retrieving revision 1.1 >> diff -u -r1.1 usage.xml >> --- usage.xml 18 Jan 2009 23:27:50 -0000 1.1 >> +++ usage.xml 20 Jan 2009 10:57:56 -0000 >> @@ -32,7 +32,7 @@ >> <methodname>isValid()</methodname> will return true when the XML >> document validates and false otherwise. >> <para> >> - </para> >> + <para> >> This is pretty much the most common usage of XML_DTD and all you need >> to know to get started. >> </para> >> >> Can someone in PEAR please commit this (I've got PHPDOC karma but not >> PEARDOC). >> >> >> >> >> >> -- >> ----- >> Richard Quadling >> Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731 >> "Standing on the shoulders of some very clever giants!" >> > > > > -- > ----- > Richard Quadling > Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731 > "Standing on the shoulders of some very clever giants!" >
And if you spot the deliberate mistake ... Sorry! Index: usage.xml =================================================================== RCS file: /repository/peardoc/en/package/xml/xml-dtd/usage.xml,v retrieving revision 1.1 diff -u -r1.1 usage.xml --- usage.xml 18 Jan 2009 23:27:50 -0000 1.1 +++ usage.xml 20 Jan 2009 11:08:17 -0000 @@ -31,8 +31,8 @@ <para> <methodname>isValid()</methodname> will return true when the XML document validates and false otherwise. - <para> </para> + <para> This is pretty much the most common usage of XML_DTD and all you need to know to get started. </para> -- ----- Richard Quadling Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731 "Standing on the shoulders of some very clever giants!"
usage.xml.patch
Description: Binary data