diff options
Diffstat (limited to 'docs/man/fsc.1')
-rw-r--r-- | docs/man/fsc.1 | 148 |
1 files changed, 148 insertions, 0 deletions
diff --git a/docs/man/fsc.1 b/docs/man/fsc.1 new file mode 100644 index 0000000000..8b42952a6b --- /dev/null +++ b/docs/man/fsc.1 @@ -0,0 +1,148 @@ +.\" ########################################################################## +.\" # __ # +.\" # ________ ___ / / ___ Scala 2 On-line Manual Pages # +.\" # / __/ __// _ | / / / _ | (c) 2002-2007, LAMP/EPFL # +.\" # __\ \/ /__/ __ |/ /__/ __ | # +.\" # /____/\___/_/ |_/____/_/ | | http://scala-lang.org/ # +.\" # |/ # +.\" ########################################################################## +.\" +.\" Process this file with nroff -man scala.1 +.\" +.TH fsc 1 "January 18, 2007" "version 0.4" "USER COMMANDS" +.\" +.\" ############################## NAME ############################### +.\" +.SH NAME +.PP +\fBfsc\fR \- Fast offline compiler for the Scala 2 language +.\" +.\" ############################## SYNOPSIS ############################### +.\" +.SH SYNOPSIS +.PP +\fBfsc\fR [ <\fIoptions\fR> ] <\fIsource files\fR> +.\" +.\" ############################## PARAMETERS ############################### +.\" +.SH PARAMETERS +.PP +.TP +<\fIoptions\fR> +Command line options. See \fBOPTIONS\fR below. +.TP +<\fIsource files\fR> +One or more source files to be compiled (such as MyClass.scala). +.\" +.\" ############################## OPTIONS ############################### +.\" +.SH OPTIONS +.PP +The offline compiler supports all options of \fBscalac\fR plus the following: +.PP +.TP +\fB\-reset\fR +Reset compile server caches. +.TP +\fB\-shutdown\fR +Shut down the compilation daemon. The daemon attempts to restart itself as necessary, but sometimes an explicit shutdown is required. A common example is if jars on the class path have changed. +.TP +\fB\-server\fR <\fIhostname:portnumber\fR> +Specify compile server host at port number. Usually this option is not needed. Note that the hostname must be for a host that shares the same filesystem. +.TP +\fB\-J\fR <\fIflag\fR> +Pass <flag> directly to the Java VM for the compilation daemon. +.\" +.\" ############################## DESCRIPTION ############################### +.\" +.SH DESCRIPTION +.PP +The \fBfsc\fR tool submits Scala compilation jobs to a compilation daemon. The first time it is executed, the daemon is started automatically. On subsequent runs, the same daemon can be reused, thus resulting in a faster compilation. The tool is especially effective when repeatedly compiling with the same class paths, because the compilation daemon can reuse a compiler instance. +.PP +The compilation daemon is smart enough to flush its cached compiler when the class path changes. However, if the contents of the class path change, for example due to upgrading a library, then the daemon should be explicitly shut down with \fB-shutdown\fR. +.PP +Note that the \fBscala\fR script runner will also use the offline compiler by default, with the same advantages and caveats. +.\" +.\" ############################## EXAMPLE ############################### +.\" +.SH EXAMPLE +.PP +The following session shows a typical speed up due to using the offline compiler. + +.nf +> fsc -verbose -d /tmp test.scala +... +[Port number: 32834] +[Starting new Scala compile server instance] +[Classpath = ...] +[loaded directory path ... in 692ms] +... +[parsing test.scala] +... +[total in 943ms] + +> fsc -verbose -d /tmp test.scala +... +[Port number: 32834] +[parsing test.scala] +... +[total in 60ms] + +> fsc -verbose -d /tmp test.scala +... +[Port number: 32834] +[parsing test.scala] +... +[total in 42ms] + +> fsc -verbose -shutdown +[Scala compile server exited] + +.fi +.\" +.\" ############################## ENVIRONMENT ############################### +.\" +.SH ENVIRONMENT +.PP +.TP +\fBJAVACMD\fR +Specify the \fBjava\fR command to be used for running the Scala code. Arguments may be specified as part of the environment variable; spaces, quotation marks, etc., will be passed directly to the shell for expansion. +.TP +\fBJAVA_OPTS\fR +Specify the options to be passed to the \fBjava\fR command defined by \fBJAVACMD\fR. +.IP +With Java 1.5 (or newer) one may for example configure the memory usage of the JVM as follows: JAVA_OPTS="-Xmx512M -Xms16M -Xss16M" +.IP +With GNU Java one may configure the memory usage of the GIJ as follows: JAVA_OPTS="--mx512m --ms16m" +.IP + +.\" +.\" ############################## EXIT STATUS ############################### +.\" +.SH "EXIT STATUS" +.PP +\fBfsc\fR returns a zero exit status if it succeeds to compile the specified input files. Non zero is returned in case of failure. +.\" +.\" ############################## AUTHOR ############################### +.\" +.SH AUTHOR +.PP +Written by Martin Odersky and other members of the Scala team. +.\" +.\" ############################## REPORTING BUGS ############################### +.\" +.SH "REPORTING BUGS" +.PP +Report bugs to <scala@listes.epfl.ch>. +.\" +.\" ############################## COPYRIGHT ############################### +.\" +.SH COPYRIGHT +.PP +This is open-source software, available to you under a BSD-like license. See accomponying "copyright" or "LICENSE" file for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +.\" +.\" ############################## SEE ALSO ############################### +.\" +.SH "SEE ALSO" +.PP +\fBsbaz\fR(1), \fBscala\fR(1), \fBscalac\fR(1), \fBscaladoc\fR(1), \fBscalap\fR(1) |