ZF-2423: Some documents did NOT follow the DTD rules

Issue Type: Docs: Problem Created: 2008-01-11T12:24:32.000+0000 Last Updated: 2008-06-15T20:54:15.000+0000 Status: Resolved Fix version(s): - 1.0.4 (26/Feb/08)

Reporter: Jason Qi (jason qi) Assignee: Jason Qi (jason qi) Tags: Related issues: Attachments:


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.


Posted by Wil Sinclair (wil) on 2008-01-15T16:48:15.000+0000

Pretty sure there was a 'not' missing from the title. :)

Posted by Wil Sinclair (wil) on 2008-01-15T16:50:02.000+0000

darby, can you fix these docs for the 1.0.4 release or delegate to someone in the community? Do we know if these were the cause of the segfaults in building the docs somehow?

Posted by Jason Qi (jason qi) on 2008-01-15T19:28:17.000+0000

Thanks Wil for correcting my English mistake.


I am working on a shell script that can move all tags out of tags and put them right after the closed tag.

Not finished yet, but will be ok soon.

If you need, I can do this part.


Posted by Darby Felton (darby) on 2008-01-16T08:50:39.000+0000

@[~wil]: Having a list of the affected files would be a good start toward resolving the issue. I don't know of any evidence that this specific non-compliance with DocBook DTD is responsible for the segfault I have experienced when trying to build the Simplified Chinese documentation. Actually, I think it is not related, since this issue applies to the English "master" documentation, and, as far as I know, Simplified Chinese is the only language for which the build segfaults.

@[~jason qi]: Excellent, I thank you and look forward to seeing the developments! :)

Posted by Jason Qi (jason qi) on 2008-01-16T14:30:47.000+0000

There are only two files did not follow this rule.

Zend_Currency-Useage.xml and Zend_View-Helpers-Partial.xml

However, there are still many other non-compliance with DocBook DTD rules, I think it is better for me to create another issue to list them.

Posted by Wil Sinclair (wil) on 2008-06-15T20:54:15.000+0000

Changing to comply with new IT coventions for components.

Have you found an issue?

See the Overview section for more details.


© 2006-2018 by Zend, a Rogue Wave Company. Made with by awesome contributors.

This website is built using zend-expressive and it runs on PHP 7.