rev 47329 : 8189102: All tools should support -?, -h and --help

   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 #
  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 help for command line flags." \
  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.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 
 233 nashorn.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 
 240 nashorn.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 
 247 nashorn.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 
 255 nashorn.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 
 263 nashorn.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 
 271 nashorn.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 
 279 nashorn.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 
 286 nashorn.option.parse.only = {       \
 287     name="--parse-only",            \
 288     is_undocumented=true,           \
 289     desc="Parse without compiling." \
 290 }
 291 
 292 nashorn.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 
 300 nashorn.option.profile.callsites = {   \
 301     name="--profile-callsites",        \
 302     short_name="-pcs",                 \
 303     is_undocumented=true,              \
 304     desc="Dump callsite profile data." \
 305 }
 306 
 307 nashorn.option.print.ast = {            \
 308     name="--print-ast",                 \
 309     is_undocumented=true,               \
 310     desc="Print abstract syntax tree."  \
 311 }
 312 
 313 nashorn.option.print.lower.ast = {              \
 314     name="--print-lower-ast",                   \
 315     is_undocumented=true,                       \
 316     desc="Print lowered abstract syntax tree."  \
 317 }
 318 
 319 nashorn.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 
 328 nashorn.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 
 334 nashorn.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 
 340 nashorn.option.print.parse = {   \
 341     name="--print-parse",        \
 342     short_name="-pp",            \
 343     is_undocumented=true,        \
 344     desc="Print the parse tree." \
 345 }
 346 
 347 nashorn.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 
 354 nashorn.option.print.symbols = {   \
 355     name="--print-symbols",        \
 356     is_undocumented=true,          \
 357     desc="Print the symbol table." \
 358 }
 359 
 360 nashorn.option.strict = {              \
 361     name="-strict",                    \
 362     desc="Run scripts in strict mode." \
 363 }
 364 
 365 nashorn.option.scripting = {            \
 366     name="-scripting",                  \
 367     desc="Enable scripting features."   \
 368 }
 369 
 370 nashorn.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 
 378 nashorn.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 
 386 nashorn.option.timezone = {                    \
 387     name="-timezone",                          \
 388     short_name="-t",                           \
 389     params="<timezone>",                       \
 390     desc="Set timezone for script execution.", \
 391     type=TimeZone                              \
 392 }
 393 
 394 nashorn.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 
 403 nashorn.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 
 413 nashorn.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 
 425 nashorn.option.verify.code = {              \
 426     name="--verify-code",                   \
 427     is_undocumented=true,                   \
 428     desc="Verify byte code before running." \
 429 }
 430 
 431 nashorn.option.version = {                \
 432     name="-version",                      \
 433     short_name="-v",                      \
 434     desc="Print version info of Nashorn." \
 435 }
 436 
--- EOF ---