Update tutorial

kgryte · kgryte · commit 649f7ae4ff9a · 2019-08-07T22:16:26.000-07:00
diff --git a/lib/node_modules/@stdlib/repl/docs/tutorials/read_eval_print_loop.txt b/lib/node_modules/@stdlib/repl/docs/tutorials/read_eval_print_loop.txt
@@ -2,19 +2,29 @@
 
 • At the command prompt, enter
 
-```javascript
-pres();
-```
+  ```javascript
+  pres();
+  ```
 
-followed by \*RETURN\s to see the list of available commands.
+  followed by \*RETURN\s to see the list of available commands.
 
 • Enter
 
-```javascript
-n();
-```
+  ```javascript
+  n();
+  ```
+
+  followed by \*RETURN\s to advance the tutorial.
+
+---
 
-followed by \*RETURN\s to advance the tutorial.
+• To end the tutorial at any time, enter
+
+  ```javascript
+  presentationStop();
+  ```
+
+  followed by \*RETURN\s.
 
 ---
 
@@ -89,11 +99,174 @@ the \*r\sead-\*e\sval-\*p\srint \*l\soop.
 
 --
 
-• interactivity
+• demos (including live coding)
+
+--
+
+• interactivity (such as during iterative development)
+
+---
+
+To get started using this REPL, a few commands will prove immensely useful.
+
+---
+
+The first command is
+
+```javascript
+help()
+```
+
+Run the above command to see a list of REPL commands.
+
+---
+
+To see the documentation for a specific REPL alias, provide the alias to the
+`help()` command.
+
+For example, run
+
+```javascript
+help( 'base.sin' )
+```
+
+to see the documentation for the 'base.sin' function.
+
+---
+
+On the previous slide, you specified the alias via a string representing the
+alias name.
+
+You can also provide a reference pointing to the aliased value.
+
+For example, run
+
+```javascript
+help( base.sin )
+```
+
+to see the same documentation as before.
+
+---
+
+Additionally, for objects having known methods, you can print method
+documentation.
+
+For example, run
+
+```javascript
+help( base.random.randu.factory )
+```
+
+to see the `factory()` method documentation.
 
 ---
 
-TODO: help and docs
+Lastly, for select objects having a known constructor, you can provide
+instances.
+
+For example, create a Float64Array
+
+```javascript
+var x = new Float64Array( 10 );
+```
+
+and then run
+
+```javascript
+help( x )
+```
+
+which will print the documentation for Float64Array.
+
+---
+
+The `help()` command provides detailed API documentation.
+
+Sometimes, you just want to know the function signature and a brief
+description.
+
+For this use case, you can use another command: `info()`.
+
+For example, run
+
+```javascript
+info( 'base.sin' )
+```
+
+to see abbreviated API documentation for 'base.sin'.
+
+---
+
+Similar to `help()`, you can provide a variable reference.
+
+For example, run
+
+```javascript
+info( base.sin )
+```
+
+to see the same abbreviated API documentation.
+
+---
+
+Another useful command is `example()`, which runs the example code found in
+the documentation printed by `help()`.
+
+For example, run
+
+```javascript
+example( 'base.sin' )
+```
+
+to run the example code found in the documentation for 'base.sin'.
+
+---
+
+Similarly to `help()` and `info()`, you can provide a variable reference.
+
+For example, run
+
+```javascript
+example( base.sin )
+```
+
+to again run the example code for 'base.sin'.
+
+---
+
+Finally, two other commands are useful when wanting to resolve aliases and
+package implementations.
+
+To determine which package corresponds to a specified alias, use
+`alias2pkg()`.
+
+For example, run
+
+```javascript
+alias2pkg( 'base.sin' )
+```
+
+or
+
+```javascript
+alias2pkg( base.sin )
+```
+
+to resolve the package for 'base.sin'.
+
+---
+
+To determine which alias corresponds to a specified package, use
+`pkg2alias()`.
+
+For example, run
+
+```javascript
+pkg2alias( '@stdlib/math/base/special/sin' )
+```
+
+to resolve the alias for '@stdlib/math/base/special/sin'.
 
 ---
 
