2
+ − 1 .'" t
+ − 2 ."
+ − 3 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
+ − 4 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ − 5 ."
+ − 6 ." This code is free software; you can redistribute it and/or modify it
+ − 7 ." under the terms of the GNU General Public License version 2 only, as
+ − 8 ." published by the Free Software Foundation.
+ − 9 ."
+ − 10 ." This code is distributed in the hope that it will be useful, but WITHOUT
+ − 11 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ − 12 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ − 13 ." version 2 for more details (a copy is included in the LICENSE file that
+ − 14 ." accompanied this code).
+ − 15 ."
+ − 16 ." You should have received a copy of the GNU General Public License version
+ − 17 ." 2 along with this work; if not, write to the Free Software Foundation,
+ − 18 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ − 19 ."
+ − 20 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ − 21 ." CA 95054 USA or visit www.sun.com if you need additional information or
+ − 22 ." have any questions.
+ − 23 ."
+ − 24 ." `
+ − 25 .TH jrunscript 1 "06 Aug 2006"
+ − 26 ." Generated by html2man
+ − 27
+ − 28 .LP
+ − 29 .SH NAME
+ − 30 jrunscript \- command line script shell
+ − 31 .LP
+ − 32 .SH "SYNOPSIS"
+ − 33 .LP
+ − 34
+ − 35 .LP
+ − 36 .nf
+ − 37 \f3
+ − 38 .fl
+ − 39 \fP\f3jrunscript\fP [ \f2options\fP ] [ arguments... ]
+ − 40 .fl
+ − 41 .fi
+ − 42
+ − 43 .LP
+ − 44 .SH "PARAMETERS"
+ − 45 .LP
+ − 46
+ − 47 .LP
+ − 48 .TP 3
+ − 49 options
+ − 50 Options, if used, should follow immediately after the command name.
+ − 51 .TP 3
+ − 52 arguments
+ − 53 Arguments, if used, should follow immediately after options or command name.
+ − 54 .LP
+ − 55 .SH "DESCRIPTION"
+ − 56 .LP
+ − 57
+ − 58 .LP
+ − 59 .LP
+ − 60 \f3jrunscript\fP is a command line script shell. jrunscript supports both an interactive (read\-eval\-print) mode and a batch (\-f option) mode of script execution. This is a scripting language independent shell. By default, JavaScript is the language used, but the \-l option can be used to specify a different language. Through Java to scripting language communication, jrunscript supports "exploratory programming" style.
+ − 61 .LP
+ − 62 .LP
+ − 63 \f3NOTE:\fP This tool is \f3experimental\fP and may \f3not\fP be available in future versions of the JDK.
+ − 64 .LP
+ − 65 .SH "OPTIONS"
+ − 66 .LP
+ − 67
+ − 68 .LP
+ − 69 .TP 3
+ − 70 \-classpath path
+ − 71 Specify where to find the user's .class files that are accessed by the script.
+ − 72 .TP 3
+ − 73 \-cp path
+ − 74 This is a synonym for \-classpath \f2path\fP
+ − 75 .TP 3
+ − 76 \-Dname=value
+ − 77 Set a Java system property.
+ − 78 .TP 3
+ − 79 \-J<flag>
+ − 80 Pass <flag> directly to the Java virtual machine on which jrunscript is run.
+ − 81 .TP 3
+ − 82 \-l language
+ − 83 Use the specified scripting language. By default, JavaScript is used. Note that to use other scripting languages, you also need to specify the corresponding script engine's jar file using \-cp or \-classpath option.
+ − 84 .TP 3
+ − 85 \-e script
+ − 86 Evaluate the given script. This option can be used to run "one liner" scripts specified completely on the command line.
+ − 87 .TP 3
+ − 88 \-encoding encoding
+ − 89 Specify the character encoding used while reading script files.
+ − 90 .TP 3
+ − 91 \-f script\-file
+ − 92 Evaluate the given script file (batch mode).
+ − 93 .TP 3
+ − 94 \-f \-
+ − 95 Read and evaluate a script from standard input (interactive mode).
+ − 96 .TP 3
+ − 97 \-help\
+ − 98 Output help message and exit.
+ − 99 .TP 3
+ − 100 \-?\
+ − 101 Output help message and exit.
+ − 102 .TP 3
+ − 103 \-q\
+ − 104 List all script engines available and exit.
+ − 105 .LP
+ − 106 .SH "ARGUMENTS"
+ − 107 .LP
+ − 108 .LP
+ − 109 If [arguments...] are present and if no \f3\-e\fP or \f3\-f\fP option is used, then the first argument is the script file and the rest of the arguments, if any, are passed as script arguments. If [arguments..] and \f3\-e\fP or \f3\-f\fP option are used, then all [arguments..] are passed as script arguments. If [arguments..], \f3\-e\fP and \f3\-f\fP are missing, interactive mode is used. Script arguments are available to a script in an engine variable named "arguments" of type String array.
+ − 110 .LP
+ − 111 .SH "EXAMPLES"
+ − 112 .LP
+ − 113 \f3Executing inline scripts\fP
+ − 114 .LP
+ − 115 .RS 3
+ − 116
+ − 117 .LP
+ − 118 .nf
+ − 119 \f3
+ − 120 .fl
+ − 121 jrunscript \-e "print('hello world')"
+ − 122 .fl
+ − 123 jrunscript \-e "cat('http://java.sun.com')"
+ − 124 .fl
+ − 125 \fP
+ − 126 .fi
+ − 127 .RE
+ − 128
+ − 129 .LP
+ − 130 \f3Use specified language and evaluate given script file\fP
+ − 131 .LP
+ − 132 .RS 3
+ − 133
+ − 134 .LP
+ − 135 .nf
+ − 136 \f3
+ − 137 .fl
+ − 138 jrunscript \-l js \-f test.js
+ − 139 .fl
+ − 140 \fP
+ − 141 .fi
+ − 142 .RE
+ − 143
+ − 144 .LP
+ − 145 \f3Interactive mode\fP
+ − 146 .LP
+ − 147 .RS 3
+ − 148
+ − 149 .LP
+ − 150 .nf
+ − 151 \f3
+ − 152 .fl
+ − 153 jrunscript
+ − 154 .fl
+ − 155 js>print('hello world');
+ − 156 .fl
+ − 157 hello world
+ − 158 .fl
+ − 159 js>34 + 55
+ − 160 .fl
+ − 161 89
+ − 162 .fl
+ − 163 js> thread(function() { print('hello world'); }
+ − 164 .fl
+ − 165 hello world
+ − 166 .fl
+ − 167 js>
+ − 168 .fl
+ − 169 \fP
+ − 170 .fi
+ − 171 .RE
+ − 172
+ − 173 .LP
+ − 174 \f3Run script file with script arguments\fP
+ − 175 .LP
+ − 176 .RS 3
+ − 177
+ − 178 .LP
+ − 179 .nf
+ − 180 \f3
+ − 181 .fl
+ − 182 jrunscript test.js arg1 arg2 arg3
+ − 183 .fl
+ − 184 \fP
+ − 185 .fi
+ − 186 .RE
+ − 187
+ − 188 .LP
+ − 189 test.js is script file to execute and arg1, arg2 and arg3 are passed to script as script arguments. Script can access these using "arguments" array.
+ − 190 .SH "SEE ALSO"
+ − 191 .LP
+ − 192 .LP
+ − 193 If JavaScript is used, then before evaluating any user defined script, jrunscript initializes certain built\-in functions and objects. These JavaScript built\-ins are documented in jsdocs.
+ − 194 .LP
+ − 195
+ − 196 .LP
+ − 197