1 #
2 # Copyright (c) 1999, 2025, 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 only mandatory 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;\n\
70 bypasses default discovery process
71 javac.opt.parameters=\
72 Generate metadata for reflection on method parameters
73 javac.opt.proc.none.only=\
74 Control whether annotation processing and/or compilation is done.
75 javac.opt.d=\
76 Specify where to place generated class files
77 javac.opt.sourceDest=\
78 Specify where to place generated source files
79 javac.opt.headerDest=\
80 Specify where to place generated native header files
81 javac.opt.J=\
82 Pass <flag> directly to the runtime system
83 javac.opt.encoding=\
84 Specify character encoding used by source files
85 javac.opt.profile=\
86 Check that API used is available in the specified profile.\n\
87 This option is deprecated and may be removed in a future release.
88 javac.opt.target=\
89 Generate class files suitable for the specified Java SE release.\n\
90 Supported releases: \n {0}
91 javac.opt.release=\
92 Compile for the specified Java SE release.\n\
93 Supported releases: \n {0}
94 javac.opt.source=\
95 Provide source compatibility with the specified Java SE release.\n\
96 Supported releases: \n {0}
97 javac.opt.Werror=\
98 Terminate compilation if any warnings occur
99 javac.opt.arg.Werror=\
100 <key>(,<key>)*
101 javac.opt.Werror.custom=\
102 Specify lint categories for which warnings should terminate compilation,\n\
103 separated by comma.\n\
104 Precede a key by ''-'' to exclude the specified category.\n\
105 Use --help-lint to see the supported keys.
106 javac.opt.A=\
107 Options to pass to annotation processors
108 javac.opt.implicit=\
109 Specify whether to generate class files for implicitly referenced files
110 javac.opt.pkginfo=\
111 Specify handling of package-info files
112 javac.opt.multi-release=\
113 Specify which release to use in multi-release jars
114 javac.opt.preview-mode=\
115 Specify whether preview mode should be enabled
116 javac.opt.arg.class=\
117 <class>
118 javac.opt.arg.class.list=\
119 <class1>[,<class2>,<class3>...]
120 javac.opt.arg.flag=\
121 <flag>
122 javac.opt.arg.key.equals.value=\
123 key[=value]
124 javac.opt.arg.path=\
125 <path>
126 javac.opt.arg.mspath=\
127 <module-source-path>
128 javac.opt.arg.m=\
129 <module>(,<module>)*
130 javac.opt.arg.jdk=\
131 <jdk>|none
132 javac.opt.arg.dirs=\
133 <dirs>
134 javac.opt.arg.directory=\
135 <directory>
136 javac.opt.arg.encoding=\
137 <encoding>
138 javac.opt.arg.profile=\
139 <profile>
140 javac.opt.arg.release=\
141 <release>
142 javac.opt.arg.number=\
143 <number>
144 javac.opt.plugin=\
145 Name and optional arguments for a plug-in to be run
146 javac.opt.arg.plugin=\
147 "name args"
148 javac.opt.arg.multi-release=\
149 <release>
150 javac.opt.arg.preview-mode=\
151 true/false
152 javac.opt.arg.default.module.for.created.files=\
153 <module-name>
154
155 ## extended options
156
157 javac.opt.maxerrs=\
158 Set the maximum number of errors to print
159 javac.opt.maxwarns=\
160 Set the maximum number of warnings to print
161 javac.opt.nogj=\
162 Don''t accept generics in the language
163 javac.opt.moreinfo=\
164 Print extended information for type variables
165 javac.opt.printsearch=\
166 Print information where classfiles are searched
167 javac.opt.prompt=\
168 Stop after each error
169 javac.opt.s=\
170 Emit java sources instead of classfiles
171 javac.opt.version=\
172 Version information
173 javac.opt.arg.pathname=\
174 <pathname>
175 javac.opt.arg.file=\
176 <filename>
177 javac.opt.Xbootclasspath.p=\
178 Prepend to the bootstrap class path
179 javac.opt.Xbootclasspath.a=\
180 Append to the bootstrap class path
181 javac.opt.Xlint=\
182 Enable recommended lint warning categories. In this release, all\n\
183 available lint warning categories are recommended.
184 javac.opt.Xlint.all=\
185 Enable all lint warning categories
186 javac.opt.Xlint.none=\
187 Disable all lint warning categories
188 #L10N: do not localize: -Xlint
189 javac.opt.arg.Xlint=\
190 <key>(,<key>)*
191 javac.opt.Xlint.custom=\
192 Lint warning categories to enable or disable, separated by comma.\n\
193 Precede a key by ''-'' to disable the specified category. Use\n\
194 ''--help-lint'' to show supported keys and which categories are\n\
195 enabled by default.
196 javac.opt.Xlint.desc.auxiliaryclass=\
197 Warn about an auxiliary class that is hidden in a source file, and is used from other files.
198
199 javac.opt.Xlint.desc.cast=\
200 Warn about use of unnecessary casts.
201
202 javac.opt.Xlint.desc.classfile=\
203 Warn about issues related to classfile contents.
204
205 javac.opt.Xlint.desc.dangling-doc-comments=\
206 Warn about dangling documentation comments, not attached to any declaration.
207
208 javac.opt.Xlint.desc.missing-explicit-ctor=\
209 Warn about missing explicit constructors in public and protected classes in exported packages.
210
211 javac.opt.Xlint.desc.deprecation=\
212 Warn about use of deprecated items.
213
214 javac.opt.Xlint.desc.dep-ann=\
215 Warn about items marked as deprecated in JavaDoc but not using the @Deprecated annotation.
216
217 javac.opt.Xlint.desc.divzero=\
218 Warn about division by constant integer 0.
219
220 javac.opt.Xlint.desc.empty=\
221 Warn about empty statement after if.
222
223 javac.opt.Xlint.desc.exports=\
224 Warn about issues regarding module exports.
225
226 javac.opt.Xlint.desc.fallthrough=\
227 Warn about falling through from one case of a switch statement to the next.
228
229 javac.opt.Xlint.desc.finally=\
230 Warn about finally clauses that do not terminate normally.
231
232 javac.opt.Xlint.desc.incubating=\
233 Warn about use of incubating modules.
234
235 javac.opt.Xlint.desc.initialization=\
236 Warn about code in identity classes that wouldn''t be allowed in early\n\
237 \ construction due to a this dependency.
238
239 javac.opt.Xlint.desc.lossy-conversions=\
240 Warn about possible lossy conversions in compound assignment and bit shift operations.
241
242 javac.opt.Xlint.desc.module=\
243 Warn about module system related issues.
244
245 javac.opt.Xlint.desc.migration=\
246 Warn about issues related to migration of JDK classes.
247
248 javac.opt.Xlint.desc.opens=\
249 Warn about issues regarding module opens.
250
251 javac.opt.Xlint.desc.options=\
252 Warn about issues relating to use of command line options.
253
254 javac.opt.Xlint.desc.output-file-clash=\
255 Warn when an output file is overwritten during compilation. This can occur, for example,\n\
256 \ on case-insensitive filesystems. Covers class files, native header files, and source files.
257
258 javac.opt.Xlint.desc.overloads=\
259 Warn about issues regarding method overloads.
260
261 javac.opt.Xlint.desc.overrides=\
262 Warn about issues regarding method overrides.
263
264 javac.opt.Xlint.desc.path=\
265 Warn about invalid path elements on the command line.
266
267 javac.opt.Xlint.desc.processing=\
268 Warn about issues regarding annotation processing.
269
270 javac.opt.Xlint.desc.rawtypes=\
271 Warn about use of raw types.
272
273 javac.opt.Xlint.desc.removal=\
274 Warn about use of API that has been marked for removal.
275
276 javac.opt.Xlint.desc.requires-automatic=\
277 Warn about use of automatic modules in the requires clauses.
278
279 javac.opt.Xlint.desc.requires-transitive-automatic=\
280 Warn about automatic modules in requires transitive.
281
282 javac.opt.Xlint.desc.serial=\
283 Warn about Serializable classes that do not have a serialVersionUID field. \n\
284 \ Also warn about other suspect declarations in Serializable and Externalizable classes and interfaces.
285
286 javac.opt.Xlint.desc.static=\
287 Warn about accessing a static member using an instance.
288
289 javac.opt.Xlint.desc.strictfp=\
290 Warn about unnecessary use of the strictfp modifier.
291
292 javac.opt.Xlint.desc.text-blocks=\
293 Warn about inconsistent white space characters in text block indentation.
294
295 javac.opt.Xlint.desc.this-escape=\
296 Warn when a constructor invokes a method that could be overriden in an external subclass.\n\
297 \ Such a method would execute before the subclass constructor completes its initialization.
298
299 javac.opt.Xlint.desc.try=\
300 Warn about issues relating to use of try blocks (i.e. try-with-resources).
301
302 javac.opt.Xlint.desc.unchecked=\
303 Warn about unchecked operations.
304
305 javac.opt.Xlint.desc.varargs=\
306 Warn about potentially unsafe vararg methods.
307
308 javac.opt.Xlint.desc.preview=\
309 Warn about use of preview language features.
310
311 javac.opt.Xlint.desc.restricted=\
312 Warn about use of restricted methods.
313
314 javac.opt.Xlint.desc.identity=\
315 Warn about uses of value-based classes where an identity class is expected.
316
317 javac.opt.Xlint.alias.of=\
318 Deprecated alias for ''{0}'' with an identical effect. Users are encouraged to use\n\
319 \ ''{0}'' instead of ''{1}'' for all current and future uses.
320
321 javac.opt.Xdoclint=\
322 Enable recommended checks for problems in javadoc comments
323 # L10N: do not localize: all none
324 javac.opt.Xdoclint.subopts = \
325 (all|none|[-]<group>)[/<access>]
326
327 # L10N: do not localize: accessibility html missing reference syntax
328 # L10N: do not localize: public protected package private
329 javac.opt.Xdoclint.custom=\
330 Enable or disable specific checks for problems in javadoc comments,\n\
331 where <group> is one of accessibility, html, missing, reference,\n\
332 or syntax, and <access> is one of public, protected, package,\n\
333 or private.
334
335 javac.opt.Xdoclint.package.args = \
336 [-]<packages>(,[-]<package>)*
337
338 javac.opt.Xdoclint.package.desc=\
339 Enable or disable checks in specific packages. Each <package> is either\n\
340 a qualified package name or a package name prefix followed by ''.*'',\n\
341 which expands to all sub-packages of the given package. Each <package>\n\
342 can be prefixed with ''-'' to disable checks for the specified package(s).
343
344 javac.opt.Xstdout=\
345 Redirect standard output
346 javac.opt.X=\
347 Print help on extra options
348 javac.opt.help=\
349 Print this help message
350 javac.opt.help.lint=\
351 Print the supported keys for -Xlint and -Werror
352 javac.opt.help.lint.header=\
353 The supported keys for -Xlint are:
354 javac.opt.help.lint.enabled.by.default=\
355 The following lint warning categories are enabled by default:
356 javac.opt.help.lint.footer=\
357 Categories and their aliases can be used interchangeably; for example, the flag\n\
358 ''-Xlint:{0},{1}'' would be redundant.
359 javac.opt.print=\
360 Print out a textual representation of specified types
361 javac.opt.printRounds=\
362 Print information about rounds of annotation processing
363 javac.opt.printProcessorInfo=\
364 Print information about which annotations a processor\n\
365 is asked to process
366 javac.opt.userpathsfirst=\
367 Search classpath and sourcepath for classes before the bootclasspath instead of after
368 javac.opt.prefer=\
369 Specify which file to read when both a source file and class file\n\
370 are found for an implicitly compiled class
371 # L10N: do not localize: ''preview''
372 javac.opt.preview=\
373 Enable preview language features.\n\
374 Also disables the ''preview'' lint category.\n\
375 To be used in conjunction with either -source or --release.
376 javac.opt.AT=\
377 Read options and filenames from file
378 javac.opt.diags=\
379 Select a diagnostic mode
380 javac.opt.addExports=\
381 Specify a package to be considered as exported from its\n\
382 defining module to additional modules, or to all unnamed modules\n\
383 if <other-module> is ALL-UNNAMED.
384 javac.opt.arg.addExports=\
385 <module>/<package>=<other-module>(,<other-module>)*
386 javac.opt.addReads=\
387 Specify additional modules to be considered as required by\n\
388 a given module; <other-module> may be ALL-UNNAMED to require\n\
389 the unnamed module.
390 javac.opt.arg.addReads=\
391 <module>=<other-module>(,<other-module>)*
392 javac.opt.patch=\
393 Override or augment a module with classes and resources\n\
394 in JAR files or directories
395 javac.opt.arg.patch=\
396 <module>=<file>(:<file>)*
397 javac.opt.addmods=\
398 Root modules to resolve in addition to the initial modules,\n\
399 or all modules on the module path if <module> is ALL-MODULE-PATH.
400 javac.opt.arg.addmods=\
401 <module>(,<module>)*
402 javac.opt.limitmods=\
403 Limit the universe of observable modules
404 javac.opt.arg.limitmods=\
405 <module>(,<module>)*
406 javac.opt.module.version=\
407 Specify version of modules that are being compiled
408 javac.opt.arg.module.version=\
409 <version>
410 javac.opt.inherit_runtime_environment=\
411 Inherit module system configuration options from the runtime environment.
412 javac.opt.default.module.for.created.files=\
413 Fallback target module for files created by annotation processors,\n\
414 if none specified or inferred.
415 javac.opt.lineDocComments=\
416 Disable support for documentation comments with lines beginning ''///''
417
418 ## messages
419
420 javac.msg.usage.header=\
421 Usage: {0} <options> <source files>\n\
422 where possible options include:
423
424 javac.msg.usage=\
425 Usage: {0} <options> <source files>\n\
426 use --help for a list of possible options
427
428 javac.msg.usage.nonstandard.footer=\
429 These extra options are subject to change without notice.
430
431 javac.msg.bug=\
432 An exception has occurred in the compiler ({0}). \
433 Please file a bug against the Java compiler via the Java bug reporting page (https://bugreport.java.com) \
434 after checking the Bug Database (https://bugs.java.com) for duplicates. \
435 Include your program, the following diagnostic, and the parameters passed to the Java compiler in your report. Thank you.
436
437 javac.msg.io=\
438 \n\nAn input/output error occurred.\n\
439 Consult the following stack trace for details.\n
440
441 javac.msg.proc.annotation.uncaught.exception=\
442 \n\nAn annotation processor threw an uncaught exception.\n\
443 Consult the following stack trace for details.\n
444
445 javac.msg.plugin.uncaught.exception=\
446 \n\nA plugin threw an uncaught exception.\n\
447 Consult the following stack trace for details.\n
448
449 javac.msg.resource=\
450 \n\nThe system is out of resources.\n\
451 Consult the following stack trace for details.\n
452
453 javac.version={0} {1}
454 javac.fullVersion={0} full version "{1}"
455
456 javac.msg.parameters.output=\
457 printing javac parameters to: {0}
458
459 javac.msg.parameters.output.error=\
460 error while trying to print javac parameters to: {0}, parameters will follow: