trunk/js/js.1

.TH JS 1 "22 July 2006"
.SH NAME
.BR js " - Mozilla JavaScript Shell"
.SH SYNOPSIS
.B js
.RB [ -w ]
.RB [ -W ]
.RB [ -S ]
.RB [ -x ]
.RB [ -C ]
.RB [ -c
.IR stackchunksize ]
.RB [ -S
.IR maxstacksize ]
.RB [ -b
.IR maxbranches ]
.RB [ -P ]
.RB [ -v
.IR version ]
.RB [ -e
.IR script ]
.RB [ -f
.IR scriptfile ]
.RI [ scriptfile ]
.RI [ scriptarg " ..." "" ]
.SH DESCRIPTION
The Mozilla JavaScript Shell
.B js
is a command line interface to the 
.B Mozilla JavaScript
language engine ("SpiderMonkey"),
as provided by the
.B OSSP js
distribution.
The
.B js
program provides a test vehicle for easily evaluating JavaScript scripts, calling JavaScript functions,
trying out debugger primitives, etc.
.SH OPTIONS
.SS Compile-Time Options
.TP 8
.B -w
Disable the printing of warnings.
.TP 8
.B -W
Enable the printing of warnings.
.TP 8
.B -s
Enable strict language parsing during compile-time.
This will print warnings on dubious JavaScript programming practices. 
.TP 8
.B -x
Enable ECMAScript for XML (E4X) support during compile-time.
.TP 8
.B -C
Compile only. This compiles the script but does not
execute it.
.SS Run-Time Options
.TP 8
.BI -c " stackchunksize"
Set the stack chunk size to
.I stackchunksize
bytes. The default is
.BR 8192 .
.TP 8
.BI -S " maxstacksize"
Set a maximum stack size limit to
.I maxstacksize
bytes in order to restruct script resource consumption.
The default is a stack of unlimited size.
.TP 8
.BI -b " maxbranches"
Set a maximum branch number limit to
.I maxbranches
in order to restrict script resource consumption. The default is an
unlimited number of branches.
.TP 8
.B -P
In case the prototype object of the (potentially changed) global object
is no longer connected to the global class, create a new global object
(which is again connected to the global class) and set its prototype
object to the old global object.
.TP 8
.BI -v " version"
override the numerical JavaScript version number, which the JavaScript
.B version()
function returns, with the value
.IR version .
The argument
.I version
usually is one of the following integer values:
.B 0
(default),
.B 100
(JS 1.0),
.B 110
(JS 1.1),
.B 120
(JS 1.2),
.B 130
(JS 1.3),
.B 140
(JS 1.4),
.B 148
(ECMA-3),
.B 150
(JS 1.5),
.B 160
(JS 1.6).
.SS Script Execution
.TP 8
.BI -e " script"
Command-line passed JavaScript script to execute.
This is executed immediately during command
line parsing, so specify it after
.B "Compile-Time Options"
and
.BR "Run-Time Options" .
.TP 7
.BI -f " scriptfile"
Externally passed JavaScript script to execute.
This is executed immediately during command
line parsing, so specify it after
.B "Compile-Time Options"
and
.BR "Run-Time Options" .
.SH ARGUMENTS
.TP 8
.RI scriptfile
Externally passed JavaScript script to execute.
This is executed after command line parsing
(and this way after scripts of options
.BR -e " and " -f
were executed.
This additional way of executing an external JavaScript
script exists to especially support Unix "shebang"
style scripts.
.TP 8
.IR scriptarg
Zero or more arguments which are passed to the executed
.IR scriptfile .
They are available in the script through the global
array object
.BR arguments .
.SH SEE ALSO
.BR js ( 3 ),
.BR js-config ( 1 )
.PP
.RS 0
http://www.mozilla.org/js/spidermonkey/
.RE
.RS 0
http://www.ossp.org/pkg/lib/js/
.RE
.SH AUTHOR
The author of the 
.B Mozilla JavaScript
language implementation ("SpiderMonkey") is
.I Brendan Eich
from the 
.IR "Mozilla Foundation" .
This manual page was written by 
.I Ralf S. Engelschall
for the 
.B OSSP js
distribution of 
.BR "Mozilla JavaScript" .
1	siliconforks	2	.TH JS 1 "22 July 2006"
2			.SH NAME
3			.BR js " - Mozilla JavaScript Shell"
4			.SH SYNOPSIS
5			.B js
6			.RB [ -w ]
7			.RB [ -W ]
8			.RB [ -S ]
9			.RB [ -x ]
10			.RB [ -C ]
11			.RB [ -c
12			.IR stackchunksize ]
13			.RB [ -S
14			.IR maxstacksize ]
15			.RB [ -b
16			.IR maxbranches ]
17			.RB [ -P ]
18			.RB [ -v
19			.IR version ]
20			.RB [ -e
21			.IR script ]
22			.RB [ -f
23			.IR scriptfile ]
24			.RI [ scriptfile ]
25			.RI [ scriptarg " ..." "" ]
26			.SH DESCRIPTION
27			The Mozilla JavaScript Shell
28			.B js
29			is a command line interface to the
30			.B Mozilla JavaScript
31			language engine ("SpiderMonkey"),
32			as provided by the
33			.B OSSP js
34			distribution.
35			The
36			.B js
37			program provides a test vehicle for easily evaluating JavaScript scripts, calling JavaScript functions,
38			trying out debugger primitives, etc.
39			.SH OPTIONS
40			.SS Compile-Time Options
41			.TP 8
42			.B -w
43			Disable the printing of warnings.
44			.TP 8
45			.B -W
46			Enable the printing of warnings.
47			.TP 8
48			.B -s
49			Enable strict language parsing during compile-time.
50			This will print warnings on dubious JavaScript programming practices.
51			.TP 8
52			.B -x
53			Enable ECMAScript for XML (E4X) support during compile-time.
54			.TP 8
55			.B -C
56			Compile only. This compiles the script but does not
57			execute it.
58			.SS Run-Time Options
59			.TP 8
60			.BI -c " stackchunksize"
61			Set the stack chunk size to
62			.I stackchunksize
63			bytes. The default is
64			.BR 8192 .
65			.TP 8
66			.BI -S " maxstacksize"
67			Set a maximum stack size limit to
68			.I maxstacksize
69			bytes in order to restruct script resource consumption.
70			The default is a stack of unlimited size.
71			.TP 8
72			.BI -b " maxbranches"
73			Set a maximum branch number limit to
74			.I maxbranches
75			in order to restrict script resource consumption. The default is an
76			unlimited number of branches.
77			.TP 8
78			.B -P
79			In case the prototype object of the (potentially changed) global object
80			is no longer connected to the global class, create a new global object
81			(which is again connected to the global class) and set its prototype
82			object to the old global object.
83			.TP 8
84			.BI -v " version"
85			override the numerical JavaScript version number, which the JavaScript
86			.B version()
87			function returns, with the value
88			.IR version .
89			The argument
90			.I version
91			usually is one of the following integer values:
92			.B 0
93			(default),
94			.B 100
95			(JS 1.0),
96			.B 110
97			(JS 1.1),
98			.B 120
99			(JS 1.2),
100			.B 130
101			(JS 1.3),
102			.B 140
103			(JS 1.4),
104			.B 148
105			(ECMA-3),
106			.B 150
107			(JS 1.5),
108			.B 160
109			(JS 1.6).
110			.SS Script Execution
111			.TP 8
112			.BI -e " script"
113			Command-line passed JavaScript script to execute.
114			This is executed immediately during command
115			line parsing, so specify it after
116			.B "Compile-Time Options"
117			and
118			.BR "Run-Time Options" .
119			.TP 7
120			.BI -f " scriptfile"
121			Externally passed JavaScript script to execute.
122			This is executed immediately during command
123			line parsing, so specify it after
124			.B "Compile-Time Options"
125			and
126			.BR "Run-Time Options" .
127			.SH ARGUMENTS
128			.TP 8
129			.RI scriptfile
130			Externally passed JavaScript script to execute.
131			This is executed after command line parsing
132			(and this way after scripts of options
133			.BR -e " and " -f
134			were executed.
135			This additional way of executing an external JavaScript
136			script exists to especially support Unix "shebang"
137			style scripts.
138			.TP 8
139			.IR scriptarg
140			Zero or more arguments which are passed to the executed
141			.IR scriptfile .
142			They are available in the script through the global
143			array object
144			.BR arguments .
145			.SH SEE ALSO
146			.BR js ( 3 ),
147			.BR js-config ( 1 )
148			.PP
149			.RS 0
150			http://www.mozilla.org/js/spidermonkey/
151			.RE
152			.RS 0
153			http://www.ossp.org/pkg/lib/js/
154			.RE
155			.SH AUTHOR
156			The author of the
157			.B Mozilla JavaScript
158			language implementation ("SpiderMonkey") is
159			.I Brendan Eich
160			from the
161			.IR "Mozilla Foundation" .
162			This manual page was written by
163			.I Ralf S. Engelschall
164			for the
165			.B OSSP js
166			distribution of
167			.BR "Mozilla JavaScript" .