Eclim provides the :JavaDocComment command which will add or update the javadoc comments for the element under the cursor.
While editing java code, if you’d like to view the javadoc of the element under
the cursor, you can run the :JavaDocPreview command which will open vim’s
preview window with the element’s javadoc content. In the preview window any
links to classes, methods, etc. in the javadoc will be highlighted and you can
follow those links by hitting <cr> on the link. You can also use
<c-o> to navigate back to the previous javadoc preview and <c-i> to
navigate forward.
Eclim supports searching of javadocs just like you would search the source code.
The only difference is that you use :JavaDocSearch instead of :JavaSearch.
The results will be displayed in a window and you can simply hit <cr> on an
entry to open it using the browser you configured via g:EclimBrowser.
The locations of the javadocs are determined via your Eclipse project’s .classpath file. For each library entry you can define a javadoc attribute that points to the base url of the javadoc (http, file, etc).
<classpathentry kind="lib" path="lib/hibernate-3.0.jar">
<attributes>
<attribute value="http://hibernate.org/hib_docs/v3/api" name="javadoc_location"/>
</attributes>
</classpathentry>
If you would like to set the javadoc url for your project’s source files, you
will instead need to set the org.eclipse.jdt.ui.project_javadoc_location
option via :ProjectSettings. Also note that the javadocs for your source
files are not generated automatically, so if you would like to use
:JavaDocSearch to open your project’s javadocs, you will first need to
generate those javadocs as described in the next section.
To run the javadoc utility on your project’s source code, you may use the :Javadoc command, which with no arguments will execute javadoc against all your project’s source code (as specified by any optional settings described below).
If you wish to run javadoc only against one or more files, you can supply the project relative paths as arguments to the :Javadoc command and only those files will be used.
Note
Please note that this command is not intended to be a full replacement for javadoc support provided by more comprehensive build tools like ant or maven.