The first argument to -linkoffline works when it is absolute, but not when
it is relative.

(The first argument is the URL for the root location of the external
javadoc-generated documentation you want to link to.)

For example, in the docs makefile for Merlin JAAS, you will find the
following -d and -linkoffline options and list of packages that it
documents:

   -d $(DOCSDIR)/guide/security/jaas/spec
   -linkoffline ../../../../api $(DOCSDIR)/api/

   com.sun.security.auth com.sun.security.auth.callback com.sun.security.auth.login com.sun.security.auth.module

where I have taken the liberty to simplify the -d option.

(This makefile is located at <ws>/make/docs/Makefile.)

This makefile used to work at Merlin Beta 1 but no longer works.

To test the result, when on the "com.sun.security.auth.module.NTLoginModule"
page, clicking on the "Subject" argument of the "initialize" method should
jump to the "javax.security.auth.Subject" page. Instead, it jumps to
http://javapubs.eng/api/javax/security/auth/Subject.html, given the following
generated files:

NTLoginModule page:
http://javapubs.eng/ws/docs-merlin/build/solaris-sparc/doc/guide/security/jaas/spec/com/sun/security/auth/module/NTLoginModule.html

Subject page:
http://javapubs.eng/ws/docs-merlin/build/solaris-sparc/doc/api/javax/security/auth/Subject.html

Note the relative path from the root of com/sun/security/auth/module
to the root of javax/security/auth/ is "../../../../api", the first
argument to -linkoffline.