1 #
  2 # Copyright (c) 1999, 2026, 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)
 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.lossy-conversions=\
236     Warn about possible lossy conversions in compound assignment and bit shift operations.
237 
238 javac.opt.Xlint.desc.module=\
239     Warn about module system related issues.
240 
241 javac.opt.Xlint.desc.opens=\
242     Warn about issues regarding module opens.
243 
244 javac.opt.Xlint.desc.options=\
245     Warn about issues relating to use of command line options.
246 
247 javac.opt.Xlint.desc.output-file-clash=\
248     Warn when an output file is overwritten during compilation. This can occur, for example,\n\
249 \                         on case-insensitive filesystems. Covers class files, native header files, and source files.
250 
251 javac.opt.Xlint.desc.overloads=\
252     Warn about issues regarding method overloads.
253 
254 javac.opt.Xlint.desc.overrides=\
255     Warn about issues regarding method overrides.
256 
257 javac.opt.Xlint.desc.path=\
258     Warn about invalid path elements on the command line.
259 
260 javac.opt.Xlint.desc.processing=\
261     Warn about issues regarding annotation processing.
262 
263 javac.opt.Xlint.desc.rawtypes=\
264     Warn about use of raw types.
265 
266 javac.opt.Xlint.desc.removal=\
267     Warn about use of API that has been marked for removal.
268 
269 javac.opt.Xlint.desc.requires-automatic=\
270     Warn about use of automatic modules in the requires clauses.
271 
272 javac.opt.Xlint.desc.requires-transitive-automatic=\
273     Warn about automatic modules in requires transitive.
274 
275 javac.opt.Xlint.desc.serial=\
276     Warn about Serializable classes that do not have a serialVersionUID field. \n\
277 \                         Also warn about other suspect declarations in Serializable and Externalizable classes and interfaces.
278 
279 javac.opt.Xlint.desc.static=\
280     Warn about accessing a static member using an instance.
281 
282 javac.opt.Xlint.desc.strictfp=\
283     Warn about unnecessary use of the strictfp modifier.
284 
285 javac.opt.Xlint.desc.text-blocks=\
286     Warn about inconsistent white space characters in text block indentation.
287 
288 javac.opt.Xlint.desc.this-escape=\
289     Warn when a constructor invokes a method that could be overriden in an external subclass.\n\
290 \                         Such a method would execute before the subclass constructor completes its initialization.
291 
292 javac.opt.Xlint.desc.try=\
293     Warn about issues relating to use of try blocks (i.e. try-with-resources).
294 
295 javac.opt.Xlint.desc.unchecked=\
296     Warn about unchecked operations.
297 
298 javac.opt.Xlint.desc.varargs=\
299     Warn about potentially unsafe vararg methods.
300 
301 javac.opt.Xlint.desc.preview=\
302     Warn about use of preview language features.
303 
304 javac.opt.Xlint.desc.restricted=\
305     Warn about use of restricted methods.
306 
307 javac.opt.Xlint.desc.identity=\
308     Warn about uses of value-based classes where an identity class is expected.
309 
310 javac.opt.Xlint.alias.of=\
311     Deprecated alias for ''{0}'' with an identical effect. Users are encouraged to use\n\
312 \                         ''{0}'' instead of ''{1}'' for all current and future uses.
313 
314 javac.opt.Xdoclint=\
315     Enable recommended checks for problems in javadoc comments
316 # L10N: do not localize: all none
317 javac.opt.Xdoclint.subopts = \
318     (all|none|[-]<group>)[/<access>]
319 
320 # L10N: do not localize: accessibility html missing reference syntax
321 # L10N: do not localize: public protected package private
322 javac.opt.Xdoclint.custom=\
323     Enable or disable specific checks for problems in javadoc comments,\n\
324     where <group> is one of accessibility, html, missing, reference,\n\
325     or syntax, and <access> is one of public, protected, package,\n\
326     or private.
327 
328 javac.opt.Xdoclint.package.args = \
329     [-]<packages>(,[-]<package>)*
330 
331 javac.opt.Xdoclint.package.desc=\
332     Enable or disable checks in specific packages. Each <package> is either\n\
333     a qualified package name or a package name prefix followed by ''.*'',\n\
334     which expands to all sub-packages of the given package. Each <package>\n\
335     can be prefixed with ''-'' to disable checks for the specified package(s).
336 
337 javac.opt.Xstdout=\
338     Redirect standard output
339 javac.opt.X=\
340     Print help on extra options
341 javac.opt.help=\
342     Print this help message
343 javac.opt.help.lint=\
344     Print the supported keys for -Xlint and -Werror
345 javac.opt.help.lint.header=\
346     The supported keys for -Xlint are:
347 javac.opt.help.lint.enabled.by.default=\
348     The following lint warning categories are enabled by default:
349 javac.opt.help.lint.footer=\
350     Categories and their aliases can be used interchangeably; for example, the flag\n\
351     ''-Xlint:{0},{1}'' would be redundant.
352 javac.opt.print=\
353     Print out a textual representation of specified types
354 javac.opt.printRounds=\
355     Print information about rounds of annotation processing
356 javac.opt.printProcessorInfo=\
357     Print information about which annotations a processor\n\
358     is asked to process
359 javac.opt.userpathsfirst=\
360     Search classpath and sourcepath for classes before the bootclasspath instead of after
361 javac.opt.prefer=\
362     Specify which file to read when both a source file and class file\n\
363     are found for an implicitly compiled class
364 # L10N: do not localize: ''preview''
365 javac.opt.preview=\
366     Enable preview language features.\n\
367     Also disables the ''preview'' lint category.\n\
368     To be used in conjunction with either -source or --release.
369 javac.opt.AT=\
370     Read options and filenames from file
371 javac.opt.diags=\
372     Select a diagnostic mode
373 javac.opt.addExports=\
374     Specify a package to be considered as exported from its\n\
375     defining module to additional modules, or to all unnamed modules\n\
376     if <other-module> is ALL-UNNAMED.
377 javac.opt.arg.addExports=\
378     <module>/<package>=<other-module>(,<other-module>)*
379 javac.opt.addReads=\
380     Specify additional modules to be considered as required by\n\
381     a given module; <other-module> may be ALL-UNNAMED to require\n\
382     the unnamed module.
383 javac.opt.arg.addReads=\
384     <module>=<other-module>(,<other-module>)*
385 javac.opt.patch=\
386     Override or augment a module with classes and resources\n\
387     in JAR files or directories
388 javac.opt.arg.patch=\
389     <module>=<file>(:<file>)*
390 javac.opt.addmods=\
391     Root modules to resolve in addition to the initial modules,\n\
392     or all modules on the module path if <module> is ALL-MODULE-PATH.
393 javac.opt.arg.addmods=\
394     <module>(,<module>)*
395 javac.opt.limitmods=\
396     Limit the universe of observable modules
397 javac.opt.arg.limitmods=\
398     <module>(,<module>)*
399 javac.opt.module.version=\
400     Specify version of modules that are being compiled
401 javac.opt.arg.module.version=\
402     <version>
403 javac.opt.inherit_runtime_environment=\
404     Inherit module system configuration options from the runtime environment.
405 javac.opt.default.module.for.created.files=\
406     Fallback target module for files created by annotation processors,\n\
407     if none specified or inferred.
408 javac.opt.lineDocComments=\
409     Disable support for documentation comments with lines beginning ''///''
410 
411 ## messages
412 
413 javac.msg.usage.header=\
414 Usage: {0} <options> <source files>\n\
415 where possible options include:
416 
417 javac.msg.usage=\
418     Usage: {0} <options> <source files>\n\
419     use --help for a list of possible options
420 
421 javac.msg.usage.nonstandard.footer=\
422 These extra options are subject to change without notice.
423 
424 javac.msg.bug=\
425 An exception has occurred in the compiler ({0}). \
426 Please file a bug against the Java compiler via the Java bug reporting page (https://bugreport.java.com) \
427 after checking the Bug Database (https://bugs.java.com) for duplicates. \
428 Include your program, the following diagnostic, and the parameters passed to the Java compiler in your report. Thank you.
429 
430 javac.msg.io=\
431 \n\nAn input/output error occurred.\n\
432 Consult the following stack trace for details.\n
433 
434 javac.msg.proc.annotation.uncaught.exception=\
435 \n\nAn annotation processor threw an uncaught exception.\n\
436 Consult the following stack trace for details.\n
437 
438 javac.msg.plugin.uncaught.exception=\
439 \n\nA plugin threw an uncaught exception.\n\
440 Consult the following stack trace for details.\n
441 
442 javac.msg.resource=\
443 \n\nThe system is out of resources.\n\
444 Consult the following stack trace for details.\n
445 
446 javac.version={0} {1}
447 javac.fullVersion={0} full version "{1}"
448 
449 javac.msg.parameters.output=\
450 printing javac parameters to: {0}
451 
452 javac.msg.parameters.output.error=\
453 error while trying to print javac parameters to: {0}, parameters will follow:
--- EOF ---