Could someone, please, clarify situation with *-javadoc
Ville Skyttä
ville.skytta at iki.fi
Fri May 7 18:41:27 UTC 2010
On Friday 07 May 2010, Andrew Overholt wrote:
> Hi,
>
> > Sometimes *-javadoc sub-packages explicitly requires main package, and
> > sometimes - not. I'm not a java-expert, so I don't know which is
> > correct.
>
> I don't think it really matters. In some cases, sure, it would be nice
> to ensure that the package is around if someone is looking at the API
> documentation. Other times someone may only want to peruse the APIs
> without installing the implementation.
>
> Others will have different opinions so let's hear 'em.
I'm strongly against adding such dependencies if the javadocs don't actually
for some reason _really_ require the main package. I don't think I've seen a
case where such a dependency would really exist.
- Common sense and common packaging practices: don't add dependencies that
aren't really requirements for a package.
- It's convenient to be able to install lots of *-javadoc packages (nicely
crosslinked even in many cases) and configure a web server to serve them,
browse them and/or configure IDEs to access API docs from there. Main package
deps would pull in lots of cruft that isn't needed by a server with this role.
More information about the devel
mailing list