sbt, the interactive build tool
Go to file
Eugene Yokota 91a639ff77 Drop -XX:+UseParallelGC
Fixes https://github.com/sbt/sbt/issues/5045

Currently we set `-XX:+UseParallelGC` for JDK greater than 9. This isn't a great default because while the peak throughput is somewhat better than the default g1 collector, the worst case performance is really bad with UseParallelGC, especially when the heap size is large.

Given the sudden diversification of JDK implementations, we should stay clear from `-XX` flags, and let the build users add them if they must.
2019-09-17 23:32:06 -04:00
.github/ISSUE_TEMPLATE Fix typo in no-new-issues.md 2019-08-03 08:33:10 +01:00
bin export repo using Coursier (#267) 2019-05-15 10:52:39 -04:00
citest Reproduce JDK 11 warning 2019-09-05 22:53:03 -04:00
integration-test/src/test/scala Add integration tests 2019-09-13 23:11:48 -07:00
java9-rt-export/src/main/java/io/github/retronym/java9rtexport Whitelist java9-rt-ext- output in rt export process 2018-02-12 09:20:30 -08:00
project Fix dangling ivy.xml without JAR files 2019-05-09 23:17:22 -04:00
src Drop -XX:+UseParallelGC 2019-09-17 23:32:06 -04:00
upload Allow env vars defaults, rename S3 vars 2018-05-07 17:17:29 +02:00
.appveyor.yml Remove -XX:MaxPermSize out of Windows default 2019-05-22 17:32:13 -04:00
.gitattributes Windows config now works. Still an issue with sbt.bat not setting up paths/temp files correctly.... 2012-09-22 10:12:03 -04:00
.gitignore cross JVM testing 2018-02-15 00:42:01 -05:00
.java-version add JDK 9 support 2017-02-15 04:57:47 -05:00
.travis.yml Add names to the Travis CI jobs 2019-09-05 16:03:14 -04:00
CONTRIBUTING.md Update sbt.build.version in CONTRIBUTING too. 2017-11-16 11:02:18 +00:00
LICENSE Apache License 2.0 2019-04-05 09:25:06 -04:00
NOTICE Apache License 2.0 2019-04-05 09:25:06 -04:00
README.md Add -V|-version to print sbtVersion. 2019-07-18 16:23:14 +09:00
build.sbt export repo using Coursier (#267) 2019-05-15 10:52:39 -04:00

README.md

sbt: the launcher script

This is a launcher script for running sbt.

Current -help output:

Usage: sbt [options]

  -h | -help         print this message
  -v | -verbose      this runner is chattier
  -V | -version      print the version of mothership sbt
  -d | -debug        set sbt log level to debug
  -no-colors         disable ANSI color codes
  -sbt-create        start sbt even if current directory contains no sbt project
  -sbt-dir   <path>  path to global settings/plugins directory (default: ~/.sbt)
  -sbt-boot  <path>  path to shared boot directory (default: ~/.sbt/boot in 0.11 series)
  -ivy       <path>  path to local Ivy repository (default: ~/.ivy2)
  -mem    <integer>  set memory options (default: 1024, which is -Xms1024m -Xmx1024m -XX:ReservedCodeCacheSize=128m)
  -no-share          use all local caches; no sharing
  -no-global         uses global caches, but does not use global ~/.sbt directory.
  -jvm-debug <port>  Turn on JVM debugging, open at the given port.
  -batch             Disable interactive mode

  # sbt version (default: from project/build.properties if present, else latest release)
  -sbt-version  <version>   use the specified version of sbt
  -sbt-jar      <path>      use the specified jar as the sbt launcher
  -sbt-rc                   use an RC version of sbt
  -sbt-snapshot             use a snapshot version of sbt

  # java version (default: java from PATH, currently openjdk version "1.8.0_172")
  -java-home <path>         alternate JAVA_HOME

  # jvm options and output control
  JAVA_OPTS          environment variable, if unset uses ""
  .jvmopts           if this file exists in the current directory, its contents
                     are appended to JAVA_OPTS
  SBT_OPTS           environment variable, if unset uses ""
  .sbtopts           if this file exists in the current directory, its contents
                     are prepended to the runner args
  /etc/sbt/sbtopts   if this file exists, it is prepended to the runner args
  -Dkey=val          pass -Dkey=val directly to the java runtime
  -J-X               pass option -X directly to the java runtime
                     (-J is stripped)
  -S-X               add -X to sbt's scalacOptions (-S is stripped)

Native packages

This project also includes native packages to run sbt for

  • Windows
  • RedHat (rpm)
  • Debian (deb)

Locations for download to be available soon.

Build status

Build Status Build Status