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