compiler-options.yml

- category: "Standard Settings"
description: "A set of standard options that are supported on the current development environment and will be supported in future releases."
options:
 - option: "-Dproperty=value"
schema:
type: "Prefix"
description: "Pass -Dproperty=value directly to the runtime system."
 - option: "-J<flag>"
schema:
type: "Prefix"
description: "Pass flag directly to the runtime system."
 - option: "-P"
schema:
type: "String"
arg: "plugin:opt"
multiple: "true"
description: "Pass an option to a plugin"
 - option: "-V"
schema:
type: "Boolean"
description: "Print a synopsis of verbose options."
 - option: "-W"
schema:
type: "Boolean"
description: "Print a synopsis of warning options."
 - option: "-Werror"
schema:
type: "Boolean"
description: "Fail the compilation if there are any warnings."
abbreviations:
 - "-Xfatal-warnings"
 - option: "-X"
schema:
type: "Boolean"
description: "Print a synopsis of advanced options."
 - option: "-Y"
schema:
type: "Boolean"
description: "Print a synopsis of private options."
 - option: "-bootclasspath"
schema:
type: "Path"
arg: "path"
default:
description: "Override location of bootstrap class files."
abbreviations:
 - "--boot-class-path"
 - option: "-classpath"
schema:
type: "Path"
arg: "path"
default: "."
description: "Specify where to find user class files."
abbreviations:
 - "-cp"
 - "--class-path"
 - option: "-d"
schema:
type: "String"
arg: "directory|jar"
default: "."
description: "destination for generated classfiles."
 - option: "-dependencyfile"
schema:
type: "String"
arg: "file"
default: ".scala_dependencies"
description: "Set dependency tracking file."
abbreviations:
 - "--dependency-file"
 - option: "-deprecation"
schema:
type: "Boolean"
description: "Emit warning and location for usages of deprecated APIs."
abbreviations:
 - "--deprecation"
 - option: "-encoding"
schema:
type: "String"
arg: "encoding"
default: "UTF-8"
description: "Specify character encoding used by source files."
abbreviations:
 - "--encoding"
 - option: "-explaintypes"
schema:
type: "Boolean"
description: "Explain type errors in more detail."
abbreviations:
 - "--explain-types"
 - option: "-extdirs"
schema:
type: "Path"
arg: "path"
default:
description: "Override location of installed extensions."
abbreviations:
 - "--extension-directories"
 - option: "-feature"
schema:
type: "Boolean"
description: "Emit warning and location for usages of features that should be imported explicitly."
abbreviations:
 - "--feature"
 - option: "-g"
schema:
type: "Choice"
arg: "level"
default: "vars"
choices:
 - choice: "none"
 - choice: "source"
 - choice: "line"
 - choice: "vars"
 - choice: "notailcalls"
description: "Set level of generated debugging info. (none,source,line,[vars],notailcalls)"
 - option: "-help"
schema:
type: "Boolean"
description: "Print a synopsis of standard options"
abbreviations:
 - "--help"
 - option: "-javabootclasspath"
schema:
type: "Path"
arg: "path"
default: ""
description: "Override java boot classpath."
abbreviations:
 - "--java-boot-class-path"
 - option: "-javaextdirs"
schema:
type: "Path"
arg: "path"
default:
description: "Override java extdirs classpath."
abbreviations:
 - "--java-extension-directories"
 - option: "-language"
schema:
type: "Choice"
arg: "feature"
multiple: "true"
choices:
 - choice: "dynamics"
description: "Allow direct or indirect subclasses of scala.Dynamic"
 - choice: "existentials"
description: "Existential types (besides wildcard types) can be written and inferred"
 - choice: "higherKinds"
description: "Allow higher-kinded types"
 - choice: "implicitConversions"
description: "Allow definition of implicit functions called views"
 - choice: "postfixOps"
description: "Allow postfix operator notation, such as `1 to 10 toList` (not recommended)"
 - choice: "reflectiveCalls"
description: "Allow reflective access to members of structural types"
 - choice: "experimental.macros"
description: "Allow macro definition (besides implementation and application)"
description: "Enable or disable language features"
abbreviations:
 - "--language"
 - option: "-no-specialization"
schema:
type: "Boolean"
description: "Ignore @specialize annotations."
abbreviations:
 - "--no-specialization"
 - option: "-nobootcp"
