Options.properties revision 1790:785843878cf7
1#
2# Copyright (c) 2010, 2013, 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#
25option.error.invalid.option="{0}" is not a recognized option. Use "{1}" or "{2}" to see a list of all supported options.
26
27nashorn.options = Usage: jjs [option=value]* [filename.js]+ [-- options...]\n\
28                \n\
29                Valid options are:
30
31#
32# Localized meta descriptions
33#
34nashorn.options.param = param
35nashorn.options.default = default
36
37#
38# Which option is "help".
39#
40nashorn.options.help.key = nashorn.option.help
41
42#
43# Which option is "xhelp".
44#
45nashorn.options.xhelp.key = nashorn.option.xhelp
46
47#
48# Which option is "D".
49#
50nashorn.options.D.key = nashorn.option.D
51
52##
53## Grammar: at least short or long form. Arguments are optional, in that case they are given as
54##
55## params - a description of the parameters for command line usage
56## name - the name of the option, e.g. "--long-name"
57## short_name - the short name of the option, e.g. "-l"
58## type - the type of the option, currently allowed: boolean, integer, string, log, timezone. defaults to boolean if left out
59## is_undocumented - should this option never appear in the online help. defaults to no.
60## desc - description of what the option does
61## default - default value of the option. e.g. debug.lines is true by default. Not set means option not available by default
62## dependency - does this arg imply another arg.
63## confict - does this arg conflict with another arg e.g trace && instrument
64## value_next_arg - is the opton's value passed as next argument in command line?
65##
66## At least short_name or name needs to be in place for an argument descriptor to be valid.
67
68nashorn.option.help = {                       \
69    name="-help",                             \
70    short_name="-h",                          \
71    desc="Print help for command line flags." \
72}
73
74nashorn.option.xhelp = {                               \
75    name="-xhelp",                                     \
76    is_undocumented=true,                              \
77    desc="Print extended help for command line flags." \
78}
79
80nashorn.option.anonymous.classes = {                      \
81    name="--anonymous-classes",                           \
82    is_undocumented=true,                                 \
83    params=[auto|true|false],                             \
84    default=auto,                                         \
85    type=string,                                          \
86    desc="Use VM anonymous classes for compiled scripts." \
87}
88
89nashorn.option.class.cache.size ={                            \
90    name="--class-cache-size",                                \
91    short_name="-ccs",                                        \
92    desc="Size of the Class cache size per global scope.",    \
93    is_undocumented=true,                                     \
94    type=Integer,                                             \
95    default=50                                                \
96}
97
98nashorn.option.classpath ={                                   \
99    name="-classpath",                                        \
100    short_name="-cp",                                         \
101    desc="-cp path. Specify where to find user class files.", \
102    value_next_arg=true,                                      \
103    type=String                                               \
104}
105
106nashorn.option.compile.only = {       \
107    name="--compile-only",            \
108    short_name="-co",                 \
109    is_undocumented=true,             \
110    desc="Compile without running.",  \
111    type=Boolean                      \
112}
113
114nashorn.option.const.as.var = {          \
115    name="--const-as-var",               \
116    is_undocumented=true,                \
117    desc="Replace 'const' with 'var'.",  \
118    type=Boolean                         \
119}
120
121nashorn.option.d = {                                             \
122    name="--dump-debug-dir",                                     \
123    short_name="-d",                                             \
124    is_undocumented=true,                                        \
125    params="<path>",                                             \
126    desc="specify a destination directory to dump source and class files.", \
127    type=String                                                  \
128}
129
130nashorn.option.D = {                                                          \
131    name="-D",                                                                \
132    desc="-Dname=value. Set a system property. This option can be repeated.", \
133    type=String                                                               \
134}
135
136nashorn.option.debug.lines = {                          \
137    name="--debug-lines",                               \
138    is_undocumented=true,                               \
139    desc="Generate line number table in .class files.", \
140    default=true                                        \
141}
142
143nashorn.option.debug.locals = {                           \
144    name="--debug-locals",                                \
145    is_undocumented=true,                                 \
146    desc="Generate local variable table in .class files." \
147}
148
149nashorn.option.debug.scopes = {                                 \
150    name="--debug-scopes",                                      \
151    is_undocumented=true,                                       \
152    desc="Put all variables in scopes to make them debuggable." \
153}
154
155nashorn.option.doe = {                   \
156    name="-dump-on-error",               \
157    short_name="-doe",                   \
158    desc="Dump a stack trace on errors." \
159}
160
161nashorn.option.empty.statements = {          \
162    name="--empty-statements",               \
163    is_undocumented=true,                    \
164    desc="Preserve empty statements in AST." \
165}
166
167nashorn.option.early.lvalue.error = {                                      \
168    name="--early-lvalue-error",                                           \
169    is_undocumented=true,                                                  \
170    desc="invalid lvalue expressions should be reported as early errors.", \
171    type=Boolean,                                                          \
172    default=true                                                           \
173}
174
175nashorn.option.fullversion = {                 \
176    name="-fullversion",                       \
177    short_name="-fv",                          \
178    desc="Print full version info of Nashorn." \
179}
180
181nashorn.option.function.statement.error= {                                    \
182    name="--function-statement-error",                                        \
183    desc="Report an error when function declaration is used as a statement.", \
184    is_undocumented=true,                                                     \
185    default=false                                                             \
186}
187
188nashorn.option.function.statement.warning = {                      \
189    name="--function-statement-warning",                           \
190    desc="Warn when function declaration is used as a statement.", \
191    is_undocumented=true,                                          \
192    default=false                                                  \
193}
194
195nashorn.option.fx = {                           \
196    name="-fx",                                 \
197    desc="Launch script as an fx application.", \
198    default=false                               \
199}
200
201nashorn.option.global.per.engine = {            \
202    name="--global-per-engine",                 \
203    desc="Use single Global instance per script engine instance.", \
204    is_undocumented=true,                                          \
205    type=Boolean,                               \
206    default=false                               \
207}
208
209nashorn.option.language = {                      \
210    name="--language",                           \
211    type=String,                                 \
212    params=[es5|es6],                            \
213    default=es5,                                 \
214    desc="Specify ECMAScript language version."  \
215}
216
217nashorn.option.log = {                                                       \
218    name="--log",                                                            \
219    is_undocumented=true,                                                    \
220    params="<module:level>,*",                                               \
221    desc="Enable logging of a given level for a given number of sub systems. \
222        [for example: --log=fields:finest,codegen:info].",                   \
223    type=Log                                                                 \
224}
225
226nashorn.option.lazy.compilation = {                                                                      \
227    name="--lazy-compilation",                                                                           \
228    is_undocumented=true,                                                                                \
229    desc="Use lazy code generation strategies - do not compile the entire script at once.", \
230    default=true                                   \
231}
232
233nashorn.option.loader.per.compile = {              \
234    name="--loader-per-compile",                   \
235    is_undocumented=true,                          \
236    desc="Create a new class loader per compile.", \
237    default=true                                   \
238}
239
240nashorn.option.module.path ={                                 \
241    name="--module-path",                                     \
242    desc="--module-path path. Specify where to find user java modules.", \
243    value_next_arg=true,                                      \
244    type=String                                               \
245}
246
247nashorn.option.add.modules ={                                 \
248    name="--add-modules",                                     \
249    desc="--add-modules modules. Specify the root user java modules.", \
250    repeated=true,                                            \
251    value_next_arg=true,                                      \
252    type=String                                               \
253}
254
255nashorn.option.no.java = {                         \
256    name="--no-java",                              \
257    short_name="-nj",                              \
258    is_undocumented=true,                          \
259    desc="Disable Java support.",                  \
260    default=false                                  \
261}
262
263nashorn.option.no.syntax.extensions = {              \
264    name="--no-syntax-extensions",                   \
265    short_name="-nse",                               \
266    is_undocumented=true,                            \
267    desc="Disallow non-standard syntax extensions.", \
268    default=false                                    \
269}
270
271nashorn.option.no.typed.arrays = {                 \
272    name="--no-typed-arrays",                      \
273    short_name="-nta",                             \
274    is_undocumented=true,                          \
275    desc="Disable typed arrays support.",          \
276    default=false                                  \
277}
278
279nashorn.option.optimistic.types = {                                                                      \
280    name="--optimistic-types",                                                                           \
281    short_name="-ot",                                                                                    \
282    desc="Use optimistic type assumptions with deoptimizing recompilation. This makes the compiler try, for any program symbol whose type cannot be proven at compile time, to type it as narrow and primitive as possible. If the runtime encounters an error because symbol type is too narrow, a wider method will be generated until steady stage is reached. While this produces as optimal Java Bytecode as possible, erroneous type guesses will lead to longer warmup. Optimistic typing is currently enabled by default, but can be disabled for faster startup performance.",                     \
283    default=true                                                                                         \
284}
285
286nashorn.option.parse.only = {       \
287    name="--parse-only",            \
288    is_undocumented=true,           \
289    desc="Parse without compiling." \
290}
291
292nashorn.option.persistent.code.cache = {            \
293    name="--persistent-code-cache",                 \
294    short_name="-pcc",                              \
295    desc="Enable disk cache for compiled scripts.", \
296    is_undocumented=true,                           \
297    default=false                                   \
298}
299
300nashorn.option.profile.callsites = {   \
301    name="--profile-callsites",        \
302    short_name="-pcs",                 \
303    is_undocumented=true,              \
304    desc="Dump callsite profile data." \
305}
306
307nashorn.option.print.ast = {            \
308    name="--print-ast",                 \
309    is_undocumented=true,               \
310    desc="Print abstract syntax tree."  \
311}
312
313nashorn.option.print.lower.ast = {              \
314    name="--print-lower-ast",                   \
315    is_undocumented=true,                       \
316    desc="Print lowered abstract syntax tree."  \
317}
318
319nashorn.option.print.code = { \
320    name="--print-code",      \
321    short_name="-pc",         \
322    is_undocumented=true,     \
323    params="[dir:<output-dir>,function:<name>]", \
324    type=keyvalues,           \
325    desc="Print generated bytecode. If a directory is specified, nothing will be dumped to stderr. Also, in that case, .dot files will be generated for all functions or for the function with the specified name only."  \
326}
327
328nashorn.option.print.mem.usage = {                            \
329    name="--print-mem-usage",                                 \
330    is_undocumented=true,                                     \
331    desc="Print memory usage of IR after each compile stage." \
332}
333
334nashorn.option.print.no.newline = {                     \
335    name="--print-no-newline",                          \
336    is_undocumented=true,                               \
337    desc="Print function will not print new line char." \
338}
339
340nashorn.option.print.parse = {   \
341    name="--print-parse",        \
342    short_name="-pp",            \
343    is_undocumented=true,        \
344    desc="Print the parse tree." \
345}
346
347nashorn.option.print.lower.parse = {            \
348    name="--print-lower-parse",                 \
349    short_name="-plp",                          \
350    is_undocumented=true,                       \
351    desc="Print the parse tree after lowering." \
352}
353
354nashorn.option.print.symbols = {   \
355    name="--print-symbols",        \
356    is_undocumented=true,          \
357    desc="Print the symbol table." \
358}
359
360nashorn.option.strict = {              \
361    name="-strict",                    \
362    desc="Run scripts in strict mode." \
363}
364
365nashorn.option.scripting = {            \
366    name="-scripting",                  \
367    desc="Enable scripting features."   \
368}
369
370nashorn.option.stdout = {                                                \
371    name="--stdout",                                                     \
372    is_undocumented=true,                                                \
373    type=String,                                                         \
374    params="<output console>",                                           \
375    desc="Redirect stdout to a filename or to another tty, e.g. stderr." \
376}
377
378nashorn.option.stderr = {                                                \
379    name="--stderr",                                                     \
380    is_undocumented=true,                                                \
381    type=String,                                                         \
382    params="<output console>",                                           \
383    desc="Redirect stderr to a filename or to another tty, e.g. stdout." \
384}
385
386nashorn.option.timezone = {                    \
387    name="-timezone",                          \
388    short_name="-t",                           \
389    params="<timezone>",                       \
390    desc="Set timezone for script execution.", \
391    type=TimeZone                              \
392}
393
394nashorn.option.locale = {                    \
395    name="--locale",                         \
396    short_name="-l",                         \
397    is_undocumented=true,                    \
398    params="<locale>",                       \
399    desc="Set Locale for script execution.", \
400    type=Locale                              \
401}
402
403nashorn.option.trace.callsites = {                                               \
404    name="--trace-callsites",                                                    \
405    short_name="-tcs",                                                           \
406    is_undocumented=true,                                                        \
407    type=keyvalues,                                                              \
408    params="[=[option,]*]",                                                      \
409    desc="Enable callsite trace mode. Options are: miss [trace callsite misses]  \
410    enterexit [trace callsite enter/exit], objects [print object properties]."   \
411}
412
413nashorn.option.unstable.relink.threshold ={                   \
414    name="--unstable-relink-threshold",                       \
415    short_name="-urt",                                        \
416    desc="Number of times a dynamic call site has to be       \
417    relinked before it is considered unstable, when the       \
418    runtime will try to link it as if it is megamorphic.",    \
419    is_undocumented=true,                                     \
420    type=Integer,                                             \
421    default=-1                                                \
422}
423
424
425nashorn.option.verify.code = {              \
426    name="--verify-code",                   \
427    is_undocumented=true,                   \
428    desc="Verify byte code before running." \
429}
430
431nashorn.option.version = {                \
432    name="-version",                      \
433    short_name="-v",                      \
434    desc="Print version info of Nashorn." \
435}
436
437