scalac1

Compiler for the scala 2 language

Usage

scalac [<options>] <source files>

Parameters

`<options>`	Command line options. See OPTIONS below.
`<source files>`	One or more source files to be compiled (such as MyClass.scala).

Options

The compiler has a set of standard options that are supported on the current development 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 -X.

Standard Options

-g:{none,source,line,vars,notc}: "none" generates no debugging info,

: "source" generates only the source file attribute,

: "line" generates source and line number information,

: "vars" generates source, line number and local variable information,

: "notc" generates all of the above and will not perform tail call optimization.

-nowarn: Generate no warnings

-verbose: Output messages about what the compiler is doing

-deprecation: Indicate whether source should be compiled with deprecation information; defaults to off (accepted values are: on, off, yes and no)

: Available since Scala version 2.2.1

-unchecked: Enable detailed unchecked warnings

: Non variable type-arguments in type patterns are unchecked since they are eliminated by erasure

: Available since Scala version 2.3.0

-classpath <path>: 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). This does not override the built-in ("boot") search path.

: The default class path is the current directory. Setting the CLASSPATH variable or using the -classpath command-line option overrides that default, so if you want to include the current directory in the search path, you must include "." in the new settings.

-sourcepath <path>: Specify where to find input source files.

-bootclasspath <path>: Override location of bootstrap class files (where to find the standard built-in classes, such as "scala.List").

-extdirs <dirs>: Override location of installed extensions.

-d <directory>: Specify where to place generated class files.

-encoding <encoding>: Specify character encoding used by source files.

: The default value is platform-specific (Linux: "UTF8", Windows: "Cp1252"). Executing the following code in the Scala interpreter will return the default value on your system:

: scala> new java.io.InputStreamReader(System.in).getEncoding

-target: <target>: Specify which backend to use (jvm-1.5,msil).

: The default value is "jvm-1.5" (was "jvm-1.4" up to Scala version 2.6.1).

-print: Print program with all Scala-specific features removed

-optimise: Generates faster bytecode by applying optimisations to the program

-explaintypes: Explain type errors in more detail.

-uniqid: Print identifiers with unique names (debugging option).

-version: Print product version and exit.

-help: Print a synopsis of standard options.

Advanced Options

-Xassem <file>: Name of the output assembly (only relevant with -target:msil)

-Xassem-path <path>: List of assemblies referenced by the program (only relevant with -target:msil)

-Xcheck-null: Emit warning on selection of nullable reference

-Xdisable-assertions: Generate no assertions and assumptions

-Xexperimental: enable experimental extensions

-Xno-uescape: Disable handling of \u unicode escapes

-Xplug-types: Parse but ignore annotations in more locations

`-Xplugin: <file>`	Load a plugin from a file
`-Xplugin-disable: <plugin>`	Disable a plugin

-Xplugin-list: Print a synopsis of loaded plugins

`-Xplugin-opt: <plugin:opt>`	Pass an option to a plugin
`-Xplugin-require: <plugin>`	Abort unless a plugin is available
`-Xprint: <phases>`	Print out program after <phases> (see below).

-Xprint-pos: Print tree positions (as offsets)

-Xprint-types: Print tree types (debugging option).

-Xprompt: Display a prompt after each error (debugging option).

-Xresident: Compiler stays resident, files to compile are read from standard input.

-Xshow-class <class>: Show class info.

-Xshow-object <object>: Show object info.

-Xshow-phases: Print a synopsis of compiler phases.

-Xsource-reader <classname>: Specify a custom method for reading source files.

-Xscript <object>: Compile as a script, wrapping the code into object.main().

Compilation Phases

`initial`	initializing compiler
`parse`	parse source files
`namer`	create symbols
`analyze`	name and type analysis
`refcheck`	reference checking
`uncurry`	uncurry function types and applications
`lambdalift`	lambda lifter
`typesasvalues`	represent types as values
`addaccessors`	add accessors for constructor arguments
`explicitouterclasses`	make links from inner classes to enclosing one explicit
`addconstructors`	add explicit constructor for each class
`tailcall`	add tail-calls
`wholeprog`	perform whole program analysis
`addinterfaces`	add one interface per class
`expandmixins`	expand mixins by code copying
`boxing`	makes boxing explicit
`erasure`	type eraser
`icode`	generate icode
`codegen`	enable code generation
`terminal`	compilation terminated
`all`	matches all phases

Environment

JAVACMD: Specify the java 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.

JAVA_HOME: Specify JDK/JRE home directory. This directory is used to locate the java command unless JAVACMD variable set.

JAVA_OPTS: Specify the options to be passed to the java command defined by JAVACMD.

: With Java 1.5 (or newer) one may for example configure the memory usage of the JVM as follows: JAVA_OPTS="-Xmx512M -Xms16M -Xss16M"

: With GNU Java one may configure the memory usage of the GIJ as follows: JAVA_OPTS="--mx512m --ms16m"

Examples

`Compile a Scala program to the current directory`	`scalac` HelloWorld
`Compile a Scala program to the destination directory classes`	`scalac` `-d` classes HelloWorld.scala
`Compile a Scala program using a user-defined java command`	env JAVACMD=/usr/local/bin/cacao `scalac` `-d` classes HelloWorld.scala
`Compile all Scala files found in the source directory src to the destination directory classes`	`scalac` `-d` classes src/*.scala

Exit status

scalac returns a zero exist status if it succeeds to compile the specified input files. Non zero is returned in case of failure.

Releases

4 releases since Debian 4.0 (Etch); the text changed 2 times.

-Xassem since Debian 6.0 (Squeeze); -Xassem-path since Debian 6.0 (Squeeze); -Xcheck-null since Debian 6.0 (Squeeze); -Xdisable-assertions since Debian 6.0 (Squeeze); -Xexperimental since Debian 6.0 (Squeeze); -Xno-uescape since Debian 6.0 (Squeeze); -Xplug-types since Debian 6.0 (Squeeze); -Xplugin-list since Debian 6.0 (Squeeze); -Xprint-pos since Debian 6.0 (Squeeze); -Xprint-types since Debian 6.0 (Squeeze); -Xprompt since Debian 6.0 (Squeeze); -Xresident since Debian 6.0 (Squeeze); -Xscript since Debian 6.0 (Squeeze); -Xshow-class since Debian 6.0 (Squeeze); -Xshow-object since Debian 6.0 (Squeeze); -Xshow-phases since Debian 6.0 (Squeeze); -Xsource-reader since Debian 6.0 (Squeeze); -optimise since Debian 6.0 (Squeeze); -print since Debian 6.0 (Squeeze); -unchecked since Debian 6.0 (Squeeze).

-? until Debian 4.0 (Etch); -Xcloselim until Debian 4.0 (Etch); -Xgenerics until Debian 4.0 (Etch); -Xinline until Debian 4.0 (Etch); -Xlinearizer until Debian 4.0 (Etch); -Xshowcls until Debian 4.0 (Etch); -Xshowicode until Debian 4.0 (Etch); -Xshowobj until Debian 4.0 (Etch); -debug until Debian 4.0 (Etch); -g until Debian 4.0 (Etch); -migrate until Debian 4.0 (Etch); -noimports until Debian 4.0 (Etch); -nopredefs until Debian 4.0 (Etch); -nouescape until Debian 4.0 (Etch); -print-file until Debian 4.0 (Etch); -printtypes until Debian 4.0 (Etch); -prompt until Debian 4.0 (Etch); -resident until Debian 4.0 (Etch); -statistics until Debian 4.0 (Etch).