schema:
type: "Boolean"
description: "Do not use the boot classpath for the scala jars."
abbreviations:
 - "--no-boot-class-path"
 - option: "-nowarn"
schema:
type: "Boolean"
description: "Generate no warnings."
abbreviations:
 - "--no-warnings"
 - option: "-opt"
schema:
type: "Choice"
arg: "optimization"
multiple: "true"
choices:
 - choice: "unreachable-code"
description: "Eliminate unreachable code, exception handlers guarding no instructions, redundant metadata (debug information, line numbers)."
 - choice: "simplify-jumps"
description: "Simplify branching instructions, eliminate unnecessary ones."
 - choice: "compact-locals"
description: "Eliminate empty slots in the sequence of local variables."
 - choice: "copy-propagation"
description: "Eliminate redundant local variables and unused values (including closures). Enables unreachable-code."
 - choice: "redundant-casts"
description: "Eliminate redundant casts using a type propagation analysis."
 - choice: "box-unbox"
description: "Eliminate box-unbox pairs within the same method (also tuples, xRefs, value class instances). Enables unreachable-code."
 - choice: "nullness-tracking"
description: "Track nullness / non-nullness of local variables and apply optimizations."
 - choice: "closure-invocations"
description: "Rewrite closure invocations to the implementation method."
 - choice: "allow-skip-core-module-init"
description: "Allow eliminating unused module loads for core modules of the standard library (e.g., Predef, ClassTag)."
 - choice: "assume-modules-non-null"
description: "Assume loading a module never results in null (happens if the module is accessed in its super constructor)."
 - choice: "allow-skip-class-loading"
description: "Allow optimizations that can skip or delay class loading."
 - choice: "inline"
description: "Inline method invocations according to -Yopt-inline-heuristics and -opt-inline-from."
 - choice: "l:none"
description: "Disable optimizations. Takes precedence: `-opt:l:none,+box-unbox` / `-opt:l:none -opt:box-unbox` don`t enable box-unbox."
 - choice: "l:default"
description: "Enable default optimizations: unreachable-code."
 - choice: "l:method"
description: "Enable intra-method optimizations: unreachable-code,simplify-jumps,compact-locals,copy-propagation,redundant-casts,box-unbox,nullness-tracking,closure-invocations,allow-skip-core-module-init,assume-modules-non-null,allow-skip-class-loading."
 - choice: "l:inline"
description: "Enable cross-method optimizations (note: inlining requires -opt-inline-from): l:method,inline."
description: "Enable optimizations"
 - option: "-opt-inline-from"
schema:
type: "String"
arg: "patterns"
multiple: "true"
description: "Patterns for classfile names from which to allow inlining, `help` for details."
 - option: "-opt-warnings"
schema:
type: "Choice"
arg: "warning"
multiple: "true"
choices:
 - choice: "none"
description: "No optimizer warnings."
 - choice: "at-inline-failed-summary"
description: "One-line summary if there were @inline method calls that could not be inlined."
 - choice: "at-inline-failed"
description: "A detailed warning for each @inline method call that could not be inlined."
 - choice: "any-inline-failed"
description: "A detailed warning for every callsite that was chosen for inlining by the heuristics, but could not be inlined."
 - choice: "no-inline-mixed"
description: "In mixed compilation, warn at callsites methods defined in java sources (the inlining decision cannot be made without bytecode)."
 - choice: "no-inline-missing-bytecode"
description: "Warn if an inlining decision cannot be made because a the bytecode of a class or member cannot be found on the compilation classpath."
 - choice: "no-inline-missing-attribute"
description: "Warn if an inlining decision cannot be made because a Scala classfile does not have a ScalaInlineInfo attribute."
description: "Enable optimizer warnings"
 - option: "-optimize"
schema:
type: "Boolean"
description: "Enables optimizations."
abbreviations:
 - "-optimise"
 - option: "-print"
schema:
type: "Boolean"
description: "Print program with Scala-specific features removed."
abbreviations:
 - "--print"
 - option: "-release"
schema:
type: "String"
arg: "release"
default:
description: "Compile for a specific version of the Java platform. Supported targets: 8, 11, or any higher version listed at https://docs.scala-lang.org/overviews/jdk-compatibility/overview.html"
abbreviations:
 - "--release"
 - option: "-sourcepath"
