1 #
   2 # Copyright (c) 2010, 2018, 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 option.error.invalid.option="{0}" is not a recognized option. Use "{1}" or "{2}" to see a list of all supported options.
  26 
  27 nashorn.options = Usage: jjs [option=value]* [filename.js]+ [-- options...]\n\
  28                 \n\
  29                 Valid options are:
  30 
  31 #
  32 # Localized meta descriptions
  33 #
  34 nashorn.options.param = param
  35 nashorn.options.default = default
  36 
  37 #
  38 # Which option is "help".
  39 #
  40 nashorn.options.help.key = nashorn.option.help
  41 
  42 #
  43 # Which option is "xhelp".
  44 #
  45 nashorn.options.xhelp.key = nashorn.option.xhelp
  46 
  47 #
  48 # Which option is "D".
  49 #
  50 nashorn.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 
  68 nashorn.option.help = {                       \
  69     name="--help",                            \
  70     short_name="-h",                          \
  71     desc="Print this help message."           \
  72 }
  73 
  74 nashorn.option.xhelp = {                               \
  75     name="-xhelp",                                     \
  76     is_undocumented=true,                              \
  77     desc="Print extended help for command line flags." \
  78 }
  79 
  80 nashorn.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 
  89 nashorn.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 
  98 nashorn.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 
 106 nashorn.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 
 114 nashorn.option.const.as.var = {          \
 115     name="--const-as-var",               \
 116     is_undocumented=true,                \
 117     desc="Replace 'const' with 'var'.",  \
 118     type=Boolean                         \
 119 }
 120 
 121 nashorn.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 
 130 nashorn.option.D = {                                                          \
 131     name="-D",                                                                \
 132     desc="-Dname=value. Set a system property. This option can be repeated.", \
 133     type=String                                                               \
 134 }
 135 
 136 nashorn.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 
 143 nashorn.option.debug.locals = {                           \
 144     name="--debug-locals",                                \
 145     is_undocumented=true,                                 \
 146     desc="Generate local variable table in .class files." \
 147 }
 148 
 149 nashorn.option.debug.scopes = {                                 \
 150     name="--debug-scopes",                                      \
 151     is_undocumented=true,                                       \
 152     desc="Put all variables in scopes to make them debuggable." \
 153 }
 154 
 155 nashorn.option.doe = {                   \
 156     name="-dump-on-error",               \
 157     short_name="-doe",                   \
 158     desc="Dump a stack trace on errors." \
 159 }
 160 
 161 nashorn.option.empty.statements = {          \
 162     name="--empty-statements",               \
 163     is_undocumented=true,                    \
 164     desc="Preserve empty statements in AST." \
 165 }
 166 
 167 nashorn.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 
 175 nashorn.option.fullversion = {                 \
 176     name="-fullversion",                       \
 177     short_name="-fv",                          \
 178     desc="Print full version info of Nashorn." \
 179 }
 180 
 181 nashorn.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 
 188 nashorn.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 
 195 nashorn.option.fx = {                           \
 196     name="-fx",                                 \
 197     desc="Launch script as an fx application.", \
 198     default=false                               \
 199 }
 200 
 201 nashorn.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 
 209 nashorn.option.language = {                      \
 210     name="--language",                           \
 211     type=String,                                 \
 212     params=[es5|es6],                            \
 213     default=es5,                                 \
 214     desc="Specify ECMAScript language version."  \
 215 }
 216 
 217 nashorn.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 
 226 nashorn.option.no.deprecation.warning = {                      \
 227     name="--no-deprecation-warning",                           \
 228     type=Boolean,                                 \
 229     default=false,                                \
 230     desc="Do not show nashorn deprecation warning."  \
 231 }
 232 
 233 
 234 nashorn.option.lazy.compilation = {                                                                      \
 235     name="--lazy-compilation",                                                                           \
 236     is_undocumented=true,                                                                                \
 237     desc="Use lazy code generation strategies - do not compile the entire script at once.", \
 238     default=true                                   \
 239 }
 240 
 241 nashorn.option.loader.per.compile = {              \
 242     name="--loader-per-compile",                   \
 243     is_undocumented=true,                          \
 244     desc="Create a new class loader per compile.", \
 245     default=true                                   \
 246 }
 247 
 248 nashorn.option.module.path ={                                 \
 249     name="--module-path",                                     \
 250     desc="--module-path path. Specify where to find user java modules.", \
 251     value_next_arg=true,                                      \
 252     type=String                                               \
 253 }
 254 
 255 nashorn.option.add.modules ={                                 \
 256     name="--add-modules",                                     \
 257     desc="--add-modules modules. Specify the root user java modules.", \
 258     repeated=true,                                            \
 259     value_next_arg=true,                                      \
 260     type=String                                               \
 261 }
 262 
 263 nashorn.option.no.java = {                         \
 264     name="--no-java",                              \
 265     short_name="-nj",                              \
 266     is_undocumented=true,                          \
 267     desc="Disable Java support.",                  \
 268     default=false                                  \
 269 }
 270 
 271 nashorn.option.no.syntax.extensions = {              \
 272     name="--no-syntax-extensions",                   \
 273     short_name="-nse",                               \
 274     is_undocumented=true,                            \
 275     desc="Disallow non-standard syntax extensions.", \
 276     default=false                                    \
 277 }
 278 
 279 nashorn.option.no.typed.arrays = {                 \
 280     name="--no-typed-arrays",                      \
 281     short_name="-nta",                             \
 282     is_undocumented=true,                          \
 283     desc="Disable typed arrays support.",          \
 284     default=false                                  \
 285 }
 286 
 287 nashorn.option.optimistic.types = {                                                                      \
 288     name="--optimistic-types",                                                                           \
 289     short_name="-ot",                                                                                    \
 290     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.",                     \
 291     default=true                                                                                         \
 292 }
 293 
 294 nashorn.option.parse.only = {       \
 295     name="--parse-only",            \
 296     is_undocumented=true,           \
 297     desc="Parse without compiling." \
 298 }
 299 
 300 nashorn.option.persistent.code.cache = {            \
 301     name="--persistent-code-cache",                 \
 302     short_name="-pcc",                              \
 303     desc="Enable disk cache for compiled scripts.", \
 304     is_undocumented=true,                           \
 305     default=false                                   \
 306 }
 307 
 308 nashorn.option.profile.callsites = {   \
 309     name="--profile-callsites",        \
 310     short_name="-pcs",                 \
 311     is_undocumented=true,              \
 312     desc="Dump callsite profile data." \
 313 }
 314 
 315 nashorn.option.print.ast = {            \
 316     name="--print-ast",                 \
 317     is_undocumented=true,               \
 318     desc="Print abstract syntax tree."  \
 319 }
 320 
 321 nashorn.option.print.lower.ast = {              \
 322     name="--print-lower-ast",                   \
 323     is_undocumented=true,                       \
 324     desc="Print lowered abstract syntax tree."  \
 325 }
 326 
 327 nashorn.option.print.code = { \
 328     name="--print-code",      \
 329     short_name="-pc",         \
 330     is_undocumented=true,     \
 331     params="[dir:<output-dir>,function:<name>]", \
 332     type=keyvalues,           \
 333     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."  \
 334 }
 335 
 336 nashorn.option.print.no.newline = {                     \
 337     name="--print-no-newline",                          \
 338     is_undocumented=true,                               \
 339     desc="Print function will not print new line char." \
 340 }
 341 
 342 nashorn.option.print.parse = {   \
 343     name="--print-parse",        \
 344     short_name="-pp",            \
 345     is_undocumented=true,        \
 346     desc="Print the parse tree." \
 347 }
 348 
 349 nashorn.option.print.lower.parse = {            \
 350     name="--print-lower-parse",                 \
 351     short_name="-plp",                          \
 352     is_undocumented=true,                       \
 353     desc="Print the parse tree after lowering." \
 354 }
 355 
 356 nashorn.option.print.symbols = {   \
 357     name="--print-symbols",        \
 358     is_undocumented=true,          \
 359     desc="Print the symbol table." \
 360 }
 361 
 362 nashorn.option.strict = {              \
 363     name="-strict",                    \
 364     desc="Run scripts in strict mode." \
 365 }
 366 
 367 nashorn.option.scripting = {            \
 368     name="-scripting",                  \
 369     desc="Enable scripting features."   \
 370 }
 371 
 372 nashorn.option.stdout = {                                                \
 373     name="--stdout",                                                     \
 374     is_undocumented=true,                                                \
 375     type=String,                                                         \
 376     params="<output console>",                                           \
 377     desc="Redirect stdout to a filename or to another tty, e.g. stderr." \
 378 }
 379 
 380 nashorn.option.stderr = {                                                \
 381     name="--stderr",                                                     \
 382     is_undocumented=true,                                                \
 383     type=String,                                                         \
 384     params="<output console>",                                           \
 385     desc="Redirect stderr to a filename or to another tty, e.g. stdout." \
 386 }
 387 
 388 nashorn.option.timezone = {                    \
 389     name="-timezone",                          \
 390     short_name="-t",                           \
 391     params="<timezone>",                       \
 392     desc="Set timezone for script execution.", \
 393     type=TimeZone                              \
 394 }
 395 
 396 nashorn.option.locale = {                    \
 397     name="--locale",                         \
 398     short_name="-l",                         \
 399     is_undocumented=true,                    \
 400     params="<locale>",                       \
 401     desc="Set Locale for script execution.", \
 402     type=Locale                              \
 403 }
 404 
 405 nashorn.option.trace.callsites = {                                               \
 406     name="--trace-callsites",                                                    \
 407     short_name="-tcs",                                                           \
 408     is_undocumented=true,                                                        \
 409     type=keyvalues,                                                              \
 410     params="[=[option,]*]",                                                      \
 411     desc="Enable callsite trace mode. Options are: miss [trace callsite misses]  \
 412     enterexit [trace callsite enter/exit], objects [print object properties]."   \
 413 }
 414 
 415 nashorn.option.unstable.relink.threshold ={                   \
 416     name="--unstable-relink-threshold",                       \
 417     short_name="-urt",                                        \
 418     desc="Number of times a dynamic call site has to be       \
 419     relinked before it is considered unstable, when the       \
 420     runtime will try to link it as if it is megamorphic.",    \
 421     is_undocumented=true,                                     \
 422     type=Integer,                                             \
 423     default=-1                                                \
 424 }
 425 
 426 
 427 nashorn.option.verify.code = {              \
 428     name="--verify-code",                   \
 429     is_undocumented=true,                   \
 430     desc="Verify byte code before running." \
 431 }
 432 
 433 nashorn.option.version = {                \
 434     name="-version",                      \
 435     short_name="-v",                      \
 436     desc="Print version info of Nashorn." \
 437 }
 438