cleanups (scaladoc 2, deprecation warnings, tra...

cleanups (scaladoc 2, deprecation warnings, trailing blanks)

1 files changed, 13 insertions, 11 deletions

diff --git a/src/library/scala/io/Position.scala b/src/library/scala/io/Position.scala
index 917d61ec25..5d1e695add 100644
--- a/src/library/scala/io/Position.scala
+++ b/src/library/scala/io/Position.scala
@@ -10,24 +10,26 @@ package scala.io
 
 /** The object Position provides convenience methods to encode
  *  line and column number in one single integer.  The encoded line
- *  (column) numbers range from 0 to LINE_MASK (COLUMN_MASK),
- *  where 0 indicates that the line (column) is undefined and 1
- *  represents the first line (column).
+ *  (column) numbers range from 0 to `LINE_MASK` (`COLUMN_MASK`),
+ *  where `0` indicates that the line (column) is undefined and
+ *  `1` represents the first line (column).
  *
- *  Line (Column) numbers greater than LINE_MASK (COLUMN_MASK) are
- *  replaced by LINE_MASK (COLUMN_MASK). Furthermore, if the encoded
- *  line number is LINE_MASK, the column number is always set to 0.
+ *  Line (Column) numbers greater than `LINE_MASK` (`COLUMN_MASK`) are
+ *  replaced by `LINE_MASK` (`COLUMN_MASK`). Furthermore, if the encoded
+ *  line number is `LINE_MASK`, the column number is always set to 0.
  *
  *  The following properties hold:
  *
- *  the undefined position is 0:   encode(0,0) == 0
- *  encodings are non-negative :   encode(line,column) >= 0
+ *  the undefined position is 0:   `encode(0,0) == 0`
+ *  encodings are non-negative :   `encode(line,column) >= 0`
  *  position order is preserved:
- *
+ *  {{{
  *  (line1 <= line2) || (line1 == line2 && column1 <= column2)
- *                     implies
+ *  }}}
+ *  implies
+ *  {{{
  *  encode(line1,column1) <= encode(line2,column2)
- *
+ *  }}}
  *  @author Burak Emir (translated from work by Matthias Zenger and others)
  */
 abstract class Position {