illumos gate

If, as discussed in #13315, we move to publishing javadoc rather than packaging it, we should make sure it's reasonably error free.

Specifically, for libdtrace_jni:

@inheritDoc should be inside {}

The docs.sun.com URLs don't work any more; we should use http://dtrace.org/guide/ (also in the Quick Start Guide)

It's not Solaris

And there are some typos that cause javadoc to complain

It is not the intention of this bug to fix all the warnings, that are usually related to missing javadoc comments for parameters