schema:
type: "Path"
arg: "path"
default:
description: "Specify location(s) of source files."
abbreviations:
 - "--source-path"
 - option: "-target"
schema:
type: "Choice"
arg: "target"
default: "8"
choices:
 - choice: "8"
 - choice: "9"
 - choice: "10"
 - choice: "11"
 - choice: "12"
description: "Target platform for object files. ([8],9,10,11,12)"
abbreviations:
 - "--target"
 - option: "-toolcp"
schema:
type: "Path"
arg: "path"
default:
description: "Add to the runner classpath."
abbreviations:
 - "--tool-class-path"
 - option: "-unchecked"
schema:
type: "Boolean"
description: "Enable additional warnings where generated code depends on assumptions."
abbreviations:
 - "--unchecked"
 - option: "-uniqid"
schema:
type: "Boolean"
description: "Uniquely tag all identifiers in debugging output."
abbreviations:
 - "--unique-id"
 - option: "-usejavacp"
schema:
type: "Boolean"
description: "Utilize the java.class.path in classpath resolution."
abbreviations:
 - "--use-java-class-path"
 - option: "-usemanifestcp"
schema:
type: "Boolean"
description: "Utilize the manifest in classpath resolution."
abbreviations:
 - "--use-manifest-class-path"
 - option: "-verbose"
schema:
type: "Boolean"
description: "Output messages about what the compiler is doing."
abbreviations:
 - "--verbose"
 - option: "-version"
schema:
type: "Boolean"
description: "Print product version and exit."
abbreviations:
 - "--version"
 - option: "@<file>"
schema:
type: "Boolean"
description: "A text file containing compiler arguments (options and source files)"
- category: "Advanced Settings"
description:
options:
 - option: "-Xcheckinit"
schema:
type: "Boolean"
description: "Wrap field accessors to throw an exception on uninitialized access."
 - option: "-Xdev"
schema:
type: "Boolean"
description: "Indicates user is a developer - issue warnings about anything which seems amiss"
 - option: "-Xdisable-assertions"
schema:
type: "Boolean"
description: "Generate no assertions or assumptions."
 - option: "-Xelide-below"
schema:
type: "Int"
default: "-2147483648"
description: "Calls to @elidable methods are omitted if method priority is lower than argument"
 - option: "-Xexperimental"
schema:
type: "Boolean"
description: "Former graveyard for language-forking extensions."
 - option: "-Xfuture"
schema:
type: "Boolean"
description: "Replaced by -Xsource."
 - option: "-Xgenerate-phase-graph"
schema:
type: "String"
arg: "file"
default:
description: "Generate the phase graphs (outputs .dot files) to fileX.dot."
 - option: "-Xlint"
schema:
type: "Choice"
arg: "warning"
multiple: "true"
choices:
 - choice: "adapted-args"
description: "Warn if an argument list is modified to match the receiver."
 - choice: "nullary-unit"
description: "Warn when nullary methods return Unit."
 - choice: "inaccessible"
description: "Warn about inaccessible types in method signatures."
 - choice: "nullary-override"
description: "Warn when non-nullary `def f()` overrides nullary `def f`."
 - choice: "infer-any"
description: "Warn when a type argument is inferred to be `Any`."
 - choice: "missing-interpolator"
description: "A string literal appears to be missing an interpolator id."
 - choice: "doc-detached"
description: "A Scaladoc comment appears to be detached from its element."
 - choice: "private-shadow"
description: "A private field (or class parameter) shadows a superclass field."
 - choice: "type-parameter-shadow"
description: "A local type parameter shadows a type already in scope."
 - choice: "poly-implicit-overload"
description: "Parameterized overloaded implicit methods are not visible as view bounds."
 - choice: "option-implicit"
description: "Option.apply used implicit view."
 - choice: "delayedinit-select"
description: "Selecting member of DelayedInit."
 - choice: "package-object-classes"
description: "Class or object defined in package object."
 - choice: "stars-align"
description: "Pattern sequence wildcard must align with sequence component."
 - choice: "constant"
description: "Evaluation of a constant arithmetic expression results in an error."
 - choice: "unused"
