About PhD 0.4.3 and PEAR Manual

[Laurent Laville]

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

[Richard Quadling]

Post by Laurent Laville
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
Generating chapters.ent for en
3324 xml files
2 php examples files
done
Loading manual into one giant file
Validating
done
phd -f xhtml -t pearchunkedhtml -o build/en -d giant.xml
Step2 : Until now no surprises, but when I run the call to phd
[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 ...

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]

Post by Richard Quadling

Post by Laurent Laville
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
Generating chapters.ent for en
3324 xml files
2 php examples files
done
Loading manual into one giant file
Validating
done
phd -f xhtml -t pearchunkedhtml -o build/en -d giant.xml
Step2 : Until now no surprises, but when I run the call to phd
[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>
^

Post by Richard Quadling
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]

Post by Richard Quadling

Post by Richard Quadling

Post by Laurent Laville
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
Generating chapters.ent for en
3324 xml files
2 php examples files
done
Loading manual into one giant file
Validating
done
phd -f xhtml -t pearchunkedhtml -o build/en -d giant.xml
Step2 : Until now no surprises, but when I run the call to phd
[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 ...

Element para is not declared in para list of possible children
</para>
^

Post by Richard Quadling
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>

[Laurent Laville]

Post by Richard Quadling
Element para is not declared in para list of possible children
</para>
^

Thanks to point error Richard. I've karma to peardoc and just committed
the fix .

Laurent

[Laurent Laville]

Post by Richard Quadling
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 ...

And thanks again for the TIP; I don't know yet this option (it's very
usefull)

Laurent :)