Merge pull request scala/scala#6682 from martijnhoekstra/eitherprojections

deprecate either projections

Author: SethTisue

library/src/scala/util/Either.scala

@@ -161,12 +161,14 @@ sealed abstract class Either[+A, +B] extends Product with Serializable {
    *   for (e <- interactWithDB(someQuery).left) log(s"query failed, reason was $e")
    *   }}}
    */
+  @deprecated("use swap instead", "2.13.0")
   def left = Either.LeftProjection(this)
 
   /** Projects this `Either` as a `Right`.
    *
    *  Because `Either` is right-biased, this method is not normally needed.
    */
+  @deprecated("Either is now right-biased", "2.13.0")
   def right = Either.RightProjection(this)
 
   /** Applies `fa` if this is a `Left` or `fb` if this is a `Right`.
@@ -508,6 +510,7 @@ object Either {
    *  @author <a href="mailto:research@workingmouse.com">Tony Morris</a>, Workingmouse
    *  @see [[scala.util.Either#left]]
    */
+  @deprecated("use swap instead", "2.13.0")
   final case class LeftProjection[+A, +B](e: Either[A, B]) {
     /** Returns the value from this `Left` or throws `java.util.NoSuchElementException`
      *  if this is a `Right`.
@@ -651,6 +654,7 @@ object Either {
    *
    *  @author <a href="mailto:research@workingmouse.com">Tony Morris</a>, Workingmouse
    */
+  @deprecated("Either is now right-biased", "2.13.0")
   final case class RightProjection[+A, +B](e: Either[A, B]) {
 
     /** Returns the value from this `Right` or throws