Update documentation about cursor move

Fixes #115

Author: slachiewicz

jansi/src/main/java/org/fusesource/jansi/Ansi.java

@@ -236,7 +236,7 @@ public Ansi a(Attribute attribute) {
         }
 
         @Override
-        public Ansi cursor(int x, int y) {
+        public Ansi cursor(int row, int column) {
             return this;
         }
 
@@ -494,8 +494,17 @@ public Ansi a(Attribute attribute) {
         return this;
     }
 
-    public Ansi cursor(final int x, final int y) {
-        return appendEscapeSequence('H', x, y);
+    /**
+     * Moves the cursor to row n, column m.
+     * The values are 1-based, and default to 1 (top left corner) if omitted.
+     * A sequence such as CSI ;5H is a synonym for CSI 1;5H as well as CSI 17;H is the same as CSI 17H and CSI 17;1H
+     *
+     * @param row row (1-based) from top
+     * @param column column (1 based) from left
+     * @return Ansi
+     */
+    public Ansi cursor(final int row, final int column) {
+        return appendEscapeSequence('H', row, column);
     }
 
     public Ansi cursorToColumn(final int x) {

jansi/src/test/java/org/fusesource/jansi/AnsiStringTest.java

@@ -26,17 +26,23 @@
  */
 public class AnsiStringTest {
     @Test
-    public void testNotEncoded() throws Exception {
+    public void testNotEncoded() {
         AnsiString as = new AnsiString("foo");
         assertEquals("foo", as.getEncoded());
         assertEquals("foo", as.getPlain());
         assertEquals(3, as.length());
     }
 
     @Test
-    public void testEncoded() throws Exception {
+    public void testEncoded() {
         AnsiString as = new AnsiString(Ansi.ansi().a(Ansi.Attribute.INTENSITY_BOLD).a("foo").reset().toString());
         assertEquals("foo", as.getPlain());
         assertEquals(3, as.length());
     }
+
+    @Test
+    public void testCursorPosition() {
+        Ansi ansi = Ansi.ansi().cursor( 3, 6 ).reset();
+        assertEquals("\u001B[3;6H\u001B[m", ansi.toString());
+    }
 }