On Saturday 01 February 2003 10:58 am, Jeff Garland wrote: > >We wouldn't want to use any of the graphs from the Doxygen output > >anyway, because it wouldn't include other entities in BoostBook > >that didn't come from Doxygen. Besides, most of those are very > >easy to generate from within the XSL stylesheets. > > Just to make sure you didn't misunderstand, I'm not talking > about the generated graphs, these are xml data that represent > the 'inheritence graph', etc. I'm doing this from memory so > please correct me, but I don't recall a way to represent a > 'tree of includes' in boost-book reference specification.
You are correct. We should support this at some point in BoostBook, though I expect that the "right" way to do it would be to have Jam generate a header dependencies list for us. > >I don't know what to do about <programlisting> yet, > >though... > > Well I don't think we have to do anything with it. The reason it > is there is to provide for 'enhanced' source browsing. Specifically > you can do nice things like hyperlink from the reference documentation > to the exact source line. As an example you can look at the example > below. Pay special attention to the hyperlinks > > http://www.crystalclearsoftware.com/libraries/gdtl/gdtl_ref_guide/date_8hpp >- source.html > > One interesting use of it would be to automatically cross-reference > example files (which would wind up as a stand alone html page) that > could be referenced from various points in the reference -- sort of > an automatic TOC of examples that reference a particular class. > > But I see this as something that we could do in version 2... I would prefer to wait on this as well. I'll add these two tasks to the Wiki as soon as possible. Doug ------------------------------------------------------- This SF.NET email is sponsored by: SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See! http://www.vasoftware.com _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
