I was annoyed by the following warnings:

-------------------------------------8<-------------------------------------
$ ant doc
Buildfile: build.xml

doc:
     [exec] 
/home/adamm/tmp/cvs/mayfly/src/net/sourceforge/mayfly/JdbcDriver.java:110:
Warning: unable to resolve link to `JdbcDriver' for \link command
     [exec] 
/home/adamm/tmp/cvs/mayfly/src/net/sourceforge/mayfly/evaluation/what/Selected.java:22:
Warning: unable to resolve link to `What' for \link command
     [exec] 
/home/adamm/tmp/cvs/mayfly/src/net/sourceforge/mayfly/evaluation/what/Selected.java:25:
Warning: unable to resolve link to `Expression#resolve(ResultRow,
Evaluator)' for \link command

BUILD SUCCESSFUL
Total time: 1 second
------------------------------------->8-------------------------------------

So I went ahead and tried to fix these in a sane way. It appears that
Doxygen warns if link targets have no existing documentation, and none
is generated unless some Javadoc exists.

Sorry for my terse documentation, I need to spend more time reading
the code to understand how it actually works, a precursor to writing
useful documentation.

I've not played with Doxygen before, but I already like it better than
Javadoc. Very nice!

-- 
Adam Monsen

Attachment: fixdoc.patch.gz
Description: GNU Zip compressed data

-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Mayfly-general mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/mayfly-general

Reply via email to