1scalac(1) USER COMMANDS scalac(1)
2
6 scalac - Compiler for the Scala 2 language
7
9 scalac [ <options> ] <source files>
10
12 <options>
13 Command line options. See OPTIONS below.
14 <source files>
16 One or more source files to be compiled (such as MyClass.scala).
17
19 The compiler has a set of standard options that are supported on the
20 current development environment and will be supported in future
21 releases. An additional set of non-standard options are specific to the
22 current virtual machine implementation and are subject to change in the
23 future. Non-standard options begin with -X.
24 Standard Options
26 -g:{none,source,line,vars,notc}
27 "none" generates no debugging info,
28 "source" generates only the source file attribute,
30 "line" generates source and line number information,
32 "vars" generates source, line number and local variable informa‐
34 tion,
35 "notc" generates all of the above and will not perform tail call
37 optimization.
38 -nowarn
40 Generate no warnings
41 -verbose
43 Output messages about what the compiler is doing
44 -deprecation
46 Indicate whether source should be compiled with deprecation
47 information; defaults to off (accepted values are: on, off, yes
48 and no)
49 Available since Scala version 2.2.1
51 -unchecked
53 Enable detailed unchecked warnings
54 Non variable type-arguments in type patterns are unchecked since
56 they are eliminated by erasure
57 Available since Scala version 2.3.0
59 -classpath <path>
61 Specify where to find user class files (on Unix-based systems a
62 colon-separated list of paths, on Windows-based systems, a semi‐
63 colon-separate list of paths). This does not override the built-
64 in ("boot") search path.
65 The default class path is the current directory. Setting the
67 CLASSPATH variable or using the -classpath command-line option
68 overrides that default, so if you want to include the current
69 directory in the search path, you must include "." in the new
70 settings.
71 -sourcepath <path>
73 Specify where to find input source files.
74 -bootclasspath <path>
76 Override location of bootstrap class files (where to find the
77 standard built-in classes, such as "scala.List").
78 -extdirs <dirs>
80 Override location of installed extensions.
81 -d <directory>
83 Specify where to place generated class files.
84 -encoding <encoding>
86 Specify character encoding used by source files.
87 The default value is platform-specific (Linux: "UTF8", Windows:
89 "Cp1252"). Executing the following code in the Scala interpreter
90 will return the default value on your system:
91 scala> new java.io.InputStreamReader(System.in).getEncoding
93 -target: <target>
95 Specify which backend to use (jvm-1.5,msil).
96 The default value is "jvm-1.5" (was "jvm-1.4" up to Scala ver‐
98 sion 2.6.1).
99 -print Print program with all Scala-specific features removed
101 -optimise
103 Generates faster bytecode by applying optimisations to the pro‐
104 gram
105 -explaintypes
107 Explain type errors in more detail.
108 -uniqid
110 Print identifiers with unique names (debugging option).
111 -version
113 Print product version and exit.
114 -help Print a synopsis of standard options.
116 Advanced Options
118 -Xassem <file>
119 Name of the output assembly (only relevant with -target:msil)
120 -Xassem-path <path>
122 List of assemblies referenced by the program (only relevant with
123 -target:msil)
124 -Xcheck-null
126 Emit warning on selection of nullable reference
127 -Xdisable-assertions
129 Generate no assertions and assumptions
130 -Xexperimental
132 enable experimental extensions
133 -Xno-uescape
135 Disable handling of \u unicode escapes
136 -Xplug-types
138 Parse but ignore annotations in more locations
139 -Xplugin: <file>
141 Load a plugin from a file
142 -Xplugin-disable: <plugin>
144 Disable a plugin
145 -Xplugin-list
147 Print a synopsis of loaded plugins
148 -Xplugin-opt: <plugin:opt>
150 Pass an option to a plugin
151 -Xplugin-require: <plugin>
153 Abort unless a plugin is available
154 -Xprint: <phases>
156 Print out program after <phases> (see below).
157 -Xprint-pos
159 Print tree positions (as offsets)
160 -Xprint-types
162 Print tree types (debugging option).
163 -Xprompt
165 Display a prompt after each error (debugging option).
166 -Xresident
168 Compiler stays resident, files to compile are read from standard
169 input.
170 -Xshow-class <class>
172 Show class info.
173 -Xshow-object <object>
175 Show object info.
176 -Xshow-phases
178 Print a synopsis of compiler phases.
179 -Xsource-reader <classname>
181 Specify a custom method for reading source files.
182 -Xscript <object>
184 Compile as a script, wrapping the code into object.main().
185 Compilation Phases
187 initial
188 initializing compiler
189 parse parse source files
191 namer create symbols
193 analyze
195 name and type analysis
196 refcheck
198 reference checking
199 uncurry
201 uncurry function types and applications
202 transmatch
204 translate match expressions
205 lambdalift
207 lambda lifter
208 typesasvalues
210 represent types as values
211 addaccessors
213 add accessors for constructor arguments
214 explicitouterclasses
216 make links from inner classes to enclosing one explicit
217 addconstructors
219 add explicit constructor for each class
220 tailcall
222 add tail-calls
223 wholeprog
225 perform whole program analysis
226 addinterfaces
228 add one interface per class
229 expandmixins
231 expand mixins by code copying
232 boxing makes boxing explicit
234 erasure
236 type eraser
237 icode generate icode
239 codegen
241 enable code generation
242 terminal
244 compilation terminated
245 all matches all phases
247
249 JAVACMD
250 Specify the java command to be used for running the Scala code.
251 Arguments may be specified as part of the environment variable;
252 spaces, quotation marks, etc., will be passed directly to the
253 shell for expansion.
254 JAVA_HOME
256 Specify JDK/JRE home directory. This directory is used to locate
257 the java command unless JAVACMD variable set.
258 JAVA_OPTS
260 Specify the options to be passed to the java command defined by
261 JAVACMD.
262 With Java 1.5 (or newer) one may for example configure the mem‐
264 ory usage of the JVM as follows: JAVA_OPTS="-Xmx512M -Xms16M
265 -Xss16M"
266 With GNU Java one may configure the memory usage of the GIJ as
268 follows: JAVA_OPTS="--mx512m --ms16m"
269
271 Compile a Scala program to the current directory
272 scalac HelloWorld
273 Compile a Scala program to the destination directory classes
275 scalac -d classes HelloWorld.scala
276 Compile a Scala program using a user-defined java command
278 env JAVACMD=/usr/local/bin/cacao scalac -d classes Hel‐
279 loWorld.scala
280 Compile all Scala files found in the source directory src to the desti‐
282 nation directory classes
283 scalac -d classes src/*.scala
284
286 scalac returns a zero exist status if it succeeds to compile the speci‐
287 fied input files. Non zero is returned in case of failure.
288
290 Written by Martin Odersky and other members of the Scala team.
291
293 Report bugs to http://lampsvn.epfl.ch/trac/scala.
294
296 This is open-source software, available to you under a BSD-like
297 license. See accomponying "copyright" or "LICENSE" file for copying
298 conditions. There is NO warranty; not even for MERCHANTABILITY or FIT‐
299 NESS FOR A PARTICULAR PURPOSE.
300
302 fsc(1), sbaz(1), scala(1), scaladoc(1), scalap(1)
303version 0.4 April 18, 2007 scalac(1)