doclint.properties revision 3831:209b0eab0e1f
1#
2# Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved.
3# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4#
5# This code is free software; you can redistribute it and/or modify it
6# under the terms of the GNU General Public License version 2 only, as
7# published by the Free Software Foundation.  Oracle designates this
8# particular file as subject to the "Classpath" exception as provided
9# by Oracle in the LICENSE file that accompanied this code.
10#
11# This code is distributed in the hope that it will be useful, but WITHOUT
12# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14# version 2 for more details (a copy is included in the LICENSE file that
15# accompanied this code).
16#
17# You should have received a copy of the GNU General Public License version
18# 2 along with this work; if not, write to the Free Software Foundation,
19# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20#
21# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22# or visit www.oracle.com if you need additional information or have any
23# questions.
24#
25
26dc.anchor.already.defined = anchor already defined: "{0}"
27dc.anchor.value.missing = no value given for anchor
28dc.attr.lacks.value = attribute lacks value
29dc.attr.not.number = attribute value is not a number
30dc.attr.not.supported.html4 = attribute not supported in HTML4: {0}
31dc.attr.not.supported.html5 = attribute not supported in HTML5: {0}
32dc.attr.obsolete = attribute obsolete: {0}
33dc.attr.obsolete.use.css = attribute obsolete, use CSS instead: {0}
34dc.attr.repeated = repeated attribute: {0}
35dc.attr.table.border.html5 = attribute border for table only accepts "" or "1", use CSS instead: {0}
36dc.attr.unknown = unknown attribute: {0}
37dc.bad.option = bad option: {0}
38dc.bad.value.for.option = bad value for option: {0} {1}
39dc.empty = no description for @{0}
40dc.entity.invalid = invalid entity &{0};
41dc.exception.not.thrown = exception not thrown: {0}
42dc.invalid.anchor = invalid name for anchor: "{0}"
43dc.invalid.param = invalid use of @param
44dc.invalid.provides = invalid use of @provides
45dc.invalid.return = invalid use of @return
46dc.invalid.throws = invalid use of @throws
47dc.invalid.uses = invalid use of @uses
48dc.invalid.uri = invalid uri: "{0}"
49dc.missing.comment = no comment
50dc.missing.param = no @param for {0}
51dc.missing.return = no @return
52dc.missing.throws = no @throws for {0}
53dc.no.alt.attr.for.image = no "alt" attribute for image
54dc.no.summary.or.caption.for.table=no summary or caption for table
55dc.param.name.not.found = @param name not found
56dc.ref.not.found = reference not found
57dc.service.not.found = service-type not found
58dc.tag.code.within.code = '{@code'} within <code>
59dc.tag.empty = empty <{0}> tag
60dc.tag.end.not.permitted = invalid end tag: </{0}>
61dc.tag.end.unexpected = unexpected end tag: </{0}>
62dc.tag.header.sequence.1 = header used out of sequence: <{0}>
63dc.tag.header.sequence.2 = header used out of sequence: <{0}>
64dc.tag.nested.not.allowed=nested tag not allowed: <{0}>
65dc.tag.not.allowed.here = tag not allowed here: <{0}>
66dc.tag.not.allowed = element not allowed in documentation comments: <{0}>
67dc.tag.not.allowed.inline.element = block element not allowed within inline element <{1}>: {0}
68dc.tag.not.allowed.inline.tag = block element not allowed within @{1}: {0}
69dc.tag.not.allowed.inline.other = block element not allowed here: {0}
70dc.tag.not.closed= element not closed: {0}
71dc.tag.p.in.pre= unexpected use of <p> inside <pre> element
72dc.tag.requires.heading = heading not found for </{0}>
73dc.tag.self.closing = self-closing element not allowed
74dc.tag.start.unmatched = end tag missing: </{0}>
75dc.tag.unknown = unknown tag: {0}
76dc.tag.not.supported = tag not supported in the generated HTML version: {0}
77dc.text.not.allowed = text not allowed in <{0}> element
78dc.type.arg.not.allowed = type arguments not allowed here
79dc.unexpected.comment=documentation comment not expected here
80dc.value.not.allowed.here='{@value}' not allowed here
81dc.value.not.a.constant=value does not refer to a constant
82
83dc.main.ioerror=IO error: {0}
84dc.main.no.files.given=No files given
85dc.main.usage=\
86Usage:\n\
87\    doclint [options] source-files...\n\
88\n\
89Options:\n\
90\  -Xmsgs  \n\
91\    Same as -Xmsgs:all\n\
92\  -Xmsgs:values\n\
93\    Specify categories of issues to be checked, where ''values''\n\
94\    is a comma-separated list of any of the following:\n\
95\      reference      show places where comments contain incorrect\n\
96\                     references to Java source code elements\n\
97\      syntax         show basic syntax errors within comments\n\
98\      html           show issues with HTML tags and attributes\n\
99\      accessibility  show issues for accessibility\n\
100\      missing        show issues with missing documentation\n\
101\      all            all of the above\n\
102\    Precede a value with ''-'' to negate it\n\
103\    Categories may be qualified by one of:\n\
104\      /public /protected /package /private\n\
105\    For positive categories (not beginning with ''-'')\n\
106\    the qualifier applies to that access level and above.\n\
107\    For negative categories (beginning with ''-'')\n\
108\    the qualifier applies to that access level and below.\n\
109\    If a qualifier is missing, the category applies to\n\
110\    all access levels.\n\
111\    For example, -Xmsgs:all,-syntax/private\n\
112\    This will enable all messages, except syntax errors\n\
113\    in the doc comments of private methods.\n\
114\    If no -Xmsgs options are provided, the default is\n\
115\    equivalent to -Xmsgs:all/protected, meaning that\n\
116\    all messages are reported for protected and public\n\
117\    declarations only. \n\
118\  -XcheckPackage:<packages>\n\
119\    Enable or disable checks in specific packages.\n\
120\    <packages> is a comma separated list of package specifiers.\n\
121\    Package specifier is either a qualified name of a package\n\
122\    or a package name prefix followed by ''.*'', which expands to\n\
123\    all sub-packages of the given package. Prefix the package specifier\n\
124\    with ''-'' to disable checks for the specified packages.\n\
125\  -stats\n\
126\    Report statistics on the reported issues.\n\
127\  -h -help --help -usage -?\n\
128\    Show this message.\n\
129\n\
130The following javac options are also supported\n\
131\  -bootclasspath, -classpath, -cp, -sourcepath, -Xmaxerrs, -Xmaxwarns\n\
132\n\
133To run doclint on part of a project, put the compiled classes for your\n\
134project on the classpath (or bootclasspath), then specify the source files\n\
135to be checked on the command line.
136