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

[Asterisk Bug Tracker]

The following issue has been RESOLVED. 
====================================================================== 
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:                     resolved
Asterisk Version:           SVN 
Regression:                 No 
SVN Branch (only for SVN checkouts, not tarball releases): 1.6.2 
SVN Revision (number only!):  
Request Review:              
Resolution:                 fixed
Fixed in Version:           
====================================================================== 
Date Submitted:             2009-05-14 11:18 CDT
Last Modified:              2009-05-15 08:23 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>
====================================================================== 

---------------------------------------------------------------------- 
 (0104815) svnbot (reporter) - 2009-05-15 08:23
 https://issues.asterisk.org/view.php?id=15112#c104815 
---------------------------------------------------------------------- 
Repository: asterisk
Revision: 194635

U   trunk/doc/appdocsxml.dtd
U   trunk/main/xmldoc.c

------------------------------------------------------------------------
r194635 | eliel | 2009-05-15 08:23:45 -0500 (Fri, 15 May 2009) | 16 lines

Allow to specify an enumlist inside an enum.

It was not possible to use an enumlist inside an enum:
<enumlist>
   <enum name="aa">
      <enumlist>
         ...
      </enumlist>
   </enum>
</enumlist>
Now we will be able to insert as many levels as we want.

(closes issue https://issues.asterisk.org/view.php?id=15112)
Reported by: lmadsen


------------------------------------------------------------------------

http://svn.digium.com/view/asterisk?view=rev&revision=194635 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2009-05-15 08:23 svnbot         Note Added: 0104815                          
2009-05-15 08:23 svnbot         Status                   assigned => resolved
2009-05-15 08:23 svnbot         Resolution               open => fixed       
======================================================================