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