summaryrefslogtreecommitdiff
path: root/doc/man/man1/scala.1
blob: 4fc89e86e45befb40025616e2baeee5c32067595 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
.\" ##########################################################################
.\" #                      __                                                #
.\" #      ________ ___   / /  ___     Scala On-line Manual Pages            #
.\" #     / __/ __// _ | / /  / _ |    (c) 2002-2005, LAMP/EPFL              #
.\" #   __\ \/ /__/ __ |/ /__/ __ |                                          #
.\" #  /____/\___/_/ |_/____/_/ | |    http://scala.epfl.ch/                 #
.\" #                           |/                                           #
.\" ##########################################################################
.\"
.\" Process this file with nroff -man scala.1
.\"
.TH scala 1  "April 29, 2005" "version 0.1" "USER COMMANDS"
.\"
.\" ################################# NAME ###################################
.\"
.SH NAME
scala \- Launcher for the Scala language
.\"
.\" ############################### SYNOPSIS #################################
.\"
.SH SYNOPSIS
\fBscala\fR [ <\fIoptions\fR> ] <\fIclass file\fR> [ <\fIargs\fR> ]
.\"
.\" ############################### PARAMETERS ###############################
.\"
.SH PARAMETERS
.TP
<\fIoptions\fR>
Command line options. See \fBOPTIONS\fR below.
.TP
<\fIclass file\fR>
Name of the class to be invoked.
.TP
<\fIargs\fR>
Program arguments passed to the main function.
.\"
.\" ############################## DESCRIPTION ###############################
.\"
.SH DESCRIPTION
The \fBscala\fR utility launches a Scala application. It does this by starting
a Java runtime environment, loading a specified class, and invoking that
class’s \fBmain\fR method. The method must have the following signature:
.PP
          \fBdef\fR main(args: Array[String]): Unit
.PP
The method must return a \fBUnit\fR value, and it must accept a \fBString\fR
array as a parameter. By default, the first non-option argument is the name
of the class to be invoked. A fully-qualified class name should be used.
.PP
The Scala runtime searches for the startup class, and other classes used, in
three sets of locations: the bootstrap class path, the installed extensions,
and the user class path.
.\"
.\" ############################### OPTIONS ##################################
.\"
.SH OPTIONS
The launcher has a set of standard options that are supported on the current
runtime environment and will be supported in future releases. An additional
set of non-standard options are specific to the current virtual machine
implementation and are subject to change in the future. Non-standard options
begin with \fB-X\fR.
.SS Standard Options
.TP
\fB\-cp -classpath\fR <\fIpath\fR>
Specify where to find user class files (on Unix-based systems a
colon-separated list of paths, on Windows-based systems, a semicolon-separate
list of paths).
.TP
\fB\-D\fR<\fIname\fR>=<\fIvalue\fR>
Set a system property.
.TP
\fB\-verbose\fR[:class|gc|jni]
Enable verbose output.
.TP
\fB\-showversion\fR
Print product version and continue.
.TP
\fB\-version\fR
Print product version and exit.
.TP
\fB\-help\fR
Print this help message.
.SS Non-Standard Options
Same options as the \fBjava\fR command.
.\"
.\" ############################### EXAMPLES #################################
.\"
.SH EXAMPLES
.TP
Execute a Scala program generated in the current directory
.BR
\fBscala\fR HelloWorld
.PP
.TP
Execute a Scala program generated in a user-defined directory \fBclasses\fR
.BR
\fBscala\fR \-classpath classes hello.HelloWorld
.PP
.\"
.\" ############################# EXIT STATUS ################################
.\"
.SH "EXIT STATUS"
\fBscala\fR returns a zero exit status if it succeeds. Non zero is returned
in case of failure.
.\"
.\" ############################## AUTHOR(S) #################################
.\"
.SH AUTHOR
Written by Stephane Micheloud.
.\"
.\" ################################ BUGS ####################################
.\"
.SH "REPORTING BUGS"
Report bugs to <scala@lists.epfl.ch>.
.\"
.\" ############################# COPYRIGHT ##################################
.\"
.SH COPYRIGHT
Copyright \(co 2002-2005 LAMP/EPFL
.PP
This is free software; see the distribution for copying conditions.  There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.\"
.\" ############################### SEE ALSO #################################
.\"
.SH "SEE ALSO"
.BR scalac(1),
.BR scaladoc(1),
.BR scalaint(1),
.BR scalarun(1)
.\"
.\" ##########################################################################
.\" $Id$