head	1.7;
access;
symbols
	OSSP_JS_1_6_20070208:1.7
	OSSP_JS_1_6_20060820:1.7
	OSSP_JS_1_6_20060803:1.7
	OSSP_JS_1_6_20060731:1.7
	OSSP_JS_1_6_20060730:1.7
	OSSP_JS_1_6_20060729:1.7
	OSSP_JS_1_6_20060724:1.7
	OSSP_JS_1_6_20060722:1.7;
locks; strict;
comment	@.\" @;


1.7
date	2006.07.23.08.30.45;	author rse;	state Exp;
branches;
next	1.6;
commitid	UT4DTzYhAio1EXFr;

1.6
date	2006.07.23.08.00.43;	author rse;	state Exp;
branches;
next	1.5;
commitid	VL1SmkRG7aHItXFr;

1.5
date	2006.07.22.19.18.25;	author rse;	state Exp;
branches;
next	1.4;
commitid	uOIqoO0olsUcgTFr;

1.4
date	2006.07.22.19.10.06;	author rse;	state Exp;
branches;
next	1.3;
commitid	3ZSmoOrpXiUldTFr;

1.3
date	2006.07.22.18.57.09;	author rse;	state Exp;
branches;
next	1.2;
commitid	Z6nIAVinCotU8TFr;

1.2
date	2006.07.22.18.52.50;	author rse;	state Exp;
branches;
next	1.1;
commitid	QTHM2V6CooEq7TFr;

1.1
date	2006.07.22.11.04.43;	author rse;	state Exp;
branches;
next	;
commitid	DeAm5kOtHjOPwQFr;


desc
@@


1.7
log
@remove one more fixme
@
text
@.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.6
log
@provide js-config script
@
text
@d79 4
a82 2
Sets the global object????
FIXME
@


1.5
log
@give Brendan Eich credit
@
text
@d80 1
d144 2
a145 1
.BR js ( 3 )
@


1.4
log
@install also a short manual page which guides to the reference documentation
@
text
@d154 3
a156 1
language implementation ("SpiderMonkey") is the 
@


1.3
log
@cleanups
@
text
@d29 6
a34 1
is a command line interface to the Mozilla JavaScript interpreter engine.
d143 2
d152 10
a161 2
The author of the Mozilla JavaScript implementation ("SpiderMonkey") is the Mozilla Foundation.
This manual page was written by Ralf S. Engelschall for the OSSP project.
@


1.2
log
@first cut for a real manual page
@
text
@d127 3
d138 1
a138 1
.TP 0
d140 2
a141 1
.TP 0
d143 1
@


1.1
log
@add our own files
@
text
@d1 141
a141 1
FIXME
@