Generate JavaDoc Dialog
This dialog invokes JavaDoc utility. The controls of the dialog box correspond to the options and tags of this utility.
Item | Description |
---|---|
Generate JavaDoc scope | Use this area to specify the subset of files, folders, packages etc. for which JavaDoc should be generated.
This scope can be the whole project, uncommitted files (when VCS is enabled), current file, custom scope etc. |
Include test sources | Select this check box to have the documentation comments for the test files included in the generated JavaDoc. |
Include JDK and library sources in -sourcepath | If this check box is selected, then paths to the JDK and library sources will be passed to the JavaDoc utility. Refer to documentation for details. |
Include link to JDK documentation | If this check box is selected, the references to the classes, packages etc. from JDK will turn into
links, which corresponds to using the -link
option of the JavaDoc utiity.
This check box is only enabled when a link to the online documentation is specified in the Documentation Paths tab of the SDK settings. Refer to JavaDoc documentation for details. |
Output directory | In this text box, specify the fully qualified path to the directory where the generated documentation
will be stored. Type the path manually or click the
Browse button to open the Select Path
dialog box where you can select the desired location.
The specified value is passed to the -d parameter of the JavaDoc utility.
If the specified directory does not exist in your system, you will be prompted to create it.
Note that unless the output directory is specified, the OK button is disabled. |
Slider | In this area, specify the visibility level of members to be included in the generated documentation.
The available options are:
|
Generate hierarchy tree | Select this check box to have the class hierarchy generated. If this check box is cleared, the
-notree parameter is passed to JavaDoc.
|
Generate navigator bar | Select this check box to have the navigator bar generated. If this check box is cleared, the
-nonavbar parameter is passed to JavaDoc.
|
Generate index | Select this check box to have the documentation index generated. If this check box is cleared, the
-noindex parameter is passed to JavaDoc.
|
Separate index per letter | Select this check box to have a separate index file for each letter generated.
If this check box is cleared, the -splitindex
parameter is passed to JavaDoc.
The check box is available only if the Generate index check box is selected. |
@use | Select this check box to have the use of class and package documented.
When selected, the check box corresponds to the -use
JavaDoc parameter.
|
@author | Select this check box to have the @author paragraphs included.
When selected, the check box corresponds to the -author
JavaDoc parameter.
|
@version | Select this check box to have the @version paragraphs included.
When selected, the check box corresponds to the -version
JavaDoc parameter.
|
@deprecated | Select this check box to have the @deprecated information included.
When the check box is cleared, the -nodeprecated parameter is passed to JavaDoc.
|
deprecated list | Select this check box to have the deprecated list generated.
When the check box is cleared, the -nodeprecatedlist parameter is passed to JavaDoc.
The check box is available only if the @deprecated check box is selected. |
Locale | In this text box, type the desired locale. |
Other command line arguments | In this text box, type additional arguments to be passed to JavaDoc. Use the command line syntax. |
Maximum heap size (Mb) | In this text box, type the maximum heap size in Mb to be used by Java VM for running JavaDoc. |
Open generated documentation in browser | Select this check box to have the generated JavaDoc automatically opened in the browser. |