Skip to content

Commit 16e2d15

Browse files
committed
update and improve description of deprecation policy
the old text said that if we (e.g.) deprecated something in 2.12.x, we couldn't remove it until 2.14.0. that was never the intent, it isn't what we have said elsewhere, and I don't think the community ever understood that to be the policy, either.
1 parent 7311a29 commit 16e2d15

File tree

1 file changed

+8
-10
lines changed

1 file changed

+8
-10
lines changed

src/library/scala/deprecated.scala

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -39,20 +39,18 @@ import scala.annotation.meta._
3939
* '''`@deprecated` in the Scala language and its standard library'''<br/>
4040
*
4141
* A deprecated element of the Scala language or a definition in the Scala standard library will
42-
* be preserved or at least another major version.
42+
* be preserved at least for the current major version.
4343
*
44-
* This means that an element deprecated since 2.12 will be preserved in 2.13, but will very likely
45-
* not be part of 2.14. Sometimes a deprecated element might be kept for more than a major
46-
* release to ease migration and upgrades from older Scala versions.<br/>
47-
* Developers should not rely on this.
44+
* This means that an element deprecated in some 2.12.x release will be preserved in
45+
* all 2.12.x releases, but may be removed in 2.13. (A deprecated element
46+
* might be kept longer to ease migration. Developers should not rely on this.)
4847
*
4948
* '''Special deprecation policy for Scala 2.12'''<br>
50-
* The Scala team has decided to enact a special deprecation policy for the 2.12 release:<br/>
49+
* The Scala team has decided to enact a special deprecation policy for Scala 2.12:<br/>
5150
*
52-
* As an upgrade from Scala 2.11 to Scala 2.12 also requires upgrading from Java 6 to Java 8,
53-
* no deprecated elements will be removed in this release to ease migration and upgrades
54-
* from older Scala versions. This means that elements deprecated since 2.11 (or earlier)
55-
* will not be removed in Scala 2.12.
51+
* As an upgrade from 2.11 to 2.12 also requires upgrading from Java 6 to Java 8,
52+
* deprecated elements will not normally be removed in this release, to ease migration
53+
* and cross-building.
5654
*
5755
* @see The official documentation on [[http://www.scala-lang.org/news/2.11.0/#binary-compatibility binary compatibility]].
5856
* @param message the message to print during compilation if the definition is accessed

0 commit comments

Comments
 (0)