sbt/README.md

sbt: the rebel cut

An alternative script for running sbt 0.10+. There's also a template project sbt coming together, but it's unfinished. However the runner is quite useful already.

Here's a sample first run, which creates a new project using a snapshot version of sbt, and runs the sbt "about" command.

% sbt -debug -snapshot -create about
# Executing command line:
java
-Xss2m
-Xms256M
-Xmx1536M
-XX:MaxPermSize=256M
-XX:+CMSClassUnloadingEnabled
-XX:MaxPermSize=512m
-Xmx2g
-Xss2m
-jar
/r/sbt-extras/.lib/0.11.0-20110825-052147/sbt-launch.jar
"set logLevel in Global := Level.Debug"
"iflast shell"
about

Getting net.java.dev.jna jna 3.2.3 ...
:: retrieving :: org.scala-tools.sbt#boot-app
	confs: [default]
	1 artifacts copied, 0 already retrieved (838kB/15ms)
Getting Scala 2.9.1.RC4 (for sbt)...
:: retrieving :: org.scala-tools.sbt#boot-scala
	confs: [default]
	4 artifacts copied, 0 already retrieved (19939kB/97ms)
Getting org.scala-tools.sbt sbt_2.9.1.RC4 0.11.0-20110825-052147 ...
:: retrieving :: org.scala-tools.sbt#boot-app
	confs: [default]
	38 artifacts copied, 0 already retrieved (6948kB/71ms)
[info] Set current project to default-06d8dd (in build file:/private/tmp/sbt-project/)
[info] Reapplying settings...
[info] Set current project to default-06d8dd (in build file:/private/tmp/sbt-project/)
[info] This is sbt 0.11.0-20110825-052147
[info] The current project is {file:/private/tmp/sbt-project/}default-06d8dd
[info] The current project is built against Scala 2.9.1.RC4
[info] sbt, sbt plugins, and build definitions are using Scala 2.9.1.RC4
[info] All logging output for this session is available at /var/folders/iO/iOpjflOpHzG8Mr1BL67D6k+++TI/-Tmp-/sbt75419762724938334.log

Current -help output:

% ./sbt -help

Usage: sbt [options]

  -help           prints this message
  -v | -verbose   this runner is chattier
  -debug          set sbt log level to debug
  -nocolors       disable ANSI color codes
  -create         start sbt even in a directory with no project
  -sbtjar <path>  location of sbt launcher (default: ./.lib/<sbt version>/sbt-launch.jar)
  -sbtdir <path>  location of global settings and plugins (default: ~/.sbt)
     -ivy <path>  local Ivy repository (default: ~/.ivy2)
  -shared <path>  shared sbt boot directory (default: none, no sharing)

  # setting scala and sbt versions
  -28           set scala version to 2.8.2.RC1
  -29           set scala version to 2.9.1.RC4
  -210          set scala version to 2.10.0-SNAPSHOT
  -local <path> set scala version to local installation at path
  -snapshot     use a snapshot of sbt (otherwise, latest released version)

  # jvm options and output control
  JAVA_OPTS     environment variable, if unset uses "-Dfile.encoding=UTF8"
  SBT_OPTS      environment variable, if unset uses "-XX:+CMSClassUnloadingEnabled -XX:MaxPermSize=512m -Xmx2g -Xss2m"
  .sbtopts      file in sbt root directory, if present contents passed to sbt
  -Dkey=val     pass -Dkey=val directly to the jvm
  -J-X          pass option -X directly to the jvm (-J is stripped)

In the case of duplicated or conflicting options, the order above
shows precedence: JAVA_OPTS lowest, command line options highest.