description: "Enable -Wunused:imports,privates,locals,implicits."
 - choice: "nonlocal-return"
description: "A return statement used an exception for flow control."
 - choice: "implicit-not-found"
description: "Check @implicitNotFound and @implicitAmbiguous messages."
 - choice: "serial"
description: "@SerialVersionUID on traits and non-serializable classes."
 - choice: "valpattern"
description: "Enable pattern checks in val definitions."
 - choice: "eta-zero"
description: "Warn on eta-expansion (rather than auto-application) of zero-ary method."
 - choice: "eta-sam"
description: "Warn on eta-expansion to meet a Java-defined functional interface that is not explicitly annotated with @FunctionalInterface."
 - choice: "deprecation"
description: "Enable linted deprecations."
description: "Enable recommended warnings"
 - option: "-Xmacro-settings"
schema:
type: "String"
arg: "option"
multiple: "true"
description: "Custom settings for macros."
 - option: "-Xmain-class"
schema:
type: "String"
arg: "path"
default:
description: "Class for manifest's Main-Class entry (only useful with -d jar)"
 - option: "-Xmaxerrs"
schema:
type: "Int"
default: "100"
description: "Maximum errors to print"
 - option: "-Xmaxwarns"
schema:
type: "Int"
default: "100"
description: "Maximum warnings to print"
 - option: "-Xmigration"
schema:
type: "ScalaVersion"
arg: "version"
default: "none"
description: "Warn about constructs whose behavior may have changed since version."
 - option: "-Xmixin-force-forwarders"
schema:
type: "Choice"
arg: "mode"
default: "true"
choices:
 - choice: "true"
description: "Always generate mixin forwarders."
 - choice: "junit"
description: "Generate mixin forwarders for JUnit-annotated methods (JUnit 4 does not support default methods)."
 - choice: "false"
description: "Only generate mixin forwarders required for program correctness."
description: "Generate forwarder methods in classes inhering concrete methods from traits. Default: `true`, `help` to list choices."
 - option: "-Xno-forwarders"
schema:
type: "Boolean"
description: "Do not generate static forwarders in mirror classes."
 - option: "-Xno-patmat-analysis"
schema:
type: "Boolean"
description: "Don't perform exhaustivity/unreachability analysis. Also, ignore @switch annotation."
 - option: "-Xnojline"
schema:
type: "Boolean"
description: "Do not use JLine for editing."
 - option: "-Xplugin"
schema:
type: "String"
arg: "paths"
multiple: "true"
description: "Load a plugin from each classpath."
 - option: "-Xplugin-disable"
schema:
type: "String"
arg: "plugin"
multiple: "true"
description: "Disable plugins by name."
 - option: "-Xplugin-list"
schema:
type: "Boolean"
description: "Print a synopsis of loaded plugins."
 - option: "-Xplugin-require"
schema:
type: "String"
arg: "plugin"
multiple: "true"
description: "Abort if a named plugin is not loaded."
 - option: "-Xpluginsdir"
schema:
type: "String"
arg: "path"
default: ""
description: "Path to search for plugin archives."
 - option: "-Xprompt"
schema:
type: "Boolean"
description: "Display a prompt after each error (debugging option)."
 - option: "-Xreporter"
schema:
type: "String"
arg: "classname"
default: "scala.tools.nsc.reporters.ConsoleReporter"
description: "Specify a custom reporter for compiler messages."
 - option: "-Xresident"
schema:
type: "Boolean"
description: "Compiler stays resident: read source filenames from standard input."
 - option: "-Xscript"
schema:
type: "String"
arg: "object"
default:
description: "Treat the source file as a script and wrap it in a main method."
 - option: "-Xsource"
schema:
type: "ScalaVersion"
arg: "version"
default: "2.13.0"
description: "Treat compiler input as Scala source for the specified version, see scala/bug#8126."
 - option: "-Xsource-reader"
schema:
type: "String"
arg: "classname"
default:
description: "Specify a custom method for reading source files."
 - option: "-Xverify"
schema:
type: "Boolean"
description: "Verify generic signatures in generated bytecode."
 - option: "-Xxml"
schema:
type: "Choice"
arg: "property"
multiple: "true"
choices:
 - choice: "coalescing"
description: "Convert PCData to Text and coalesce sibling nodes"
description: "Configure XML parsing."
- category: "Verbose Settings"
description:
options:
 - option: "-Vbrowse"
schema:
type: "Phases"
default:
description: "Browse the abstract syntax tree after phases"
abbreviations:
 - "-Ybrowse"
 - option: "-Vclasspath"
schema:
type: "Boolean"
description: "Output information about what classpath is being applied."
abbreviations:
 - "-Ylog-classpath"
 - option: "-Vdebug"
schema:
type: "Boolean"
description: "Increase the quantity of debugging output."
abbreviations:
 - "-Ydebug"
 - option: "-Vdoc"
schema:
type: "Boolean"
description: "Trace scaladoc activity."
abbreviations:
 - "-Ydoc-debug"
 - option: "-Vfree-terms"
schema:
type: "Boolean"
description: "Print a message when reification creates a free term."
abbreviations:
 - "-Xlog-free-terms"
 - option: "-Vfree-types"
schema:
type: "Boolean"
description: "Print a message when reification resorts to generating a free type."
abbreviations:
 - "-Xlog-free-types"
 - option: "-Vhot-statistics"
schema:
type: "Boolean"
description: "Enable `-Vstatistics` to also print hot statistics."
abbreviations:
 - "-Yhot-statistics"
 - option: "-Vide"
schema:
type: "Boolean"
description: "Generate, validate and output trees using the interactive compiler."
abbreviations:
 - "-Yide-debug"
 - option: "-Vimplicit-conversions"
schema:
type: "Boolean"
description: "Print a message whenever an implicit conversion is inserted."
abbreviations:
 - "-Xlog-implicit-conversions"
 - option: "-Vimplicits"
schema:
type: "Boolean"
description: "Print dependent missing implicits."
abbreviations:
 - "-Xlog-implicits"
 - option: "-Vimplicits-verbose-tree"
schema:
type: "Boolean"
description: "Display all intermediate implicits in a chain."
 - option: "-Vimplicits-max-refined"
schema:
type: "Int"
default: "0"
description: "max chars for printing refined types, abbreviate to `F {...}`"
 - option: "-Vtype-diffs"
schema:
type: "Boolean"
description: "Print found/required error messages as colored diffs."
 - option: "-Vinline"
schema:
type: "String"
arg: "package/Class.method"
default:
description: "Print a summary of inliner activity; `_` to print all, prefix match to select."
abbreviations:
 - "-Yopt-log-inline"
 - option: "-Vissue"
schema:
type: "Boolean"
description: "Print stack traces when a context issues an error."
abbreviations:
 - "-Yissue-debug"
 - option: "-Vlog"
schema:
type: "Phases"
default:
description: "Log operations during phases"
abbreviations:
 - "-Ylog"
 - option: "-Vmacro"
schema:
type: "Boolean"
description: "Trace macro activities: compilation, generation of synthetics, classloading, expansion, exceptions."
abbreviations:
 - "-Ymacro-debug-verbose"
 - option: "-Vmacro-lite"
schema:
type: "Boolean"
description: "Trace macro activities with less output."
abbreviations:
 - "-Ymacro-debug-lite"
 - option: "-Vopt"
schema:
type: "String"
arg: "package/Class.method"
default:
description: "Trace the optimizer progress for methods; `_` to print all, prefix match to select."
abbreviations:
 - "-Yopt-trace"
 - option: "-Vpatmat"
schema:
type: "Boolean"
description: "Trace pattern matching translation."
abbreviations:
 - "-Ypatmat-debug"
 - option: "-Vphases"
schema:
type: "Boolean"
description: "Print a synopsis of compiler phases."
abbreviations:
 - "-Xshow-phases"
 - option: "-Vpos"
schema:
type: "Boolean"
description: "Trace position validation."
abbreviations:
 - "-Ypos-debug"
 - option: "-Vprint"
schema:
type: "Phases"
default:
description: "Print out program after phases"
abbreviations:
 - "-Xprint"
 - option: "-Vprint-args"
schema:
type: "String"
arg: "file"
default: "-"
description: "Print all compiler arguments to the specified location. Use - to echo to the reporter."
abbreviations:
 - "-Xprint-args"
 - option: "-Vprint-pos"
schema:
type: "Boolean"
description: "Print tree positions, as offsets."
abbreviations:
 - "-Xprint-pos"
 - option: "-Vprint-types"
