javac.properties revision 2973:0e8fa3249327
1168054Sflz#
2168054Sflz# Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved.
3168054Sflz# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4168054Sflz#
5168064Sflz# This code is free software; you can redistribute it and/or modify it
6168064Sflz# under the terms of the GNU General Public License version 2 only, as
7168064Sflz# published by the Free Software Foundation.  Oracle designates this
8168064Sflz# particular file as subject to the "Classpath" exception as provided
9168064Sflz# by Oracle in the LICENSE file that accompanied this code.
10168064Sflz#
11168064Sflz# This code is distributed in the hope that it will be useful, but WITHOUT
12168064Sflz# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13168064Sflz# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14168064Sflz# version 2 for more details (a copy is included in the LICENSE file that
15168064Sflz# accompanied this code).
16168064Sflz#
17168064Sflz# You should have received a copy of the GNU General Public License version
18168064Sflz# 2 along with this work; if not, write to the Free Software Foundation,
19168054Sflz# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20168054Sflz#
21168064Sflz# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22168054Sflz# or visit www.oracle.com if you need additional information or have any
23168064Sflz# questions.
24168131Sbmah#
25168113Smarcus
26168123Snetchild## standard options
27168064Sflz
28168054Sflzjavac.opt.g=\
29168054Sflz    Generate all debugging info
30168054Sflzjavac.opt.g.none=\
31168054Sflz    Generate no debugging info
32168077Sflzjavac.opt.g.lines.vars.source=\
33168077Sflz    Generate only some debugging info
34168126Salejavac.opt.nowarn=\
35168069Sgarga    Generate no warnings
36168113Smarcusjavac.opt.verbose=\
37168098Skrion    Output messages about what the compiler is doing
38168123Snetchildjavac.opt.deprecation=\
39168082Sgarga    Output source locations where deprecated APIs are used
40168116Sclsungjavac.opt.classpath=\
41168177Sgabor    Specify where to find user class files and annotation processors
42168072Sehauptjavac.opt.sourcepath=\
43168108Srafan    Specify where to find input source files
44168186Smatjavac.opt.bootclasspath=\
45168068Serwin    Override location of bootstrap class files
46168072Sehauptjavac.opt.Xbootclasspath.p=\
47168113Smarcus    Prepend to the bootstrap class path
48168059Sgaborjavac.opt.Xbootclasspath.a=\
49168098Skrion    Append to the bootstrap class path
50168054Sflzjavac.opt.endorseddirs=\
51168059Sgabor    Override location of endorsed standards path
52168054Sflzjavac.opt.extdirs=\
53168209Sitetcu    Override location of installed extensions
54168076Sjmelojavac.opt.processorpath=\
55168123Snetchild    Specify where to find annotation processors
56168054Sflzjavac.opt.processor=\
57168055Spav    Names of the annotation processors to run; bypasses default discovery process
58168055Spavjavac.opt.parameters=\
59168177Sgabor    Generate metadata for reflection on method parameters
60168098Skrionjavac.opt.proc.none.only=\
61168055Spav    Control whether annotation processing and/or compilation is done.
62168161Sphilipjavac.opt.d=\
63168054Sflz    Specify where to place generated class files
64168208Sitetcujavac.opt.sourceDest=\
65168068Serwin    Specify where to place generated source files
66168068Serwinjavac.opt.headerDest=\
67168177Sgabor    Specify where to place generated native header files
68168113Smarcusjavac.opt.J=\
69168186Smat    Pass <flag> directly to the runtime system
70168055Spavjavac.opt.encoding=\
71168098Skrion    Specify character encoding used by source files
72168100Smnagjavac.opt.profile=\
73168123Snetchild    Check that API used is available in the specified profile
74168177Sgaborjavac.opt.target=\
75168134Snork    Generate class files for specific VM version
76168084Sehauptjavac.opt.release=\
77168054Sflz    Compile for a specific VM version. Supported targets: {0}
78168098Skrionjavac.opt.source=\
79168108Srafan    Provide source compatibility with specified release
80168098Skrionjavac.opt.Werror=\
81168098Skrion    Terminate compilation if warnings occur
82168098Skrionjavac.opt.A=\
83168055Spav    Options to pass to annotation processors
84168068Serwinjavac.opt.implicit=\
85168125Stdb    Specify whether or not to generate class files for implicitly referenced files
86168186Smatjavac.opt.pkginfo=\
87168061Sahze    Specify handling of package-info files
88168069Sgargajavac.opt.arg.class=\
89168054Sflz    <class>
90168054Sflzjavac.opt.arg.class.list=\
91168064Sflz    <class1>[,<class2>,<class3>...]
92168064Sflzjavac.opt.arg.flag=\
93168054Sflz    <flag>
94168055Spavjavac.opt.arg.key.equals.value=\
95168055Spav    key[=value]
96168055Spavjavac.opt.arg.path=\
97168055Spav    <path>
98168055Spavjavac.opt.arg.dirs=\
99168055Spav    <dirs>
100168057Sahzejavac.opt.arg.directory=\
101168055Spav    <directory>
102168125Stdbjavac.opt.arg.encoding=\
103168208Sitetcu    <encoding>
104168125Stdbjavac.opt.arg.profile=\
105168108Srafan    <profile>
106168108Srafanjavac.opt.arg.release=\
107168186Smat    <release>
108168186Smatjavac.opt.arg.release=\
109168068Serwin    <release>
110168068Serwinjavac.opt.arg.number=\
111168072Sehaupt    <number>
112168072Sehauptjavac.opt.plugin=\
113168068Serwin    Name and optional arguments for a plug-in to be run
114168059Sgaborjavac.opt.arg.plugin=\
115168068Serwin    "name args"
116168068Serwin
117168068Serwin## extended options
118168059Sgabor
119168098Skrionjavac.opt.maxerrs=\
120168098Skrion    Set the maximum number of errors to print
121168054Sflzjavac.opt.maxwarns=\
122168054Sflz    Set the maximum number of warnings to print
123168054Sflzjavac.opt.nogj=\
124168054Sflz    Don't accept generics in the language
125168069Sgargajavac.opt.moreinfo=\
126168069Sgarga    Print extended information for type variables
127168069Sgargajavac.opt.printflat=\
128168069Sgarga    Print abstract syntax tree after inner class conversion
129168123Snetchildjavac.opt.printsearch=\
130168123Snetchild    Print information where classfiles are searched
131168134Snorkjavac.opt.prompt=\
132168134Snork    Stop after each error
133168134Snorkjavac.opt.retrofit=\
134168134Snork    Retrofit existing classfiles with generic types
135168134Snorkjavac.opt.s=\
136168098Skrion    Emit java sources instead of classfiles
137168098Skrionjavac.opt.scramble=\
138168098Skrion    Scramble private identifiers in bytecode
139168098Skrionjavac.opt.scrambleall=\
140168098Skrion    Scramble package visible identifiers in bytecode
141168098Skrionjavac.opt.version=\
142168098Skrion    Version information
143168098Skrionjavac.opt.arg.pathname=\
144168209Sitetcu    <pathname>
145168209Sitetcujavac.opt.arg.file=\
146168113Smarcus    <filename>
147168113Smarcusjavac.opt.Xlint=\
148168113Smarcus    Enable recommended warnings
149168113Smarcusjavac.opt.Xlint.all=\
150168186Smat    Enable all warnings
151168186Smatjavac.opt.Xlint.none=\
152168076Sjmelo    Disable all warnings
153168076Sjmelo#L10N: do not localize: -Xlint
154168123Snetchildjavac.opt.Xlint.subopts=\
155168123Snetchild    -Xlint:key,...
156168126Salejavac.opt.Xlint.suboptlist=\n\
157168126Sale\        Warnings to enable or disable, separated by comma.\n\
158168084Sehaupt\        Precede a key by '-' to disable the specified warning.\n\
159168084Sehaupt\        Supported keys are:
160168054Sflzjavac.opt.Xlint.desc.auxiliaryclass=\
161168055Spav    Warn about an auxiliary class that is hidden in a source file, and is used from other files.
162168055Spav
163168055Spavjavac.opt.Xlint.desc.cast=\
164168054Sflz    Warn about use of unnecessary casts.
165168161Sphilip
166168161Sphilipjavac.opt.Xlint.desc.classfile=\
167168108Srafan    Warn about issues related to classfile contents.
168168108Srafan
169168123Snetchildjavac.opt.Xlint.desc.deprecation=\
170168123Snetchild    Warn about use of deprecated items.
171168209Sitetcu
172168209Sitetcujavac.opt.Xlint.desc.dep-ann=\
173168054Sflz    Warn about items marked as deprecated in JavaDoc but not using the @Deprecated annotation.
174
175javac.opt.Xlint.desc.divzero=\
176    Warn about division by constant integer 0.
177
178javac.opt.Xlint.desc.empty=\
179    Warn about empty statement after if.
180
181javac.opt.Xlint.desc.fallthrough=\
182    Warn about falling through from one case of a switch statement to the next.
183
184javac.opt.Xlint.desc.finally=\
185    Warn about finally clauses that do not terminate normally.
186
187javac.opt.Xlint.desc.options=\
188    Warn about issues relating to use of command line options.
189
190javac.opt.Xlint.desc.overloads=\
191    Warn about issues regarding method overloads.
192
193javac.opt.Xlint.desc.overrides=\
194    Warn about issues regarding method overrides.
195
196javac.opt.Xlint.desc.path=\
197    Warn about invalid path elements on the command line.
198
199javac.opt.Xlint.desc.processing=\
200    Warn about issues regarding annotation processing.
201
202javac.opt.Xlint.desc.rawtypes=\
203    Warn about use of raw types.
204
205javac.opt.Xlint.desc.serial=\
206    Warn about Serializable classes that do not provide a serial version ID.
207
208javac.opt.Xlint.desc.static=\
209    Warn about accessing a static member using an instance.
210
211javac.opt.Xlint.desc.sunapi=\
212    Warn about proprietary API that may be removed in a future release.
213
214javac.opt.Xlint.desc.try=\
215    Warn about issues relating to use of try blocks (i.e. try-with-resources).
216
217javac.opt.Xlint.desc.unchecked=\
218    Warn about unchecked operations.
219
220javac.opt.Xlint.desc.varargs=\
221    Warn about potentially unsafe vararg methods
222
223javac.opt.Xdoclint=\
224    Enable recommended checks for problems in javadoc comments
225# L10N: do not localize: all none
226javac.opt.Xdoclint.subopts = \
227    (all|none|[-]<group>)[/<access>]
228
229# L10N: do not localize: accessibility html missing reference syntax
230# L10N: do not localize: public protected package private
231javac.opt.Xdoclint.custom=\n\
232\        Enable or disable specific checks for problems in javadoc comments,\n\
233\        where <group> is one of accessibility, html, missing, reference, or syntax,\n\
234\        and <access> is one of public, protected, package, or private.
235
236javac.opt.Xdoclint.package.args = \
237    ([-]<packages>)
238
239javac.opt.Xdoclint.package.desc=\n\
240\        Enable or disable checks in specific packages. <packages> is a comma separated\n\
241\        list of package specifiers. Package specifier is either a qualified name of a package\n\
242\        or a package name prefix followed by '.*', which expands to all sub-packages of\n\
243\        the given package. Prefix the package specifier with '-' to disable checks for\n\
244\        the specified packages.
245
246javac.opt.Xstdout=\
247    Redirect standard output
248javac.opt.X=\
249    Print a synopsis of nonstandard options
250javac.opt.help=\
251    Print a synopsis of standard options
252javac.opt.print=\
253    Print out a textual representation of specified types
254javac.opt.printRounds=\
255    Print information about rounds of annotation processing
256javac.opt.printProcessorInfo=\
257    Print information about which annotations a processor is asked to process
258javac.opt.userpathsfirst=\
259    Search classpath and sourcepath for classes before the bootclasspath instead of after
260javac.opt.prefer=\
261    Specify which file to read when both a source file and class file are found for an implicitly compiled class
262javac.opt.AT=\
263    Read options and filenames from file
264javac.opt.diags=\
265    Select a diagnostic mode
266
267## errors
268
269javac.err.empty.A.argument=\
270    -A requires an argument; use ''-Akey'' or ''-Akey=value''
271javac.err.invalid.arg=\
272    invalid argument: {0}
273javac.err.invalid.A.key=\
274     key in annotation processor option ''{0}'' is not a dot-separated sequence of identifiers
275javac.err.invalid.flag=\
276    invalid flag: {0}
277javac.err.profile.bootclasspath.conflict=\
278    profile and bootclasspath options cannot be used together
279javac.err.invalid.profile=\
280    invalid profile: {0}
281javac.err.invalid.target=\
282    invalid target release: {0}
283javac.err.no.source.files=\
284    no source files
285javac.err.no.source.files.classes=\
286    no source files or class names
287javac.err.req.arg=\
288    {0} requires an argument
289javac.err.invalid.source=\
290    invalid source release: {0}
291javac.err.error.writing.file=\
292    error writing {0}; {1}
293javac.warn.source.target.conflict=\
294    source release {0} requires target release {1}
295javac.warn.target.default.source.conflict=\
296    target release {0} conflicts with default source release {1}
297javac.warn.profile.target.conflict=\
298    profile {0} is not valid for target release {1}
299javac.err.dir.not.found=\
300    directory not found: {0}
301javac.err.file.not.found=\
302    file not found: {0}
303javac.err.file.not.directory=\
304    not a directory: {0}
305javac.err.file.not.file=\
306    not a file: {0}
307
308## messages
309
310javac.msg.usage.header=\
311Usage: {0} <options> <source files>\n\
312where possible options include:
313
314javac.msg.usage=\
315    Usage: {0} <options> <source files>\n\
316    use -help for a list of possible options
317
318javac.msg.usage.nonstandard.footer=\
319These options are non-standard and subject to change without notice.
320
321javac.msg.bug=\
322An exception has occurred in the compiler ({0}). \
323Please file a bug at the Java Bug Database (http://bugreport.java.com/bugreport/) \
324after checking the database for duplicates. \
325Include your program and the following diagnostic in your report.  Thank you.
326
327javac.msg.io=\
328\n\nAn input/output error occurred.\n\
329Consult the following stack trace for details.\n
330
331javac.msg.proc.annotation.uncaught.exception=\
332\n\nAn annotation processor threw an uncaught exception.\n\
333Consult the following stack trace for details.\n
334
335javac.msg.plugin.uncaught.exception=\
336\n\nA plugin threw an uncaught exception.\n\
337Consult the following stack trace for details.\n
338
339javac.msg.resource=\
340\n\nThe system is out of resources.\n\
341Consult the following stack trace for details.\n
342
343javac.version={0} {1}
344javac.fullVersion={0} full version "{1}"
345
346javac.err.release.bootclasspath.conflict=\
347    option {0} cannot be used together with -release
348
349javac.err.unsupported.release.version=\
350    release version {0} not supported
351
352javac.err.release.not.standard.file.manager=\
353    -release option specified, but the provided JavaFileManager is not a StandardJavaFileManager.
354