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	.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" .