ZF-2423: Some documents did NOT follow the DTD rules
When "make check" English documents, it would show some error messages that some documents did not follow the DTD rules.
Here is one example:
Issue this command:
make XMLFILE=Zend_Currency-Useage.xml check1
It would get
_temp_Zend_Currency-Useage.xml:54: element example: validity error : Element example content does not follow the DTD, expecting (blockinfo? , (title , titleabbrev?) , (calloutlist | glosslist | bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | simpara | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | indexterm | beginpage | procedure)+), got (title para programlisting note )
When I moved tag out of the tag, this error message had gone.
To follow DTD rules, I suggest all concerned developers use
make XMLFILE="Zend_Xxxx-Yyyy.xml" check1
command to check the documents you are working on and fix the non-compliance problem in the documents.