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: 6, 7, 8, 9"
    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: "-Xno-uescape"
    schema:
      type: "Boolean"
    description: "Disable handling of \\u unicode escapes."
  - 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"
  - option: "-Yrepl-outdir"
    schema:
      type: "String"
      arg: "path"
      default:
    description: "Write repl-generated classfiles to given output directory (use \"\" to generate a temporary dir)"
  - option: "-Yresolve-term-conflict"
    schema:
      type: "Choice"
      arg: "strategy"
      default: "error"
      choices:
      - choice: "package"
      - choice: "object"
      - choice: "error"
    description: "Resolve term conflicts. (package,object,[error])"
  - option: "-Yscriptrunner"
    schema:
      type: "String"
      arg: "classname"
      default: "default"
    description: "Specify a scala.tools.nsc.ScriptRunner (default, resident, shutdown, or a class name)."
  - option: "-Yskip"
    schema:
      type: "Phases"
      default:
    description: "Skip phases"
  - option: "-Ystop-after"
    schema:
      type: "Phases"
      default:
    description: "Stop after phases"
    abbreviations:
    - "-stop"
  - option: "-Ystop-before"
    schema:
      type: "Phases"
      default:
    description: "Stop before phases"
  - option: "-Yvalidate-pos"
    schema:
      type: "Phases"
      default:
    description: "Validate positions after the given phases (implies -Yrangepos) phases"
- category: "Warning Settings"
  description:
  options:
  - option: "-Wdead-code"
    schema:
      type: "Boolean"
    description: "Warn when dead code is identified."
    abbreviations:
    - "-Ywarn-dead-code"
  - option: "-Wextra-implicit"
    schema:
      type: "Boolean"
    description: "Warn when more than one implicit parameter section is defined."
    abbreviations:
    - "-Ywarn-extra-implicit"
  - option: "-Wmacros"
    schema:
      type: "Choice"
      arg: "mode"
      default: "before"
      choices:
      - choice: "none"
        description: "Do not inspect expansions or their original trees when generating unused symbol warnings."
      - choice: "before"
        description: "Only inspect unexpanded user-written code for unused symbols."
      - choice: "after"
        description: "Only inspect expanded trees when generating unused symbol warnings."
      - choice: "both"
        description: "Inspect both user-written code and expanded trees when generating unused symbol warnings."
    description: "Enable lint warnings on macro expansions. Default: `before`, `help` to list choices."
    abbreviations:
    - "-Ywarn-macros"
  - option: "-Wnumeric-widen"
    schema:
      type: "Boolean"
    description: "Warn when numerics are widened."
    abbreviations:
    - "-Ywarn-numeric-widen"
  - option: "-Woctal-literal"
    schema:
      type: "Boolean"
    description: "Warn on obsolete octal syntax."
    abbreviations:
    - "-Ywarn-octal-literal"
  - option: "-Wself-implicit"
    schema:
      type: "Boolean"
    description: "Warn when an implicit resolves to an enclosing self-definition."
    abbreviations:
    - "-Ywarn-self-implicit"
  - option: "-Wunused"
    schema:
      type: "Choice"
      arg: "warning"
      multiple: "true"
      choices:
      - choice: "imports"
        description: "Warn if an import selector is not referenced."
      - choice: "patvars"
        description: "Warn if a variable bound in a pattern is unused."
      - choice: "privates"
        description: "Warn if a private member is unused."
      - choice: "locals"
        description: "Warn if a local definition is unused."
      - choice: "explicits"
        description: "Warn if an explicit parameter is unused."
      - choice: "implicits"
        description: "Warn if an implicit parameter is unused."
      - choice: "params"
        description: "Enable -Wunused:explicits,implicits."
      - choice: "linted"
        description: "-Xlint:unused."
    description: "Enable or disable specific `unused` warnings"
    abbreviations:
    - "-Ywarn-unused"
  - option: "-Wvalue-discard"
    schema:
      type: "Boolean"
    description: "Warn when non-Unit expression results are unused."
    abbreviations:
    - "-Ywarn-value-discard"
  - 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"
- category: "IDE-specific Settings"
  description:
  options:
  - option: "-Ypresentation-any-thread"
    schema:
      type: "Boolean"
    description: "Allow use of the presentation compiler from any thread"
  - option: "-Ypresentation-debug"
    schema:
      type: "Boolean"
    description: "Enable debugging output for the presentation compiler."
  - option: "-Ypresentation-delay"
    schema:
      type: "Int"
      default: "0"
      min: "0"
      max: "999"
    description: "Wait number of ms after typing before starting typechecking"
  - option: "-Ypresentation-log"
    schema:
      type: "String"
      arg: "file"
      default:
    description: "Log presentation compiler events into file"
  - option: "-Ypresentation-replay"
    schema:
      type: "String"
      arg: "file"
      default:
    description: "Replay presentation compiler events from file"
  - option: "-Ypresentation-strict"
    schema:
      type: "Boolean"
    description: "Do not report type errors in sources with syntax errors."
  - option: "-Ypresentation-verbose"
    schema:
      type: "Boolean"
    description: "Print information about presentation compiler tasks."