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.class.cache.size ={                            \
  81     name="--class-cache-size",                                \
  82     short_name="-ccs",                                        \
  83     desc="Size of the Class cache size per global scope.",    \
  84     is_undocumented=true,                                     \
  85     type=Integer,                                             \
  86     default=50                                                \
  87 }
  88 
  89 nashorn.option.classpath ={                                   \
  90     name="-classpath",                                        \
  91     short_name="-cp",                                         \
  92     desc="-cp path. Specify where to find user class files.", \
  93     value_next_arg=true,                                      \
  94     type=String                                               \
  95 }
  96 
  97 nashorn.option.compile.only = {       \
  98     name="--compile-only",            \
  99     short_name="-co",                 \
 100     is_undocumented=true,             \
 101     desc="Compile without running.",  \
 102     type=Boolean                      \
 103 }
 104 
 105 nashorn.option.d = {                                             \
 106     name="--dump-debug-dir",                                     \
 107     short_name="-d",                                             \
 108     is_undocumented=true,                                        \
 109     params="<path>",                                             \
 110     desc="specify a destination directory to dump class files.", \
 111     type=String                                                  \
 112 }
 113 
 114 nashorn.option.doe = {                   \
 115     name="-dump-on-error",               \
 116     short_name="-doe",                   \
 117     desc="Dump a stack trace on errors." \
 118 }
 119 
 120 nashorn.option.empty.statements = {          \
 121     name="--empty-statements",               \
 122     is_undocumented=true,                    \
 123     desc="Preserve empty statements in AST." \
 124 }
 125 
 126 nashorn.option.early.lvalue.error = {                                      \
 127     name="--early-lvalue-error",                                           \
 128     is_undocumented=true,                                                  \
 129     desc="invalid lvalue expressions should be reported as early errors.", \
 130     type=Boolean,                                                          \
 131     default=true                                                           \
 132 }
 133 
 134 nashorn.option.fullversion = {                 \
 135     name="-fullversion",                       \
 136     short_name="-fv",                          \
 137     desc="Print full version info of Nashorn." \
 138 }
 139 
 140 nashorn.option.function.statement.error= {                                    \
 141     name="--function-statement-error",                                        \
 142     desc="Report an error when function declaration is used as a statement.", \
 143     is_undocumented=true,                                                     \
 144     default=false                                                             \
 145 }
 146 
 147 nashorn.option.function.statement.warning = {                      \
 148     name="--function-statement-warning",                           \
 149     desc="Warn when function declaration is used as a statement.", \
 150     is_undocumented=true,                                          \
 151     default=false                                                  \
 152 }
 153 
 154 nashorn.option.fx = {                           \
 155     name="-fx",                                 \
 156     desc="Launch script as an fx application.", \
 157     default=false                               \
 158 }
 159 
 160 nashorn.option.global.per.engine = {            \
 161     name="--global-per-engine",                 \
 162     desc="Use single Global instance per script engine instance.", \
 163     is_undocumented=true,                                          \
 164     type=Boolean,                               \
 165     default=false                               \
 166 }
 167 
 168 nashorn.option.log = {                                                       \
 169     name="--log",                                                            \
 170     is_undocumented=true,                                                    \
 171     params="<module:level>,*",                                               \
 172     desc="Enable logging of a given level for a given number of sub systems. \
 173         [for example: --log=fields:finest,codegen:info]",                    \
 174     type=Log                                                                 \
 175 }
 176 
 177 nashorn.option.debug.lines = {                          \
 178     name="--debug-lines",                               \
 179     is_undocumented=true,                               \
 180     desc="Generate line number table in .class files.", \
 181     default=true                                        \
 182 }
 183 
 184 nashorn.option.debug.locals = {                           \
 185     name="--debug-locals",                                \
 186     is_undocumented=true,                                 \
 187     desc="Generate local variable table in .class files." \
 188 }
 189 
 190 nashorn.option.lazy.compilation = {                                                                      \
 191     name="--lazy-compilation",                                                                           \
 192     is_undocumented=true,                                                                                \
 193     desc="EXPERIMENTAL: Use lazy code generation strategies - do not compile the entire script at once." \
 194 }
 195 
 196 nashorn.option.loader.per.compile = {              \
 197     name="--loader-per-compile",                   \
 198     is_undocumented=true,                          \
 199     desc="Create a new class loader per compile.", \
 200     default=true                                   \
 201 }
 202 
 203 nashorn.option.no.java = {                         \
 204     name="--no-java",                              \
 205     short_name="-nj",                              \
 206     is_undocumented=true,                          \
 207     desc="No Java support",                        \
 208     default=false                                  \
 209 }
 210 
 211 nashorn.option.no.syntax.extensions = {            \
 212     name="--no-syntax-extensions",                 \
 213     short_name="-nse",                             \
 214     is_undocumented=true,                          \
 215     desc="No non-standard syntax extensions",      \
 216     default=false                                  \
 217 }
 218 
 219 nashorn.option.no.typed.arrays = {                 \
 220     name="--no-typed-arrays",                      \
 221     short_name="-nta",                             \
 222     is_undocumented=true,                          \
 223     desc="No Typed arrays support",                \
 224     default=false                                  \
 225 }
 226 
 227 nashorn.option.parse.only = {       \
 228     name="--parse-only",            \
 229     is_undocumented=true,           \
 230     desc="Parse without compiling." \
 231 }
 232 
 233 nashorn.option.profile.callsites = {   \
 234     name="--profile-callsites",        \
 235     short_name="-pcs",                 \
 236     is_undocumented=true,              \
 237     desc="Dump callsite profile data." \
 238 }
 239 
 240 nashorn.option.print.ast = {            \
 241     name="--print-ast",                 \
 242     is_undocumented=true,               \
 243     desc="Print abstract syntax tree."  \
 244 }
 245 
 246 nashorn.option.print.lower.ast = {              \
 247     name="--print-lower-ast",                   \
 248     is_undocumented=true,                       \
 249     desc="Print lowered abstract syntax tree."  \
 250 }
 251 
 252 nashorn.option.print.code = { \
 253     name="--print-code",      \
 254     is_undocumented=true,     \
 255     desc="Print bytecode."    \
 256 }
 257 
 258 nashorn.option.print.mem.usage = {                            \
 259     name="--print-mem-usage",                                 \
 260     is_undocumented=true,                                     \
 261     desc="Print memory usage of IR after each compile stage." \
 262 }
 263 
 264 nashorn.option.print.no.newline = {                     \
 265     name="--print-no-newline",                          \
 266     is_undocumented=true,                               \
 267     desc="Print function will not print new line char." \
 268 }
 269 
 270 nashorn.option.print.parse = {   \
 271     name="--print-parse",        \
 272     is_undocumented=true,        \
 273     desc="Print the parse tree." \
 274 }
 275 
 276 nashorn.option.print.lower.parse = {            \
 277     name="--print-lower-parse",                 \
 278     is_undocumented=true,                       \
 279     desc="Print the parse tree after lowering." \
 280 }
 281 
 282 nashorn.option.print.symbols = {   \
 283     name="--print-symbols",        \
 284     is_undocumented=true,          \
 285     desc="Print the symbol table." \
 286 }
 287 
 288 nashorn.option.range.analysis = { \
 289     name="--range-analysis",      \
 290     is_undocumented=true,         \
 291     desc="EXPERIMENTAL: Do range analysis using known compile time types, and try to narrow number types" \
 292 }    
 293 
 294 nashorn.option.D = {                                                          \
 295     name="-D",                                                                \
 296     desc="-Dname=value. Set a system property. This option can be repeated.", \
 297     type=String                                                               \
 298 }
 299 
 300 nashorn.option.strict = {              \
 301     name="-strict",                    \
 302     desc="Run scripts in strict mode." \
 303 }
 304 
 305 nashorn.option.scripting = {            \
 306     name="-scripting",                  \
 307     desc="Enable scripting features."   \
 308 }
 309 
 310 nashorn.option.specialize.calls = {                                                              \
 311     name="--specialize-calls",                                                                   \
 312     is_undocumented=true,                                                                        \
 313     type=String,                                                                                 \
 314     params="[=function_1,...,function_n]",                                                       \
 315     desc="EXPERIMENTAL: Specialize all or a set of method according to callsite parameter types" \
 316 }
 317 
 318 nashorn.option.stdout = {                                               \
 319     name="--stdout",                                                    \
 320     is_undocumented=true,                                               \
 321     type=String,                                                        \
 322     params="<output console>",                                          \
 323     desc="Redirect stdout to a filename or to another tty, e.g. stderr" \
 324 }
 325 
 326 nashorn.option.stderr = {                                               \
 327     name="--stderr",                                                    \
 328     is_undocumented=true,                                               \
 329     type=String,                                                        \
 330     params="<output console>",                                          \
 331     desc="Redirect stderr to a filename or to another tty, e.g. stdout" \
 332 }
 333 
 334 nashorn.option.timezone = {                    \
 335     name="-timezone",                          \
 336     short_name="-t",                           \
 337     params="<timezone>",                       \
 338     desc="Set timezone for script execution.", \
 339     type=TimeZone                              \
 340 }
 341 
 342 nashorn.option.locale = {                    \
 343     name="--locale",                         \
 344     short_name="-l",                         \
 345     is_undocumented=true,                    \
 346     params="<locale>",                       \
 347     desc="Set Locale for script execution.", \
 348     type=Locale                              \
 349 }
 350 
 351 nashorn.option.trace.callsites = {                                              \
 352     name="--trace-callsites",                                                   \
 353     short_name="-tcs",                                                          \
 354     is_undocumented=true,                                                       \
 355     type=keyvalues,                                                             \
 356     params="[=[option,]*]",                                                     \
 357     desc="Enable callsite trace mode. Options are: miss [trace callsite misses] \
 358     enterexit [trace callsite enter/exit], objects [print object properties]"   \
 359 }
 360 
 361 nashorn.option.verify.code = {              \
 362     name="--verify-code",                   \
 363     is_undocumented=true,                   \
 364     desc="Verify byte code before running." \
 365 }
 366 
 367 nashorn.option.version = {                \
 368     name="-version",                      \
 369     short_name="-v",                      \
 370     desc="Print version info of Nashorn." \
 371 }
 372