📄 javadoc.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>4.3.9. Javadoc</title><link rel="stylesheet" href="site.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="manual.html" title="Jalopy User Manual"><link rel="up" href="printer.html" title="4.3. Printer"><link rel="previous" href="environment.html" title="4.3.8. Environment"><link rel="next" href="header.html" title="4.3.10. Header"><link rel="preface" href="dedication.html" title="Dedication"><link rel="preface" href="acknowledge.html" title="Acknowledgements"><link rel="preface" href="introduction.html" title="Introduction"><link rel="part" href="part-core.html" title="Part I. Jalopy core"><link rel="chapter" href="installation.html" title="Chapter 1. Installation"><link rel="chapter" href="build.html" title="Chapter 2. Building"><link rel="chapter" href="usage.html" title="Chapter 3. Usage"><link rel="chapter" href="settings.html" title="Chapter 4. Settings"><link rel="part" href="part-plugins.html" title="Part II. Plug-ins"><link rel="chapter" href="plugin-ant.html" title="Chapter 5. Ant Plug-in task"><link rel="chapter" href="plugin-console.html" title="Chapter 6. Console Application"><link rel="chapter" href="plugin-eclipse.html" title="Chapter 7. Eclipse Plug-in"><link rel="chapter" href="plugin-jbuilder.html" title="Chapter 8. JBuilder OpenTool"><link rel="chapter" href="plugin-jdev.html" title="Chapter 9. JDeveloper Extension"><link rel="chapter" href="plugin-jedit.html" title="Chapter 10. jEdit Plug-in"><link rel="chapter" href="plugin-netbeans.html" title="Chapter 11. NetBeans/Sun ONE Studio module"><link rel="appendix" href="dependencies.html" title="Appendix A. Library Dependencies"><link rel="appendix" href="license-bsd.html" title="Appendix B. The Jalopy BSD License"><link rel="appendix" href="license-antlr.html" title="Appendix C. ANTLR SOFTWARE RIGHTS"><link rel="appendix" href="license-apache.html" title="Appendix D. The Apache Software License, Version 1.1"><link rel="appendix" href="license-gnu.html" title="Appendix E. GNU GENERAL PUBLIC LICENSE Version 2, June 1991"><link rel="appendix" href="license-gnu-doc.html" title="Appendix F. GNU Free Documentation License Version 1.1, March 2000"><link rel="appendix" href="license-common-public.html" title="Appendix G. Common Public License Version 1.0"><link rel="appendix" href="license-sun-public.html" title="Appendix H. SUN PUBLIC LICENSE Version 1.0"><link rel="index" href="ix01.html" title="Index"><link rel="subsection" href="javadoc.html#javadoc-general" title="4.3.9.1. General"><link rel="subsection" href="javadoc.html#javadoc-generation" title="4.3.9.2. Generation"><link rel="subsection" href="javadoc.html#javadoc-templates" title="4.3.9.3. Templates"><link rel="subsection" href="javadoc.html#javadoc-tags" title="4.3.9.4. Custom Tags"> <meta name="description" content="Jalopy Java Source Code Formatter Beautifier Pretty Printer"> <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" l gen true for "http://jalopy.sf.net" r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://jalopy.sf.net" r (n 0 s 0 v 0 l 0))'> </head><body id="toppage" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="700" border="0" cellpadding="0" cellspacing="0" align="left"><tbody><tr><td><table cellpadding="0" cellspacing="0" width="100%" style="border:1px solid #336699"><tbody><tr><td height="16"></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr style="border:none"><td style="border:none"><table border="0" cellspacing="0" cellpadding="0"><tbody><tr><td class="logo">JALOPY</td><td class="sublogo" valign="bottom">Java Source Code Formatter Beautifier Pretty Printer</td></tr></tbody></table></td></tr><tr><td bgcolor="#3399cc" height="1"></td></tr><tr><td height="10"></td></tr><tr><td bgcolor="#ff8000" height="4"></td></tr><tr><td height="20" bgcolor="#336699" style="color:#ffffff;padding-left:10px"><a href="./index.html" class="navlink">Overview</a> • <a href="./download.html" class="navlink">Download</a> • <a href="./docs.html" class="navlink">Documentation</a> • <a href="./plugins.html" class="navlink">Plug-ins</a> • <a href="./links.html" class="navlink">Links</a> • <a href="./contact.html" class="navlink">Contact</a></td></tr><tr><td height="1" bgcolor="#ffffff"></td></tr></tbody></table></td></tr><tr valign="top"><td valign="top" bgcolor="#ffffff"><table border="0" cellpadding="0" cellspacing="0" width="100%"><tbody><tr><td height="20" bgcolor="#faebd7" style="padding-left:15px"><a href="./features.html" class="navlink2">Features</a> | <a href="./history.html" class="navlink2">History</a> | <a href="./manual.html" class="navlink2">Manual</a> | <a href="./faq.html" class="navlink2">FAQ</a> | <a href="./api/index.html" class="navlink2">Javadoc</a></td></tr><tr><td height="20" bgcolor="#ffffff"></td></tr><tr><td bgcolor="#eeeecc" height="17" align="right" style="font-size:10px;padding-right:3px"> This page generated: <strong>June 8 2004</strong></td></tr></tbody></table><table border="0" width="100%" cellspacing="0" cellpadding="5"><tr><td><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.3.9. Javadoc</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="environment.html">Prev</a> </td><th width="60%" align="center">4.3. Printer</th><td width="20%" align="right"> <a accesskey="n" href="header.html">Next</a></td></tr></table><hr></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="javadoc"></a>4.3.9. Javadoc</h3></div></div><div></div></div><p>Let's you control all Javadoc-related options. Refer to the<a href="http://java.sun.com/j2se/javadoc/index.html" target="_top">Javadoc home page</a>for more information about Sun's Javadoc tool.</p><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Incompatibility with Sun JDK 1.4</h3><p>Note that the Javadoc parsing for Jalopy may not work properly under SunJDK 1.4 with the Client JVM. This seems to be a problem with the garbagecollection. You may want to enable the Server JVM as a workaround.</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="javadoc-general"></a>4.3.9.1. General</h4></div></div><div></div></div><p>Controls the general handling of Javadoc comments.</p><div class="itemizedlist"><ul type="disc"><li><p><a name="javadoc-format"></a>Parse/Format comments</p><a class="indexterm" name="d0e4420"></a><a class="indexterm" name="d0e4425"></a><p>Enables the parsing of existing Javadoc comments which in turn leads to areformatting of the original comment style during the printing.</p><p>The used parser mostly supports HTML 3.2 and is not loose in a sense most browsersare these days: tags not contained in the standard will produce errors. And youshould always strive to produce well-formed HTML(it works for the <tt class="literal"><p></tt>, <tt class="literal"><li></tt>,<tt class="literal"><dd></tt>, <tt class="literal"><dt></tt> and <tt class="literal"><dir></tt>tags, but anyway).</p><p>Don't forget that the standard HTML metacharacters, such as less and greater signs(<tt class="literal"><</tt>, <tt class="literal">></tt>) or the ambersand (<tt class="literal">&</tt>), ...and the commercial "at" sign (<tt class="literal">@</tt>) needs to beescaped if not used as part of another HTML or Javadoc tag.</p><div class="table"><a name="tab-character-entities"></a><p class="title"><b>Table 4.2. Character entities</b></p><table summary="Character entities" border="0" style="border-collapse: collapse;border-top: 0.5pt solid ; border-bottom: 0.5pt solid ; border-left: 0.5pt solid ; border-right: 0.5pt solid ; "><colgroup><col><col><col><col></colgroup><thead><tr><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Symbol</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Numeric Entity</th><th style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; ">Named Entity</th><th style="border-bottom: 0.5pt solid ; ">Description</th></tr></thead><tbody><tr style="border-bottom: 0.5pt solid ; " valign="top"><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&038;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&amp</td><td style="border-bottom: 0.5pt solid ; " valign="top">Ambersand</td></tr><tr style="border-bottom: 0.5pt solid ; " valign="top"><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top"><</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&060;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&lt;</td><td style="border-bottom: 0.5pt solid ; " valign="top">Less than</td></tr><tr style="border-bottom: 0.5pt solid ; " valign="top"><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">></td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&062;</td><td style="border-right: 0.5pt solid ; border-bottom: 0.5pt solid ; " align="center" valign="top">&gt;</td><td style="border-bottom: 0.5pt solid ; " valign="top">Greater than</td></tr><tr valign="top"><td style="border-right: 0.5pt solid ; " align="center" valign="top">@</td><td style="border-right: 0.5pt solid ; " align="center" valign="top">&064;</td><td style="border-right: 0.5pt solid ; " valign="top"> </td><td style="" valign="top">Commercial "at" sign</td></tr></tbody></table></div><p></p><div class="example"><a name="ex-escape-html"></a><p class="title"><b>Example 4.145. Escaping characters in Javadoc comments</b></p><p>Don't use</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">/** * @author <a href="mailto:first.last@company.com">first.last<span class="bold"><b>@</b></span>company.com</a> */</pre></td></tr></table><p>But rather use</p><table border="0" bgcolor="#E0E0E0" class="shade"><tr><td><pre class="screen">/** * @author <a href="mailto:first.last@company.com">first.last<span class="bold"><b>&064;</b></span>company.com</a> */</pre></td></tr></table></div><p></p></li><li><p><a name="javadoc-correct"></a>Correct tags</p><a class="indexterm" name="d0e4534"></a><a class="indexterm" name="d0e4539"></a><a class="indexterm" name="d0e4542"></a><p>Enables the auto-insertion or -removal of missing and obsolete Javadoc tags (all but the <tt class="literal">@throws</tt> tag, see below) andthe correction of misspelled Javadoc tag names.</p></li><li><p><a name="javadoc-correct-throws"></a>Correct @throws tags</p><p>Controls the auto-correction for <tt class="literal">@throws</tt> tags. If enabled,Jalopy enforces a distinct <tt class="literal">@throws</tt> tag for every exceptionthrown by a method/constructor. Thus, if a method only declares to throw an<tt class="classname">IOException</tt> but throws a <tt class="classname">FileNotFoundException</tt>(which is a subclass of the former) too, Jalopy will add a declaration for the latter.</p></li></ul></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="javadoc-generation"></a>4.3.9.2. Generation</h4></div></div><div></div></div><p>Controls the auto-generation of missing Javadoc comments.</p><div class="sect4" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="javadoc-generation-selection"></a>4.3.9.2.1. Element/Level</h5></div></div><div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Element/Level</p><p>Lets you selectively enable the auto-generation of missing Javadoc comments forspecific class elements and access levels.</p></li><li><p>Include inner classes</p><p>Enables the auto-generation feature for inner classes, too. Theauto-generation does not apply to anonymous inner classes.⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -