Doxygen would need to be tweaked a bit, since it is not set up for XML I started hunting for an XML documentation engine last night. All the ones I have found so far do only one page at a time. We want it to do the same thing that Doxygen does, which is to read through all the subdirectories, dump the XML into html files and build an index.html
I'll put the Doxygen output from the C code up on my site as soon as I clean it up. It read the entire SimGear into a single 5MB html file ;-) Mike On Monday 23 December 2002 08:17, Jim Wilson wrote: > Jon Berndt <[EMAIL PROTECTED]> said: > > > > This may sound like a lame idea. I am not all that versed on xml > > > technology, > > > but it seems to me that there is a standard form for something > > > like this. In > > > the database world there is something called a "Data dictionary" > > > that works as > > > a central repository for data items, their types, default values, short > > > descriptions, long descriptions, etc. > > > > I've seen Doxygen mentioned here previously, IIRC. I can vouch for its > > effectiveness as a documentation aid. Doxygen can produce a pretty > > detailed index. This would be a start, if nothing else. I also wonder if > > there shouldn't be a way to - dump at run time - the listing you ask for > > (for instance in a debug compile, one could have this capability). > > > > Yes and I think Doxygen sounds like a good thing. To be honest I don't really > have much trouble figuring out what the properties are and if I need to know > what sets/reads them, grep works fine. But it does seem as though a central > dictionary (for lack of a better term) to which xml configs refer might yield > some benifit for new programmers as well as simplifying the coding of xml files. > Maybe even error checking. Again this is a topic I'm not familiar with...just > asking the question. > > Best, > > Jim > > _______________________________________________ > Flightgear-devel mailing list > [EMAIL PROTECTED] > http://mail.flightgear.org/mailman/listinfo/flightgear-devel > _______________________________________________ Flightgear-devel mailing list [EMAIL PROTECTED] http://mail.flightgear.org/mailman/listinfo/flightgear-devel
