1 #
2 # Copyright (c) 1999, 2022, 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
26 ## tool
27
28 javac.description=read Java class and interface definitions and compile them into bytecode and class files
29
30 ## standard options
31
32 javac.opt.g=\
33 Generate all debugging info
34 javac.opt.g.none=\
35 Generate no debugging info
36 javac.opt.g.lines.vars.source=\
37 Generate only some debugging info
38 javac.opt.nowarn=\
39 Generate no warnings
40 javac.opt.verbose=\
41 Output messages about what the compiler is doing
42 javac.opt.deprecation=\
43 Output source locations where deprecated APIs are used
44 javac.opt.classpath=\
45 Specify where to find user class files and annotation processors
46 javac.opt.modulepath=\
47 Specify where to find application modules
48 javac.opt.sourcepath=\
49 Specify where to find input source files
50 javac.opt.m=\
51 Compile only the specified module(s), check timestamps
52 javac.opt.modulesourcepath=\
53 Specify where to find input source files for multiple modules
54 javac.opt.bootclasspath=\
55 Override location of bootstrap class files
56 javac.opt.system=\
57 Override location of system modules
58 javac.opt.upgrademodulepath=\
59 Override location of upgradeable modules
60 javac.opt.endorseddirs=\
61 Override location of endorsed standards path
62 javac.opt.extdirs=\
63 Override location of installed extensions
64 javac.opt.processorpath=\
65 Specify where to find annotation processors
66 javac.opt.processormodulepath=\
67 Specify a module path where to find annotation processors
68 javac.opt.processor=\
69 Names of the annotation processors to run; bypasses default discovery process
70 javac.opt.parameters=\
71 Generate metadata for reflection on method parameters
72 javac.opt.proc.none.only=\
73 Control whether annotation processing and/or compilation is done.
74 javac.opt.d=\
75 Specify where to place generated class files
76 javac.opt.sourceDest=\
77 Specify where to place generated source files
78 javac.opt.headerDest=\
79 Specify where to place generated native header files
80 javac.opt.J=\
81 Pass <flag> directly to the runtime system
82 javac.opt.encoding=\
83 Specify character encoding used by source files
84 javac.opt.profile=\
85 Check that API used is available in the specified profile.\n\
86 This option is deprecated and may be removed in a future release.
87 javac.opt.target=\
88 Generate class files suitable for the specified Java SE release. Supported releases: {0}
89 javac.opt.release=\
90 Compile for the specified Java SE release. Supported releases: {0}
91 javac.opt.source=\
92 Provide source compatibility with the specified Java SE release. Supported releases: {0}
93 javac.opt.Werror=\
94 Terminate compilation if warnings occur
95 javac.opt.A=\
96 Options to pass to annotation processors
97 javac.opt.implicit=\
98 Specify whether or not to generate class files for implicitly referenced files
99 javac.opt.pkginfo=\
100 Specify handling of package-info files
101 javac.opt.multi-release=\
102 Specify which release to use in multi-release jars
103 javac.opt.arg.class=\
104 <class>
105 javac.opt.arg.class.list=\
106 <class1>[,<class2>,<class3>...]
107 javac.opt.arg.flag=\
108 <flag>
109 javac.opt.arg.key.equals.value=\
110 key[=value]
111 javac.opt.arg.path=\
112 <path>
113 javac.opt.arg.mspath=\
114 <module-source-path>
115 javac.opt.arg.m=\
116 <module>(,<module>)*
117 javac.opt.arg.jdk=\
118 <jdk>|none
119 javac.opt.arg.dirs=\
120 <dirs>
121 javac.opt.arg.directory=\
122 <directory>
123 javac.opt.arg.encoding=\
124 <encoding>
125 javac.opt.arg.profile=\
126 <profile>
127 javac.opt.arg.release=\
128 <release>
129 javac.opt.arg.number=\
130 <number>
131 javac.opt.plugin=\
132 Name and optional arguments for a plug-in to be run
133 javac.opt.arg.plugin=\
134 "name args"
135 javac.opt.arg.multi-release=\
136 <release>
137 javac.opt.arg.default.module.for.created.files=\
138 <module-name>
139
140 ## extended options
141
142 javac.opt.maxerrs=\
143 Set the maximum number of errors to print
144 javac.opt.maxwarns=\
145 Set the maximum number of warnings to print
146 javac.opt.nogj=\
147 Don't accept generics in the language
148 javac.opt.moreinfo=\
149 Print extended information for type variables
150 javac.opt.printsearch=\
151 Print information where classfiles are searched
152 javac.opt.prompt=\
153 Stop after each error
154 javac.opt.s=\
155 Emit java sources instead of classfiles
156 javac.opt.version=\
157 Version information
158 javac.opt.arg.pathname=\
159 <pathname>
160 javac.opt.arg.file=\
161 <filename>
162 javac.opt.Xbootclasspath.p=\
163 Prepend to the bootstrap class path
164 javac.opt.Xbootclasspath.a=\
165 Append to the bootstrap class path
166 javac.opt.Xlint=\
167 Enable recommended warnings
168 javac.opt.Xlint.all=\
169 Enable all warnings
170 javac.opt.Xlint.none=\
171 Disable all warnings
172 #L10N: do not localize: -Xlint
173 javac.opt.arg.Xlint=\
174 <key>(,<key>)*
175 javac.opt.Xlint.custom=\
176 Warnings to enable or disable, separated by comma.\n\
177 Precede a key by '-' to disable the specified warning.\n\
178 Use --help-lint to see the supported keys.
179 javac.opt.Xlint.desc.auxiliaryclass=\
180 Warn about an auxiliary class that is hidden in a source file, and is used from other files.
181
182 javac.opt.Xlint.desc.cast=\
183 Warn about use of unnecessary casts.
184
185 javac.opt.Xlint.desc.classfile=\
186 Warn about issues related to classfile contents.
187
188 javac.opt.Xlint.desc.missing-explicit-ctor=\
189 Warn about missing explicit constructors in public and protected classes in exported packages.
190
191 javac.opt.Xlint.desc.deprecation=\
192 Warn about use of deprecated items.
193
194 javac.opt.Xlint.desc.dep-ann=\
195 Warn about items marked as deprecated in JavaDoc but not using the @Deprecated annotation.
196
197 javac.opt.Xlint.desc.divzero=\
198 Warn about division by constant integer 0.
199
200 javac.opt.Xlint.desc.empty=\
201 Warn about empty statement after if.
202
203 javac.opt.Xlint.desc.exports=\
204 Warn about issues regarding module exports.
205
206 javac.opt.Xlint.desc.fallthrough=\
207 Warn about falling through from one case of a switch statement to the next.
208
209 javac.opt.Xlint.desc.finally=\
210 Warn about finally clauses that do not terminate normally.
211
212 javac.opt.Xlint.desc.lossy-conversions=\
213 Warn about possible lossy conversions in compound assignment.
214
215 javac.opt.Xlint.desc.module=\
216 Warn about module system related issues.
217
218 javac.opt.Xlint.desc.migration=\
219 Warn about issues related to migration of JDK classes.
220
221 javac.opt.Xlint.desc.opens=\
222 Warn about issues regarding module opens.
223
224 javac.opt.Xlint.desc.options=\
225 Warn about issues relating to use of command line options.
226
227 javac.opt.Xlint.desc.overloads=\
228 Warn about issues regarding method overloads.
229
230 javac.opt.Xlint.desc.overrides=\
231 Warn about issues regarding method overrides.
232
233 javac.opt.Xlint.desc.path=\
234 Warn about invalid path elements on the command line.
235
236 javac.opt.Xlint.desc.processing=\
237 Warn about issues regarding annotation processing.
238
239 javac.opt.Xlint.desc.rawtypes=\
240 Warn about use of raw types.
241
242 javac.opt.Xlint.desc.removal=\
243 Warn about use of API that has been marked for removal.
244
245 javac.opt.Xlint.desc.requires-automatic=\
246 Warn about use of automatic modules in the requires clauses.
247
248 javac.opt.Xlint.desc.requires-transitive-automatic=\
249 Warn about automatic modules in requires transitive.
250
251 javac.opt.Xlint.desc.serial=\
252 Warn about Serializable classes that do not have a serialVersionUID field. \n\
253 \ Also warn about other suspect declarations in Serializable and Externalizable classes and interfaces.
254
255 javac.opt.Xlint.desc.static=\
256 Warn about accessing a static member using an instance.
257
258 javac.opt.Xlint.desc.strictfp=\
259 Warn about unnecessary use of the strictfp modifier.
260
261 javac.opt.Xlint.desc.text-blocks=\
262 Warn about inconsistent white space characters in text block indentation.
263
264 javac.opt.Xlint.desc.try=\
265 Warn about issues relating to use of try blocks (i.e. try-with-resources).
266
267 javac.opt.Xlint.desc.unchecked=\
268 Warn about unchecked operations.
269
270 javac.opt.Xlint.desc.varargs=\
271 Warn about potentially unsafe vararg methods.
272
273 javac.opt.Xlint.desc.preview=\
274 Warn about use of preview language features.
275
276 javac.opt.Xlint.desc.synchronization=\
277 Warn about synchronization attempts on instances of value-based classes.
278
279 javac.opt.Xdoclint=\
280 Enable recommended checks for problems in javadoc comments
281 # L10N: do not localize: all none
282 javac.opt.Xdoclint.subopts = \
283 (all|none|[-]<group>)[/<access>]
284
285 # L10N: do not localize: accessibility html missing reference syntax
286 # L10N: do not localize: public protected package private
287 javac.opt.Xdoclint.custom=\
288 Enable or disable specific checks for problems in javadoc comments,\n\
289 where <group> is one of accessibility, html, missing, reference, or syntax,\n\
290 and <access> is one of public, protected, package, or private.
291
292 javac.opt.Xdoclint.package.args = \
293 [-]<packages>(,[-]<package>)*
294
295 javac.opt.Xdoclint.package.desc=\
296 Enable or disable checks in specific packages. Each <package> is either the\n\
297 qualified name of a package or a package name prefix followed by '.*', which\n\
298 expands to all sub-packages of the given package. Each <package> can be prefixed\n\
299 with '-' to disable checks for the specified package or packages.
300
301 javac.opt.Xstdout=\
302 Redirect standard output
303 javac.opt.X=\
304 Print help on extra options
305 javac.opt.help=\
306 Print this help message
307 javac.opt.help.lint=\
308 Print the supported keys for -Xlint
309 javac.opt.help.lint.header=\
310 The supported keys for -Xlint are:
311 javac.opt.print=\
312 Print out a textual representation of specified types
313 javac.opt.printRounds=\
314 Print information about rounds of annotation processing
315 javac.opt.printProcessorInfo=\
316 Print information about which annotations a processor is asked to process
317 javac.opt.userpathsfirst=\
318 Search classpath and sourcepath for classes before the bootclasspath instead of after
319 javac.opt.prefer=\
320 Specify which file to read when both a source file and class file are found for an implicitly compiled class
321 javac.opt.preview=\
322 Enable preview language features. To be used in conjunction with either -source or --release.
323 javac.opt.AT=\
324 Read options and filenames from file
325 javac.opt.diags=\
326 Select a diagnostic mode
327 javac.opt.addExports=\
328 Specify a package to be considered as exported from its defining module\n\
329 to additional modules, or to all unnamed modules if <other-module> is ALL-UNNAMED.
330 javac.opt.arg.addExports=\
331 <module>/<package>=<other-module>(,<other-module>)*
332 javac.opt.addReads=\
333 Specify additional modules to be considered as required by a given module.\n\
334 <other-module> may be ALL-UNNAMED to require the unnamed module.
335 javac.opt.arg.addReads=\
336 <module>=<other-module>(,<other-module>)*
337 javac.opt.patch=\
338 Override or augment a module with classes and resources\n\
339 in JAR files or directories
340 javac.opt.arg.patch=\
341 <module>=<file>(:<file>)*
342 javac.opt.addmods=\
343 Root modules to resolve in addition to the initial modules, or all modules\n\
344 on the module path if <module> is ALL-MODULE-PATH.
345 javac.opt.arg.addmods=\
346 <module>(,<module>)*
347 javac.opt.limitmods=\
348 Limit the universe of observable modules
349 javac.opt.arg.limitmods=\
350 <module>(,<module>)*
351 javac.opt.module.version=\
352 Specify version of modules that are being compiled
353 javac.opt.arg.module.version=\
354 <version>
355 javac.opt.inherit_runtime_environment=\
356 Inherit module system configuration options from the runtime environment.
357 javac.opt.default.module.for.created.files=\
358 Fallback target module for files created by annotation processors, if none specified or inferred.
359
360 ## messages
361
362 javac.msg.usage.header=\
363 Usage: {0} <options> <source files>\n\
364 where possible options include:
365
366 javac.msg.usage=\
367 Usage: {0} <options> <source files>\n\
368 use --help for a list of possible options
369
370 javac.msg.usage.nonstandard.footer=\
371 These extra options are subject to change without notice.
372
373 javac.msg.bug=\
374 An exception has occurred in the compiler ({0}). \
375 Please file a bug against the Java compiler via the Java bug reporting page (https://bugreport.java.com) \
376 after checking the Bug Database (https://bugs.java.com) for duplicates. \
377 Include your program, the following diagnostic, and the parameters passed to the Java compiler in your report. Thank you.
378
379 javac.msg.io=\
380 \n\nAn input/output error occurred.\n\
381 Consult the following stack trace for details.\n
382
383 javac.msg.proc.annotation.uncaught.exception=\
384 \n\nAn annotation processor threw an uncaught exception.\n\
385 Consult the following stack trace for details.\n
386
387 javac.msg.plugin.uncaught.exception=\
388 \n\nA plugin threw an uncaught exception.\n\
389 Consult the following stack trace for details.\n
390
391 javac.msg.resource=\
392 \n\nThe system is out of resources.\n\
393 Consult the following stack trace for details.\n
394
395 javac.version={0} {1}
396 javac.fullVersion={0} full version "{1}"
397
398 javac.msg.parameters.output=\
399 printing javac parameters to: {0}
400
401 javac.msg.parameters.output.error=\
402 error while trying to print javac parameters to: {0}, parameters will follow: