Fix bugs and docs of FilePositionMap

I wasn't using some of those APIs for Node/Token,
and didn't notice the incorrect phpdoc/code.

Author: TysonAndre

src/FilePositionMap.php

@@ -24,7 +24,7 @@ class FilePositionMap {
     /** @var int the 0-based byte offset of the most recent request for a line number. */
     private $currentOffset;
 
-    /** @var int the line number for $this->currentOffset (updated whenever currentOffset is updated) */
+    /** @var int the 1-based line number for $this->currentOffset (updated whenever currentOffset is updated) */
     private $lineForCurrentOffset;
 
     public function __construct(string $file_contents) {
@@ -45,7 +45,7 @@ public function getNodeStartLine(Node $node) : int {
     }
 
     /**
-     * @param Node $node the node to get the start line for.
+     * @param Token $token the token to get the start line for.
      */
     public function getTokenStartLine(Token $token) : int {
         return $this->getLineNumberForOffset($token->start);
@@ -86,19 +86,23 @@ public function getEndLine($node) : int {
      * Similar to getStartLine but includes the column
      */
     public function getEndLineCharacterPositionForOffset($node) : LineCharacterPosition {
-        return $this->getLineCharacterPositionForOffset($node);
+        return $this->getLineCharacterPositionForOffset($node->getEndPosition());
     }
 
     /**
-     * @param Node|Token $node
-     * Similar to getStartLine but includes the column
+     * @param int $offset
+     * Similar to getStartLine but includes both the line and the column
      */
     public function getLineCharacterPositionForOffset(int $offset) : LineCharacterPosition {
         $line = $this->getLineNumberForOffset($offset);
         $character = $this->getColumnForOffset($offset);
         return new LineCharacterPosition($line, $character);
     }
 
+    /**
+     * @param int $offset - A 0-based byte offset
+     * @return int - gets the 1-based line number for $offset
+     */
     public function getLineNumberForOffset(int $offset) : int {
         if ($offset < 0) {
             $offset = 0;
@@ -117,7 +121,8 @@ public function getLineNumberForOffset(int $offset) : int {
     }
 
     /**
-     * @return int - gets the 1-based column offset
+     * @param int $offset - A 0-based byte offset
+     * @return int - gets the 1-based column number for $offset
      */
     public function getColumnForOffset(int $offset) : int {
         $length = $this->fileContentsLength;