#2 use -linksource when generating javadoc

[Steve Magoun]

Javadoc 1.4 introduced the -linksource option, which generates an
HTML version of the source code that's linked from the javadoc.
We should use -linksource in SAND. This will give us drill-down
documentation that starts at the SAND overview root and goes all
the way to the source code.

[Eric Parker]

Logged In: YES
user_id=452458

Sounds like a great improvement. Looking forward to it.

Might be good to be able to switch this off, if you are changing
the source a lot locally and don't want the overhead. We should
give some thought to making these options switchable in our
build.

[Steve Magoun]

Logged In: YES
user_id=137219

Ant's Javadoc task doesn't support the linksource switch yet. I submitted a patch to the ant folk (under bug 11569), but somehow I doubt they'll get around to accepting it.