diff options
Diffstat (limited to 'src')
38 files changed, 184 insertions, 56 deletions
diff --git a/src/compiler/scala/tools/nsc/doc/html/resource/lib/template.css b/src/compiler/scala/tools/nsc/doc/html/resource/lib/template.css index 6fb7953724..b066027f04 100644 --- a/src/compiler/scala/tools/nsc/doc/html/resource/lib/template.css +++ b/src/compiler/scala/tools/nsc/doc/html/resource/lib/template.css @@ -824,3 +824,25 @@ div.fullcomment dl.paramcmts > dd { color: #4C4C4C; font-weight: bold; }*/ + +.badge { + display: inline-block; + padding: 2px 4px; + font-size: 11.844px; + font-weight: bold; + line-height: 14px; + color: #ffffff; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); + white-space: nowrap; + vertical-align: baseline; + background-color: #999999; + padding-right: 9px; + padding-left: 9px; + -webkit-border-radius: 9px; + -moz-border-radius: 9px; + border-radius: 9px; +} + +.badge-red { + background-color: #b94a48; +} diff --git a/src/reflect/scala/reflect/api/Annotations.scala b/src/reflect/scala/reflect/api/Annotations.scala index fb353a5520..ebfd57038c 100644 --- a/src/reflect/scala/reflect/api/Annotations.scala +++ b/src/reflect/scala/reflect/api/Annotations.scala @@ -3,7 +3,10 @@ package api import scala.collection.immutable.ListMap -/** This trait provides annotation support for the reflection API. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * This trait provides annotation support for the reflection API. * * The API distinguishes between two kinds of annotations: * diff --git a/src/reflect/scala/reflect/api/Constants.scala b/src/reflect/scala/reflect/api/Constants.scala index a92fc5cbb3..89153706ed 100644 --- a/src/reflect/scala/reflect/api/Constants.scala +++ b/src/reflect/scala/reflect/api/Constants.scala @@ -7,6 +7,8 @@ package scala.reflect package api /** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * * According to the section 6.24 "Constant Expressions" of the Scala language specification, * certain expressions (dubbed ''constant expressions'') can be evaluated by the Scala compiler at compile-time. * diff --git a/src/reflect/scala/reflect/api/Exprs.scala b/src/reflect/scala/reflect/api/Exprs.scala index 45bfddb55d..739b9dca12 100644 --- a/src/reflect/scala/reflect/api/Exprs.scala +++ b/src/reflect/scala/reflect/api/Exprs.scala @@ -8,7 +8,10 @@ package api import scala.reflect.runtime.{universe => ru} -/** A trait that defines strongly-typed tree wrappers and operations on them for use in Scala Reflection. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A trait that defines strongly-typed tree wrappers and operations on them for use in Scala Reflection. * * `Expr` wraps an abstract syntax tree ([[scala.reflect.api.Trees#Tree]]) and tags it with its type ([[scala.reflect.api.Types#Type]]). * diff --git a/src/reflect/scala/reflect/api/FlagSets.scala b/src/reflect/scala/reflect/api/FlagSets.scala index a7d1ca05a6..5cf7460dcd 100644 --- a/src/reflect/scala/reflect/api/FlagSets.scala +++ b/src/reflect/scala/reflect/api/FlagSets.scala @@ -4,6 +4,8 @@ package api import scala.language.implicitConversions /** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * * The trait that defines flag sets and operations on them. * * `Flag`s are used to provide modifiers for abstract syntax trees that represent definitions diff --git a/src/reflect/scala/reflect/api/Importers.scala b/src/reflect/scala/reflect/api/Importers.scala index 4286b2b45c..f68ff690cf 100644 --- a/src/reflect/scala/reflect/api/Importers.scala +++ b/src/reflect/scala/reflect/api/Importers.scala @@ -1,7 +1,10 @@ package scala.reflect package api -/** This trait provides support for importers, a facility to migrate reflection artifacts between universes. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * This trait provides support for importers, a facility to migrate reflection artifacts between universes. * * Reflection artifacts, such as [[scala.reflect.api.Symbols Symbols]] and [[scala.reflect.api.Types Types]], * are contained in [[scala.reflect.api.Universes Universe]]s. Typically all processing happens diff --git a/src/reflect/scala/reflect/api/JavaMirrors.scala b/src/reflect/scala/reflect/api/JavaMirrors.scala index df099006b5..43360c97a1 100644 --- a/src/reflect/scala/reflect/api/JavaMirrors.scala +++ b/src/reflect/scala/reflect/api/JavaMirrors.scala @@ -1,7 +1,10 @@ package scala.reflect package api -/** A refinement of [[scala.reflect.api.Mirror]] for runtime reflection using JVM classloaders. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A refinement of [[scala.reflect.api.Mirror]] for runtime reflection using JVM classloaders. * * This refinement equips mirrors with reflection capabilities for the JVM. `JavaMirror` can * convert Scala reflection artifacts (symbols and types) into Java reflection artifacts (classes) diff --git a/src/reflect/scala/reflect/api/JavaUniverse.scala b/src/reflect/scala/reflect/api/JavaUniverse.scala index f83692034f..8649f339e3 100644 --- a/src/reflect/scala/reflect/api/JavaUniverse.scala +++ b/src/reflect/scala/reflect/api/JavaUniverse.scala @@ -1,7 +1,10 @@ package scala.reflect package api -/** A refinement of [[scala.reflect.api.Universe]] for runtime reflection using JVM classloaders. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A refinement of [[scala.reflect.api.Universe]] for runtime reflection using JVM classloaders. * * The refinement consists of an upgrade to the mirror API, which gets extended from [[scala.reflect.api.Mirror]] * to [[scala.reflect.api.JavaMirrors#JavaMirror]]. diff --git a/src/reflect/scala/reflect/api/Mirror.scala b/src/reflect/scala/reflect/api/Mirror.scala index b1290cc02e..f600ee9caf 100644 --- a/src/reflect/scala/reflect/api/Mirror.scala +++ b/src/reflect/scala/reflect/api/Mirror.scala @@ -2,6 +2,8 @@ package scala.reflect package api /** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * * The base class for all mirrors. * * See [[scala.reflect.api.Mirrors]] or [[docs.scala-lang.org/overviews/reflection/overview.html Reflection Guide]] diff --git a/src/reflect/scala/reflect/api/Mirrors.scala b/src/reflect/scala/reflect/api/Mirrors.scala index cc1b9762cb..c4573eaf99 100644 --- a/src/reflect/scala/reflect/api/Mirrors.scala +++ b/src/reflect/scala/reflect/api/Mirrors.scala @@ -1,7 +1,10 @@ package scala.reflect package api -/** This trait provides support for Mirrors in the Scala Reflection API. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * This trait provides support for Mirrors in the Scala Reflection API. * * `Mirror`s are a central part of Scala Reflection. All information provided by * reflection is made accessible through `Mirror`s. Depending on the type of information diff --git a/src/reflect/scala/reflect/api/Names.scala b/src/reflect/scala/reflect/api/Names.scala index 02eb79f8ed..3d124dafc4 100644 --- a/src/reflect/scala/reflect/api/Names.scala +++ b/src/reflect/scala/reflect/api/Names.scala @@ -1,7 +1,10 @@ package scala.reflect package api -/** This trait defines Names (a Scala reflection concept) and operations on them. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * This trait defines Names (a Scala reflection concept) and operations on them. * * Names are simple wrappers for strings. [[scala.reflect.api.Names#Name Name]] has two subtypes [[scala.reflect.api.Names#TermName TermName]] and [[scala.reflect.api.Names#TypeName TypeName]] which * distinguish names of terms (like objects or members) and types. A term and a type of the diff --git a/src/reflect/scala/reflect/api/Position.scala b/src/reflect/scala/reflect/api/Position.scala index bac191d2b5..0dfd74f1b3 100644 --- a/src/reflect/scala/reflect/api/Position.scala +++ b/src/reflect/scala/reflect/api/Position.scala @@ -3,15 +3,18 @@ package api import scala.reflect.macros.Attachments -/** Position tracks the origin of [[Symbols#Symbol symbols]] and [[Trees#Tree tree nodes]]. They are commonly used when - * displaying warnings and errors, to indicate the incorrect point in the program. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> * - * A position indicates the [[source source file]] and a [[point offset]]. A position may be - * undefined, which means it's pointing to the [[Positions#NoPosition]] element. + * Position tracks the origin of [[Symbols#Symbol symbols]] and [[Trees#Tree tree nodes]]. They are commonly used when + * displaying warnings and errors, to indicate the incorrect point in the program. * - * <b>Please note that this trait may be refactored in future versions of the Scala reflection API.</b> + * A position indicates the [[source source file]] and a [[point offset]]. A position may be + * undefined, which means it's pointing to the [[Positions#NoPosition]] element. * - * @see [[http://docs.scala-lang.org/overviews/reflection/names-exprs-scopes-more.html]] + * <b>Please note that this trait may be refactored in future versions of the Scala reflection API.</b> + * + * For more information about `Position`s, see the [[http://docs.scala-lang.org/overviews/reflection/annotations-names-scopes.html Reflection Guide: Annotations, Names, Scopes, and More]] * * @groupname Common Commonly used methods */ diff --git a/src/reflect/scala/reflect/api/Positions.scala b/src/reflect/scala/reflect/api/Positions.scala index 8d8a0081cc..14cc0ab12c 100644 --- a/src/reflect/scala/reflect/api/Positions.scala +++ b/src/reflect/scala/reflect/api/Positions.scala @@ -1,11 +1,14 @@ package scala.reflect package api -/** This trait defines the concept of positions and operations on them. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> * - * @see [[scala.reflect.api.Position]] + * This trait defines the concept of positions and operations on them. * - * @contentDiagram hideNodes "*Api" + * @see [[scala.reflect.api.Position]] + * + * @contentDiagram hideNodes "*Api" */ trait Positions { self: Universe => diff --git a/src/reflect/scala/reflect/api/Printers.scala b/src/reflect/scala/reflect/api/Printers.scala index 1e8161aeef..b1e14f798f 100644 --- a/src/reflect/scala/reflect/api/Printers.scala +++ b/src/reflect/scala/reflect/api/Printers.scala @@ -3,14 +3,17 @@ package api import java.io.{ PrintWriter, StringWriter } -/** Utilities for nicely printing [[scala.reflect.api.Trees]] and [[scala.reflect.api.Types]]. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> * - * === Printing Trees === - * The method `show` displays the "prettified" representation of reflection artifacts. - * This representation provides one with the desugared Java representation of Scala code. - * For example: + * Utilities for nicely printing [[scala.reflect.api.Trees]] and [[scala.reflect.api.Types]]. * - * {{{ + * === Printing Trees === + * The method `show` displays the "prettified" representation of reflection artifacts. + * This representation provides one with the desugared Java representation of Scala code. + * For example: + * + * {{{ * scala> import scala.reflect.runtime.universe._ * import scala.reflect.runtime.universe._ * diff --git a/src/reflect/scala/reflect/api/Scopes.scala b/src/reflect/scala/reflect/api/Scopes.scala index 80683c8e76..c79ec06b45 100644 --- a/src/reflect/scala/reflect/api/Scopes.scala +++ b/src/reflect/scala/reflect/api/Scopes.scala @@ -1,19 +1,22 @@ package scala.reflect package api -/** This trait provides support for scopes in the reflection API. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> * - * A scope object generally maps names to symbols available in a corresponding lexical scope. - * Scopes can be nested. The base type exposed to the reflection API, however, - * only exposes a minimal interface, representing a scope as an iterable of symbols. + * This trait provides support for scopes in the reflection API. * - * For rare occasions when it is necessary to create a scope manually, - * e.g., to populate members of [[scala.reflect.api.Types#RefinedType]], - * there is the `newScopeWith` function. + * A scope object generally maps names to symbols available in a corresponding lexical scope. + * Scopes can be nested. The base type exposed to the reflection API, however, + * only exposes a minimal interface, representing a scope as an iterable of symbols. * - * Additional functionality is exposed in member scopes that are returned by - * `members` and `declarations` defined in [[scala.reflect.api.Types#TypeApi]]. - * Such scopes support the `sorted` method, which sorts members in declaration order. + * For rare occasions when it is necessary to create a scope manually, + * e.g., to populate members of [[scala.reflect.api.Types#RefinedType]], + * there is the `newScopeWith` function. + * + * Additional functionality is exposed in member scopes that are returned by + * `members` and `declarations` defined in [[scala.reflect.api.Types#TypeApi]]. + * Such scopes support the `sorted` method, which sorts members in declaration order. */ trait Scopes { self: Universe => diff --git a/src/reflect/scala/reflect/api/StandardDefinitions.scala b/src/reflect/scala/reflect/api/StandardDefinitions.scala index a31a501357..480a28b878 100644 --- a/src/reflect/scala/reflect/api/StandardDefinitions.scala +++ b/src/reflect/scala/reflect/api/StandardDefinitions.scala @@ -5,10 +5,13 @@ package scala.reflect package api -/** All Scala standard symbols and types. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> * - * These standard definitions can accessed to using `definitions`. - * They're typically imported with a blanket import `import definitions`, and are + * All Scala standard symbols and types. + * + * These standard definitions can accessed to using `definitions`. + * They're typically imported with a wildcard import, `import definitions._`, and are * listed in [[scala.reflect.api.StandardDefinitions#DefinitionsApi]]. */ trait StandardDefinitions { diff --git a/src/reflect/scala/reflect/api/StandardNames.scala b/src/reflect/scala/reflect/api/StandardNames.scala index fc18c02706..0c1ceae187 100644 --- a/src/reflect/scala/reflect/api/StandardNames.scala +++ b/src/reflect/scala/reflect/api/StandardNames.scala @@ -11,6 +11,8 @@ package api // Otherwise you'd better not - reflection API should stay minimalistic. /** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * * Standard names are names that are essential to creating trees or to reflecting Scala artifacts. * For example, `CONSTRUCTOR` (aka `<init>` on JVM) is necessary to create and invoke constructors. * diff --git a/src/reflect/scala/reflect/api/Symbols.scala b/src/reflect/scala/reflect/api/Symbols.scala index 993cbd97a5..d91481724f 100644 --- a/src/reflect/scala/reflect/api/Symbols.scala +++ b/src/reflect/scala/reflect/api/Symbols.scala @@ -1,7 +1,10 @@ package scala.reflect package api -/** This trait defines symbols and operations on them. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * This trait defines symbols and operations on them. * * Symbols are used to establish bindings between a name and the entity it refers to, such as a class or a method. * Anything you define and can give a name to in Scala has an associated symbol. diff --git a/src/reflect/scala/reflect/api/TagInterop.scala b/src/reflect/scala/reflect/api/TagInterop.scala index 4e43f59706..5486c34517 100644 --- a/src/reflect/scala/reflect/api/TagInterop.scala +++ b/src/reflect/scala/reflect/api/TagInterop.scala @@ -1,7 +1,10 @@ package scala.reflect package api -/** This trait provides type tag <-> manifest interoperability. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * This trait provides type tag <-> manifest interoperability. * @groupname TagInterop TypeTag and Manifest Interoperability */ trait TagInterop { self: Universe => diff --git a/src/reflect/scala/reflect/api/Trees.scala b/src/reflect/scala/reflect/api/Trees.scala index bcb1d0031f..87a0348c15 100644 --- a/src/reflect/scala/reflect/api/Trees.scala +++ b/src/reflect/scala/reflect/api/Trees.scala @@ -5,9 +5,12 @@ package scala.reflect package api -/** This trait defines the node types used in Scala abstract syntax trees (AST) and operations on them. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> * -* All tree node types are sub types of [[scala.reflect.api.Trees#Tree Tree]]. + * This trait defines the node types used in Scala abstract syntax trees (AST) and operations on them. + * + * All tree node types are sub types of [[scala.reflect.api.Trees#Tree Tree]]. * * Trees are immutable, except for three fields * [[Trees#TreeApi.pos pos]], [[Trees#TreeApi.symbol symbol]], and [[Trees#TreeApi.tpe tpe]], which are assigned when a tree is typechecked diff --git a/src/reflect/scala/reflect/api/Types.scala b/src/reflect/scala/reflect/api/Types.scala index 7b8cf592ff..ab165a13b7 100644 --- a/src/reflect/scala/reflect/api/Types.scala +++ b/src/reflect/scala/reflect/api/Types.scala @@ -1,7 +1,10 @@ package scala.reflect package api -/** A trait that defines types and operations on them. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A trait that defines types and operations on them. * * Type instances represent information about the type of a corresponding symbol. This includes its members * (methods, fields, type parameters, nested classes, traits, etc) either declared directly or inherited, its base types, diff --git a/src/reflect/scala/reflect/api/Universe.scala b/src/reflect/scala/reflect/api/Universe.scala index 7d1f5c9df1..068ab94a4c 100644 --- a/src/reflect/scala/reflect/api/Universe.scala +++ b/src/reflect/scala/reflect/api/Universe.scala @@ -2,6 +2,8 @@ package scala.reflect package api /** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * * `Universe` provides a complete set of reflection operations which make it possible for one * to reflectively inspect Scala type relations, such as membership or subtyping. * diff --git a/src/reflect/scala/reflect/api/package.scala b/src/reflect/scala/reflect/api/package.scala index bd9c72a839..68466b9f09 100644 --- a/src/reflect/scala/reflect/api/package.scala +++ b/src/reflect/scala/reflect/api/package.scala @@ -2,7 +2,10 @@ package scala.reflect import scala.reflect.api.{Universe => ApiUniverse} -/** The Scala Reflection API (located in scala-reflect.jar). +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * The Scala Reflection API (located in scala-reflect.jar). * * In Scala 2.10.0, the Scala Reflection API and its implementation have an "experimental" status. * This means that the API and the docs are not complete and can be changed in binary- and source-incompatible diff --git a/src/reflect/scala/reflect/macros/Aliases.scala b/src/reflect/scala/reflect/macros/Aliases.scala index 7f7ab66848..92d76f4370 100644 --- a/src/reflect/scala/reflect/macros/Aliases.scala +++ b/src/reflect/scala/reflect/macros/Aliases.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that defines shorthands for the +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that defines shorthands for the * most frequently used types and functions of the underlying compiler universe. */ trait Aliases { diff --git a/src/reflect/scala/reflect/macros/Attachments.scala b/src/reflect/scala/reflect/macros/Attachments.scala index ba5ccf88f1..a77cebf415 100644 --- a/src/reflect/scala/reflect/macros/Attachments.scala +++ b/src/reflect/scala/reflect/macros/Attachments.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** Attachments provide a way to associate custom metadata with symbols and trees. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * Attachments provide a way to associate custom metadata with symbols and trees. * * Along with `symbol` and `tpe`, which represent core metadata of trees, each tree * carries the `attachments` field that can store other metadata: compiler-defined (e.g. positions) or user-defined. diff --git a/src/reflect/scala/reflect/macros/Context.scala b/src/reflect/scala/reflect/macros/Context.scala index 1f6e97adbc..aa1c1db227 100644 --- a/src/reflect/scala/reflect/macros/Context.scala +++ b/src/reflect/scala/reflect/macros/Context.scala @@ -5,7 +5,10 @@ package macros // the most lightweight context should just expose the stuff from the SIP // the full context should include all traits from scala.reflect.macros (and probably reside in scala-compiler.jar) -/** The Scala macros context. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * The Scala macros context. * * See [[scala.reflect.macros.package the overview page]] for a description of how macros work. This documentation * entry provides information on the API available to macro writers. diff --git a/src/reflect/scala/reflect/macros/Enclosures.scala b/src/reflect/scala/reflect/macros/Enclosures.scala index 41d6af94e3..c48656b366 100644 --- a/src/reflect/scala/reflect/macros/Enclosures.scala +++ b/src/reflect/scala/reflect/macros/Enclosures.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that exposes +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that exposes * enclosing trees (method, class, compilation unit and currently compiled application), * the enclosing position of the macro expansion, as well as macros and implicits * that are currently in-flight. diff --git a/src/reflect/scala/reflect/macros/Evals.scala b/src/reflect/scala/reflect/macros/Evals.scala index 6aab3d5b02..37680c219b 100644 --- a/src/reflect/scala/reflect/macros/Evals.scala +++ b/src/reflect/scala/reflect/macros/Evals.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that provides +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that provides * a facility to evaluate trees. */ trait Evals { diff --git a/src/reflect/scala/reflect/macros/ExprUtils.scala b/src/reflect/scala/reflect/macros/ExprUtils.scala index a9acc61735..458cde9692 100644 --- a/src/reflect/scala/reflect/macros/ExprUtils.scala +++ b/src/reflect/scala/reflect/macros/ExprUtils.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that defines shorthands for the +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that defines shorthands for the * most common `Expr`-creating functions. */ trait ExprUtils { diff --git a/src/reflect/scala/reflect/macros/FrontEnds.scala b/src/reflect/scala/reflect/macros/FrontEnds.scala index 8c47202342..67b24088b5 100644 --- a/src/reflect/scala/reflect/macros/FrontEnds.scala +++ b/src/reflect/scala/reflect/macros/FrontEnds.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that * provides facilities to communicate with the compiler's front end * (emit warnings, errors and other sorts of messages). */ diff --git a/src/reflect/scala/reflect/macros/Infrastructure.scala b/src/reflect/scala/reflect/macros/Infrastructure.scala index 2f3b8e8d19..99706e84fe 100644 --- a/src/reflect/scala/reflect/macros/Infrastructure.scala +++ b/src/reflect/scala/reflect/macros/Infrastructure.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that * provides facilities to communicate with the compiler's infrastructure. */ trait Infrastructure { diff --git a/src/reflect/scala/reflect/macros/Names.scala b/src/reflect/scala/reflect/macros/Names.scala index 20e750b225..8bbaa5f848 100644 --- a/src/reflect/scala/reflect/macros/Names.scala +++ b/src/reflect/scala/reflect/macros/Names.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that * provides functions that generate unique names. */ trait Names { diff --git a/src/reflect/scala/reflect/macros/Parsers.scala b/src/reflect/scala/reflect/macros/Parsers.scala index bf73c36b1b..93a763792c 100644 --- a/src/reflect/scala/reflect/macros/Parsers.scala +++ b/src/reflect/scala/reflect/macros/Parsers.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that * exposes functions to parse strings with Scala code into trees. */ trait Parsers { diff --git a/src/reflect/scala/reflect/macros/Reifiers.scala b/src/reflect/scala/reflect/macros/Reifiers.scala index d7ee30c7d9..3db7b9af02 100644 --- a/src/reflect/scala/reflect/macros/Reifiers.scala +++ b/src/reflect/scala/reflect/macros/Reifiers.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that * exposes functions to save reflection artifacts for runtime. */ trait Reifiers { diff --git a/src/reflect/scala/reflect/macros/TreeBuilder.scala b/src/reflect/scala/reflect/macros/TreeBuilder.scala index 727387c5af..362b35686c 100644 --- a/src/reflect/scala/reflect/macros/TreeBuilder.scala +++ b/src/reflect/scala/reflect/macros/TreeBuilder.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A helper available in [[scala.reflect.macros.Universe]] that defines shorthands for the +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A helper available in [[scala.reflect.macros.Universe]] that defines shorthands for the * most common tree-creating functions. */ abstract class TreeBuilder { diff --git a/src/reflect/scala/reflect/macros/Typers.scala b/src/reflect/scala/reflect/macros/Typers.scala index 016a08bd01..427e7854b2 100644 --- a/src/reflect/scala/reflect/macros/Typers.scala +++ b/src/reflect/scala/reflect/macros/Typers.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** A slice of [[scala.reflect.macros.Context the Scala macros context]] that +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * A slice of [[scala.reflect.macros.Context the Scala macros context]] that * partially exposes the type checker to macro writers. */ trait Typers { diff --git a/src/reflect/scala/reflect/macros/Universe.scala b/src/reflect/scala/reflect/macros/Universe.scala index 86bc37b4c9..4e76f7c408 100644 --- a/src/reflect/scala/reflect/macros/Universe.scala +++ b/src/reflect/scala/reflect/macros/Universe.scala @@ -1,7 +1,10 @@ package scala.reflect package macros -/** The refinement of [[scala.reflect.api.Universe]] for the use by macro writers. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * The refinement of [[scala.reflect.api.Universe]] for the use by macro writers. * * This universe provides mutability for reflection artifacts (e.g. macros can change types of compiler trees, * add annotation to symbols representing definitions, etc) and exposes some internal compiler functionality diff --git a/src/reflect/scala/reflect/macros/package.scala b/src/reflect/scala/reflect/macros/package.scala index 3a2f04bcf2..21d189bb25 100644 --- a/src/reflect/scala/reflect/macros/package.scala +++ b/src/reflect/scala/reflect/macros/package.scala @@ -1,6 +1,9 @@ package scala.reflect -/** The base package for Scala macros. +/** + * <span class="badge badge-red" style="float: right;">EXPERIMENTAL</span> + * + * The base package for Scala macros. * * Macros are functions that are called by the compiler during compilation. * Within these functions the programmer has access to compiler APIs exposed in [[scala.reflect.macros.Context]]. |