langtools/src/jdk.compiler/share/classes/com/sun/tools/doclint/resources/doclint.properties
author jlahoda
Tue, 13 Jan 2015 19:13:42 +0100
changeset 28455 41245007c074
parent 25874 83c19f00452c
child 29427 44f4e6905b67
permissions -rw-r--r--
8066843: Messager.printMessage cannot print multiple errors for same source position Summary: Using a DiagnosticFlag to mark diagnostics that should be always printed even if multiple of them have the same source position. Reviewed-by: darcy, jjg, mcimadamore
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     1
#
28455
41245007c074 8066843: Messager.printMessage cannot print multiple errors for same source position
jlahoda
parents: 25874
diff changeset
     2
# Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     3
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     4
#
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     5
# This code is free software; you can redistribute it and/or modify it
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     6
# under the terms of the GNU General Public License version 2 only, as
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     7
# published by the Free Software Foundation.  Oracle designates this
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     8
# particular file as subject to the "Classpath" exception as provided
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     9
# by Oracle in the LICENSE file that accompanied this code.
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    10
#
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    11
# This code is distributed in the hope that it will be useful, but WITHOUT
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    12
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    13
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    14
# version 2 for more details (a copy is included in the LICENSE file that
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    15
# accompanied this code).
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    16
#
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    17
# You should have received a copy of the GNU General Public License version
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    18
# 2 along with this work; if not, write to the Free Software Foundation,
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    19
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    20
#
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    21
# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    22
# or visit www.oracle.com if you need additional information or have any
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    23
# questions.
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    24
#
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    25
28455
41245007c074 8066843: Messager.printMessage cannot print multiple errors for same source position
jlahoda
parents: 25874
diff changeset
    26
dc.anchor.already.defined = anchor already defined: "{0}"
15359
a73dcb8dcbae 8006224: Doclint NPE for attribute with no value
jjg
parents: 14952
diff changeset
    27
dc.anchor.value.missing = no value given for anchor
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    28
dc.attr.lacks.value = attribute lacks value
18001
e6193c14cc7e 8013405: DocLint should support <LI value="value">
jjg
parents: 15371
diff changeset
    29
