[sword-devel] Sword Docs
Troy A. Griffitts
scribe at crosswire.org
Sat Aug 30 15:18:14 MST 2008
The reason I ask is because on VerseKey the builtin stuff should now be
gone and the new VerseMgr is now showing up. Also noticed that the
lowest level drivers are not showing up (eg., RawGenBook, zText, etc.).
Maybe there is a config file somewhere that lists which classes should
be documented, or maybe how deep to go in the directory hierarchy? Not
Greg Hellings wrote:
> On Sat, Aug 30, 2008 at 5:36 AM, Troy A. Griffitts <scribe at crosswire.org> wrote:
>> Thanks Greg. Looks nice. I don't think that is current SVN though.
> svn co http://www.crosswire.org/svn/sword/trunk
> That's the current SVN trunk, revision 2192, which I pulled fresh for
> that task. Are you working off of a branch at current that would be
> more up-to-date?
>> Greg Hellings wrote:
>>> I've been rather frantic in scrambling around trying to locate source
>>> files and class hierarchies and inheritance information in the
>>> library. I remember someone used to have a nice set of documentation
>>> for the system up on the Crosswire server that had been generated with
>>> Doxygen, but I believe it was out of date at the time, which was going
>>> on a few years back already (1.5.8 or 1.5.7 -- something like that).
>>> As such, I've dropped out some Doxygen HTML docs from the current
>>> source tree in SVN and placed them in
>>> http://www.crosswire.org/~ghellings/svnclassdocs/. If there's
>>> something nagging at you about the format of them, etc, I can try to
>>> fiddle with the Doxygen configuration file to see if it can be
>>> modified. I elected to have it output the graphs, etc, using UML-like
>>> syntax, seeing as it will probably be the best understood format for
>>> such diagrams.
>>> One useful side-effect of having the documentation is that it can be
>>> an easy reference for which methods and members are NOT documented
>>> (and probably should be). Essentially, any method or member which is
>>> not a link in the class page, is an undocumented (or possibly has
>>> non-doxygen-formatted documentation) portion of the engine.
>>> Documentation is often a place where newcomers to a project can fit in
>>> well while they learn the ins and outs of the code.
>>> sword-devel mailing list: sword-devel at crosswire.org
>>> Instructions to unsubscribe/change your settings at above page
>> sword-devel mailing list: sword-devel at crosswire.org
>> Instructions to unsubscribe/change your settings at above page
> sword-devel mailing list: sword-devel at crosswire.org
> Instructions to unsubscribe/change your settings at above page
More information about the sword-devel