schema:
type: "Boolean"
description: "Print tree types (debugging option)."
abbreviations:
 - "-Xprint-types"
 - option: "-Vquasiquote"
schema:
type: "Boolean"
description: "Trace quasiquotations."
abbreviations:
 - "-Yquasiquote-debug"
 - option: "-Vreflective-calls"
schema:
type: "Boolean"
description: "Print a message when a reflective method call is generated"
abbreviations:
 - "-Xlog-reflective-calls"
 - option: "-Vreify"
schema:
type: "Boolean"
description: "Trace reification."
abbreviations:
 - "-Yreify-debug"
 - option: "-Vshow"
schema:
type: "Phases"
default:
description: "(Requires -Xshow-class or -Xshow-object) Show after phases"
abbreviations:
 - "-Yshow"
 - option: "-Vshow-class"
schema:
type: "String"
arg: "class"
default:
description: "Show internal representation of class."
abbreviations:
 - "-Xshow-class"
 - option: "-Vshow-member-pos"
schema:
type: "String"
arg: "output style"
default:
description: "Show start and end positions of members (implies -Yrangepos)"
abbreviations:
 - "-Yshow-member-pos"
 - option: "-Vshow-object"
schema:
type: "String"
arg: "object"
default:
description: "Show internal representation of object."
abbreviations:
 - "-Xshow-object"
 - option: "-Vshow-symkinds"
schema:
type: "Boolean"
description: "Print abbreviated symbol kinds next to symbol names."
abbreviations:
 - "-Yshow-symkinds"
 - option: "-Vshow-symowners"
schema:
type: "Boolean"
description: "Print owner identifiers next to symbol names."
abbreviations:
 - "-Yshow-symowners"
 - option: "-Vstatistics"
schema:
type: "Phases"
default: "parser,typer,patmat,erasure,cleanup,jvm"
description: "Print compiler statistics for specific phases phases (default: parser,typer,patmat,erasure,cleanup,jvm)"
abbreviations:
 - "-Ystatistics"
 - option: "-Vsymbols"
schema:
type: "Boolean"
description: "Print the AST symbol hierarchy after each phase."
abbreviations:
 - "-Yshow-syms"
 - option: "-Vtyper"
schema:
type: "Boolean"
description: "Trace type assignments."
abbreviations:
 - "-Ytyper-debug"
- category: "Private Settings"
description:
options:
 - option: "-Ybackend-parallelism"
schema:
type: "Int"
default: "1"
min: "1"
max: "16"
description: "maximum worker threads for backend"
 - option: "-Ybackend-worker-queue"
schema:
type: "Int"
default: "0"
min: "0"
max: "1000"
description: "backend threads worker queue size"
 - option: "-Ybreak-cycles"
schema:
type: "Boolean"
description: "Attempt to break cycles encountered during typing"
 - option: "-Ycache-macro-class-loader"
schema:
type: "Choice"
arg: "policy"
default: "none"
choices:
 - choice: "none"
description: "Don't cache class loader"
 - choice: "last-modified"
description: "Cache class loader, using file last-modified time to invalidate"
 - choice: "always"
description: "Cache class loader with no invalidation"
description: "Policy for caching class loaders for macros that are dynamically loaded. Default: `none`, `help` to list choices."
 - option: "-Ycache-plugin-class-loader"
schema:
type: "Choice"
arg: "policy"
default: "none"
choices:
 - choice: "none"
description: "Don't cache class loader"
 - choice: "last-modified"
description: "Cache class loader, using file last-modified time to invalidate"
 - choice: "always"
description: "Cache class loader with no invalidation"
description: "Policy for caching class loaders for compiler plugins that are dynamically loaded. Default: `none`, `help` to list choices."
 - option: "-Ycheck"
schema:
type: "Phases"
default:
description: "Check the tree at the end of phases"
 - option: "-Ycompact-trees"
schema:
type: "Boolean"
description: "Use compact tree printer when displaying trees."
 - option: "-Ydelambdafy"
schema:
type: "Choice"
arg: "strategy"
default: "method"
choices:
 - choice: "inline"
 - choice: "method"
description: "Strategy used for translating lambdas into JVM code. (inline,[method])"
 - option: "-Ydump-classes"