dc.attr.not.number = attribute value is not a number
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    30
dc.attr.obsolete = attribute obsolete: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    31
dc.attr.obsolete.use.css = attribute obsolete, use CSS instead: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    32
dc.attr.repeated = repeated attribute: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    33
dc.attr.unknown = unknown attribute: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    34
dc.bad.option = bad option: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    35
dc.bad.value.for.option = bad value for option: {0} {1}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    36
dc.empty = no description for @{0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    37
dc.entity.invalid = invalid entity &{0};
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    38
dc.exception.not.thrown = exception not thrown: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    39
dc.invalid.anchor = invalid name for anchor: "{0}"
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    40
dc.invalid.param = invalid use of @param
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    41
dc.invalid.return = invalid use of @return
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    42
dc.invalid.throws = invalid use of @throws
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    43
dc.invalid.uri = invalid uri: "{0}"
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    44
dc.missing.comment = no comment
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    45
dc.missing.param = no @param for {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    46
dc.missing.return = no @return
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    47
dc.missing.throws = no @throws for {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    48
dc.no.alt.attr.for.image = no "alt" attribute for image
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    49
dc.no.summary.or.caption.for.table=no summary or caption for table
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    50
dc.param.name.not.found = @param name not found
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    51
dc.ref.not.found = reference not found
15366
545307ec740c 8006228: Doclint doesn't detect <code> {@code nested inline} </code>
jjg
parents: 15359
diff changeset
    52
dc.tag.code.within.code = '{@code'} within <code>
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    53
dc.tag.empty = empty <{0}> tag
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    54
dc.tag.end.not.permitted = invalid end tag: </{0}>
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    55
dc.tag.end.unexpected = unexpected end tag: </{0}>
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    56
dc.tag.header.sequence.1 = header used out of sequence: <{0}>
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    57
dc.tag.header.sequence.2 = header used out of sequence: <{0}>
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    58
dc.tag.nested.not.allowed=nested tag not allowed: <{0}>
15371
8f719dc43e1f 8006251: doclint: incorrect position for diagnostic for illegal text in tags
jjg
parents: 15366
diff changeset
    59
dc.tag.not.allowed.here = tag not allowed here: <{0}>
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    60
dc.tag.not.allowed = element not allowed in documentation comments: <{0}>
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    61
dc.tag.not.allowed.inline.element = block element not allowed within inline element <{1}>: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    62
dc.tag.not.allowed.inline.tag = block element not allowed within @{1}: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    63
dc.tag.not.allowed.inline.other = block element not allowed here: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    64
dc.tag.not.closed= element not closed: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    65
dc.tag.p.in.pre= unexpected use of <p> inside <pre> element
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    66
dc.tag.self.closing = self-closing element not allowed
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    67
dc.tag.start.unmatched = end tag missing: </{0}>
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    68
dc.tag.unknown = unknown tag: {0}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    69
dc.text.not.allowed = text not allowed in <{0}> element
20256
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 20255
diff changeset
    70
dc.type.arg.not.allowed = type arguments not allowed here
19121
c626ed0c6ab0 8020664: doclint gives incorrect warnings on normal package statements
jjg
parents: 18898
diff changeset
    71
dc.unexpected.comment=documentation comment not expected here
20255
f8be1ea20e1a 8025272: doclint needs to check for valid usage of @value tag
jjg
parents: 19121
diff changeset
    72
dc.value.not.allowed.here='{@value}' not allowed here
f8be1ea20e1a 8025272: doclint needs to check for valid usage of @value tag
jjg
parents: 19121
diff changeset
    73
dc.value.not.a.constant=value does not refer to a constant
18004
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    74
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    75
dc.main.ioerror=IO error: {0}
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    76
dc.main.no.files.given=No files given
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    77
dc.main.usage=\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    78
Usage:\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    79
\    doclint [options] source-files...\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    80
\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    81
Options:\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    82
\  -Xmsgs  \n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    83
\    Same as -Xmsgs:all\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    84
\  -Xmsgs:values\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    85
\    Specify categories of issues to be checked, where ''values''\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    86
\    is a comma-separated list of any of the following:\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    87
\      reference      show places where comments contain incorrect\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    88
\                     references to Java source code elements\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    89
\      syntax         show basic syntax errors within comments\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    90
\      html           show issues with HTML tags and attributes\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    91
\      accessibility  show issues for accessibility\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    92
\      missing        show issues with missing documentation\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    93
\      all            all of the above\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    94
\    Precede a value with ''-'' to negate it\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    95
\    Categories may be qualified by one of:\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    96
\      /public /protected /package /private\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    97
\    For positive categories (not beginning with ''-'')\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    98
\    the qualifier applies to that access level and above.\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
    99
\    For negative categories (beginning with ''-'')\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   100
\    the qualifier applies to that access level and below.\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   101
\    If a qualifier is missing, the category applies to\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   102
\    all access levels.\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   103
\    For example, -Xmsgs:all,-syntax/private\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   104
\    This will enable all messages, except syntax errors\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   105
\    in the doc comments of private methods.\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   106
\    If no -Xmsgs options are provided, the default is\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   107
\    equivalent to -Xmsgs:all/protected, meaning that\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   108
\    all messages are reported for protected and public\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   109
\    declarations only. \n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   110
\  -stats\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   111
\    Report statistics on the reported issues.\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   112
\  -h -help --help -usage -?\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   113
\    Show this message.\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   114
\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   115
The following javac options are also supported\n\
18898
0eab5f5e3d1d 8009924: some langtools tools do not accept -cp as an alias for -classpath
vromero
parents: 18004
diff changeset
   116
\  -bootclasspath, -classpath, -cp, -sourcepath, -Xmaxerrs, -Xmaxwarns\n\
18004
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   117
\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   118
To run doclint on part of a project, put the compiled classes for your\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   119
project on the classpath (or bootclasspath), then specify the source files\n\
dcf9d59b1635 8006615: [doclint] move remaining messages into resource bundle
jjg
parents: 18001
diff changeset
   120
to be checked on the command line.