Thu, 31 Aug 2017 15:17:03 +0800
merge
aoqi@0 | 1 | Usage: |
aoqi@0 | 2 | doclint [options] source-files... |
aoqi@0 | 3 | |
aoqi@0 | 4 | Options: |
aoqi@0 | 5 | -Xmsgs |
aoqi@0 | 6 | Same as -Xmsgs:all |
aoqi@0 | 7 | -Xmsgs:values |
aoqi@0 | 8 | Specify categories of issues to be checked, where 'values' |
aoqi@0 | 9 | is a comma-separated list of any of the following: |
aoqi@0 | 10 | reference show places where comments contain incorrect |
aoqi@0 | 11 | references to Java source code elements |
aoqi@0 | 12 | syntax show basic syntax errors within comments |
aoqi@0 | 13 | html show issues with HTML tags and attributes |
aoqi@0 | 14 | accessibility show issues for accessibility |
aoqi@0 | 15 | missing show issues with missing documentation |
aoqi@0 | 16 | all all of the above |
aoqi@0 | 17 | Precede a value with '-' to negate it |
aoqi@0 | 18 | Categories may be qualified by one of: |
aoqi@0 | 19 | /public /protected /package /private |
aoqi@0 | 20 | For positive categories (not beginning with '-') |
aoqi@0 | 21 | the qualifier applies to that access level and above. |
aoqi@0 | 22 | For negative categories (beginning with '-') |
aoqi@0 | 23 | the qualifier applies to that access level and below. |
aoqi@0 | 24 | If a qualifier is missing, the category applies to |
aoqi@0 | 25 | all access levels. |
aoqi@0 | 26 | For example, -Xmsgs:all,-syntax/private |
aoqi@0 | 27 | This will enable all messages, except syntax errors |
aoqi@0 | 28 | in the doc comments of private methods. |
aoqi@0 | 29 | If no -Xmsgs options are provided, the default is |
aoqi@0 | 30 | equivalent to -Xmsgs:all/protected, meaning that |
aoqi@0 | 31 | all messages are reported for protected and public |
aoqi@0 | 32 | declarations only. |
aoqi@0 | 33 | -stats |
aoqi@0 | 34 | Report statistics on the reported issues. |
aoqi@0 | 35 | -h -help --help -usage -? |
aoqi@0 | 36 | Show this message. |
aoqi@0 | 37 | |
aoqi@0 | 38 | The following javac options are also supported |
aoqi@0 | 39 | -bootclasspath, -classpath, -cp, -sourcepath, -Xmaxerrs, -Xmaxwarns |
aoqi@0 | 40 | |
aoqi@0 | 41 | To run doclint on part of a project, put the compiled classes for your |
aoqi@0 | 42 | project on the classpath (or bootclasspath), then specify the source files |
aoqi@0 | 43 | to be checked on the command line. |