From 2ba19ff2b8a6253c6fb7795f35d4fb1c30ec6c30 Mon Sep 17 00:00:00 2001
From: Umang Raghuvanshi <u@umangis.me>
Date: Mon, 17 Sep 2018 14:14:42 +0530
Subject: tty: document `WriteStream.cursorTo()` and others

Adds documentation for the following `WriteStream` instance methods:

- `WriteStream.clearLine()`
- `WriteStream.clearScreenDown()`
- `WriteStream.cursorTo()`
- `WriteStream.getWindowSize()`
- `WriteStream.moveCursor()`

PR-URL: https://github.com/nodejs/node/pull/22893
Fixes: https://github.com/nodejs/node/issues/9853
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
---
 doc/api/tty.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 62 insertions(+), 8 deletions(-)

(limited to 'doc/api/tty.md')

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 45b66abb9e..2b20548156 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -99,29 +99,46 @@ process.stdout.on('resize', () => {
 });
 ```
 
-### writeStream.columns
+### writeStream.clearLine(dir)
 <!-- YAML
 added: v0.7.7
 -->
 
-A `number` specifying the number of columns the TTY currently has. This property
-is updated whenever the `'resize'` event is emitted.
+* `dir` {number}
+  * `-1` - to the left from cursor
+  * `1` - to the right from cursor
+  * `0` - the entire line
 
-### writeStream.isTTY
+`writeStream.clearLine()` clears the current line of this `WriteStream` in a
+direction identified by `dir`.
+
+### writeStream.clearScreenDown()
 <!-- YAML
-added: v0.5.8
+added: v0.7.7
 -->
 
-A `boolean` that is always `true`.
+`writeStream.clearScreenDown()` clears this `WriteStream` from the current
+cursor down.
 
-### writeStream.rows
+### writeStream.columns
 <!-- YAML
 added: v0.7.7
 -->
 
-A `number` specifying the number of rows the TTY currently has. This property
+A `number` specifying the number of columns the TTY currently has. This property
 is updated whenever the `'resize'` event is emitted.
 
+### writeStream.cursorTo(x, y)
+<!-- YAML
+added: v0.7.7
+-->
+
+* `x` {number}
+* `y` {number}
+
+`writeStream.cursorTo()` moves this `WriteStream`'s cursor to the specified
+position.
+
 ### writeStream.getColorDepth([env])
 <!-- YAML
 added: v9.9.0
@@ -148,6 +165,43 @@ to pass in an object with different settings.
 Use the `NODE_DISABLE_COLORS` environment variable to enforce this function to
 always return 1.
 
+### writeStream.getWindowSize()
+<!-- YAML
+added: v0.7.7
+-->
+* Returns: {number[]}
+
+`writeStream.getWindowSize()` returns the size of the [TTY](tty.html)
+corresponding to this `WriteStream`. The array is of the type
+`[numColumns, numRows]` where `numColumns` and `numRows` represent the number
+of columns and rows in the corresponding [TTY](tty.html).
+
+### writeStream.isTTY
+<!-- YAML
+added: v0.5.8
+-->
+
+A `boolean` that is always `true`.
+
+### writeStream.moveCursor(dx, dy)
+<!-- YAML
+added: v0.7.7
+-->
+
+* `dx` {number}
+* `dy` {number}
+
+`writeStream.moveCursor()` moves this `WriteStream`'s cursor *relative* to its
+current position.
+
+### writeStream.rows
+<!-- YAML
+added: v0.7.7
+-->
+
+A `number` specifying the number of rows the TTY currently has. This property
+is updated whenever the `'resize'` event is emitted.
+
 ## tty.isatty(fd)
 <!-- YAML
 added: v0.5.8
-- 
cgit v1.2.3