Re: [AD] Re: [AL] allegro DTD

[ Thread Index | Date Index | More lists.liballeg.org/allegro-developers Archives ]


> Elements with dashes are more human-readable.
> 
Agreed, but XML is hardly human friendly to begin with. :)

> You can't do $section->"api-section" or $section->{api-section} or
> something like that? That's bad. It's valid XML (what if there is
> namespace like in 'xml:lang'?). 
>
I don't believe it has such syntax, because the simple approach
translates the entire XML file as an array of objects using standard
variable names. It is very useful for iterating through an XML
document. Anything much more than that, and you are to use the full
featured XML class that is modelled after the standards. (The more
advanced class is probably similar to the Perl script that TF wrote.)

> Patch attached.
> 
I'll take a look at it. I don't remember noticing anything else.

One addition to the docs that could be helpful is an "added in
version" field for functions. While not that useful for stable
versions, it would be nice when looking at a manual to know that the
function is only available in the WIP vs the 'stable' version.

--
Matthew Leverton




Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/