schema:
type: "String"
arg: "dir"
default:
description: "Dump the generated bytecode to .class files (useful for reflective compilation that utilizes in-memory classloaders)."
 - option: "-Ygen-asmp"
schema:
type: "String"
arg: "dir"
default:
description: "Generate a parallel output directory of .asmp files (ie ASM Textifier output)."
 - option: "-Yimports"
schema:
type: "String"
arg: "import"
multiple: "true"
description: "Custom root imports, default is `java.lang,scala,scala.Predef`."
 - option: "-Yjar-compression-level"
schema:
type: "Int"
default: "-1"
min: "-1"
max: "9"
description: "compression level to use when writing jar files"
 - option: "-Ymacro-annotations"
schema:
type: "Boolean"
description: "Enable support for macro annotations, formerly in macro paradise."
 - option: "-Ymacro-classpath"
schema:
type: "Path"
arg: "path"
default:
description: "The classpath used to reflectively load macro implementations, default is the compilation classpath."
 - option: "-Ymacro-expand"
schema:
type: "Choice"
arg: "policy"
default: "normal"
choices:
 - choice: "normal"
 - choice: "none"
 - choice: "discard"
description: "Control expansion of macros, useful for scaladoc and presentation compiler. ([normal],none,discard)"
 - option: "-Ymacro-global-fresh-names"
schema:
type: "Boolean"
description: "Should fresh names in macros be unique across all compilation units"
 - option: "-Yno-completion"
schema:
type: "Boolean"
description: "Disable tab-completion in the REPL."
 - option: "-Yno-flat-classpath-cache"
schema:
type: "Boolean"
description: "Do not cache flat classpath representation of classpath elements from jars across compiler instances."
abbreviations:
 - "-YdisableFlatCpCaching"
 - option: "-Yno-generic-signatures"
schema:
type: "Boolean"
description: "Suppress generation of generic signatures for Java."
 - option: "-Yno-imports"
schema:
type: "Boolean"
description: "Compile without importing scala.*, java.lang.*, or Predef."
 - option: "-Yno-predef"
schema:
type: "Boolean"
description: "Compile without importing Predef."
 - option: "-Yopt-inline-heuristics"
schema:
type: "Choice"
arg: "strategy"
default: "default"
choices:
 - choice: "at-inline-annotated"
 - choice: "everything"
 - choice: "default"
description: "Set the heuristics for inlining decisions. (at-inline-annotated,everything,[default])"
 - option: "-Ypatmat-exhaust-depth"
schema:
type: "Int"
default: "20"
min: "10"
max: "2147483647"
description: "off"
 - option: "-Yprint-trees"
schema:
type: "Choice"
arg: "style"
default: "text"
choices:
 - choice: "text"
 - choice: "compact"
 - choice: "format"
 - choice: "text+format"
description: "How to print trees when -Vprint is enabled. ([text],compact,format,text+format)"
 - option: "-Yprofile-destination"
schema:
type: "String"
arg: "file"
default:
description: "Profiling output - specify a file or `-` for console."
 - option: "-Yprofile-enabled"
schema:
type: "Boolean"
description: "Enable profiling."
 - option: "-Yprofile-external-tool"
schema:
type: "Phases"
default: "typer"
description: "Enable profiling for a phase using an external tool hook. Generally only useful for a single phase phases (default: typer)"
 - option: "-Yprofile-run-gc"
schema:
type: "Phases"
default: "_"
description: "Run a GC between phases - this allows heap size to be accurate at the expense of more time. Specify a list of phases, or all phases (default: _)"
 - option: "-Yprofile-trace"
schema:
type: "String"
arg: "file"
default: "profile.trace"
description: "Capture trace of compilation in Chrome Trace format"
 - option: "-Yrangepos"
schema:
type: "Boolean"
description: "Use range positions for syntax trees."
 - option: "-Yrecursion"
schema:
type: "Int"
default: "0"
min: "0"
max: "2147483647"
description: "Set recursion depth used when locking symbols."
 - option: "-Yreify-copypaste"
schema:
type: "Boolean"
description: "Dump the reified trees in copypasteable representation."
 - option: "-Yrepl-class-based"
schema:
type: "Boolean"
description: "Use classes to wrap REPL snippets instead of objects"