[asterisk-bugs] [Asterisk 0015112]: AstXML documentation system can't handle nested enum lists

[Asterisk Bug Tracker]

The following issue has been SUBMITTED. 
====================================================================== 
https://issues.asterisk.org/view.php?id=15112 
====================================================================== 
Reported By:                lmadsen
Assigned To:                eliel
====================================================================== 
Project:                    Asterisk
Issue ID:                   15112
Category:                   Documentation
Reproducibility:            always
Severity:                   feature
Priority:                   normal
Status:                     assigned
Asterisk Version:           SVN 
Regression:                 No 
SVN Branch (only for SVN checkouts, not tarball releases): 1.6.2 
SVN Revision (number only!):  
Request Review:              
====================================================================== 
Date Submitted:             2009-05-14 11:18 CDT
Last Modified:              2009-05-14 11:18 CDT
====================================================================== 
Summary:                    AstXML documentation system can't handle nested enum
lists
Description: 
lmadsen at asterisk-releaser:~/asterisk-compile-test/1.6.2$ make
validate-docs
/usr/bin/xmlstarlet val -d doc/appdocsxml.dtd doc/core-en_US.xml
doc/core-en_US.xml:5354: element enum: validity error : Element enum
content does not follow the DTD, expecting (para | note | warning |
parameter)*, got (para enumlist )
                                        </enum>
                                               ^
doc/core-en_US.xml:5344: element enum: validity error : Element enum
content does not follow the DTD, expecting (para | note | warning |
parameter)*, got (para enumlist )
doc/core-en_US.xml - invalid
make: *** [validate-docs] Error 1



                                        <enum name="transfercapability">
                                                <para>R/W ISDN Transfer
Capability, one of:</para>
                                                <enumlist>
                                                        <enum
name="SPEECH" />
                                                        <enum
name="DIGITAL" />
                                                        <enum
name="RESTRICTED_DIGITAL" />
                                                        <enum
name="3K1AUDIO" />
                                                        <enum
name="DIGITAL_W_TONES" />
                                                        <enum name="VIDEO"
/>
                                                </enumlist>
                                        </enum>
====================================================================== 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2009-05-14 11:18 lmadsen        New Issue                                    
2009-05-14 11:18 lmadsen        Status                   new => assigned     
2009-05-14 11:18 lmadsen        Assigned To               => eliel           
2009-05-14 11:18 lmadsen        Asterisk Version          => SVN             
2009-05-14 11:18 lmadsen        Regression                => No              
2009-05-14 11:18 lmadsen        SVN Branch (only for SVN checkouts, not tarball
releases) => 1.6.2           
======================================================================