doc updates

Author: twiddlingbits

docs/api/api-ts-library.md

@@ -9,7 +9,7 @@ twr-wasm Libraries are used to expose TypeScript code to C/C++ as C APIs.  All o
 There are two kinds of Libraries:
 
 - Those that have only once instance (such as the math library)
-- Those that can have multiple instances across one more more library types, where each library type implements the same interface.  Consoles are an example of this (see [interfaceName](#interfacename)).
+- Those that can have multiple instances across one or more library types, where each library type implements the same interface.  Consoles are an example of this (see [interfaceName](#interfacename)).
 
 ## Basic Steps
 twr-wasm Libraries support both `twrWasmModule` and `twrWasmModuleAsync`.  That is, when you create a twrLibrary, it will function with either type of module.  In many cases no extra work is needed for the `twrWasmModuleAsync`, but in some cases, extra code is needed.
@@ -352,7 +352,7 @@ In a twrLibrary,
 
  - An "interface" refers to the set of functions that the library exposes to C. Ie, the functions in the `import` object.
  - The name of the interface is anonymous, unless `interfaceName` is set. 
- - An undefined interfaceName (anonymous interface) means that only one instance of that class is allowed (for example `twrLibMath`)
+ - An undefined interfaceName (anonymous interface) also means that only one instance of that class is allowed (for example `twrLibMath`)
  - Set `interfaceName` to a unique name when multiple instances that support the same interface are allowed (for example the twr-wasm Consoles).  
  - Multiple classes may have the same interfaceName (a class is identified by its libSourcePath). For example `twrConDiv`, `twrConDebug`, `twrConTerminal` all have the same interface.
 

docs/api/api-ts-modules.md

@@ -17,7 +17,7 @@ const mod = new twrWasmModule();
 ~~~
 
 ## About `twrWasmModuleAsync`
-`class twrWasmModuleAsync` allows you to integrate WebAssembly C/C++ code into your Web Page that uses a CLI pattern or code that blocks.  For example, with `twrWasmModuleAsync` your C/C++ code can call a synchronous function for keyboard input (that blocks until the user has entered the keyboard input).  Or your C/C++ code can `sleep` or otherwise block.   This is the pattern that is used by many standard C library functions - `fread`, etc.  
+`class twrWasmModuleAsync` allows you to integrate WebAssembly C/C++ code into your Web Page that uses a Read-Eval-Print Loop (REPL) pattern, a CLI pattern or code that blocks.  For example, with `twrWasmModuleAsync` your C/C++ code can call a synchronous function for keyboard input (that blocks until the user has entered the keyboard input).  Or your C/C++ code can `sleep` or otherwise block.   This is the pattern that is used by many standard C library functions - `fread`, etc.  
 
 `class twrWasmModuleAsync` creates a WorkerThread that runs in parallel to the JavaScript main thread.  This Worker thread executes your C/C++ code, and proxies functionality that needs to execute in the JavaScript main thread via remote procedure calls.  This allows the JavaScript main thread to `await` on a blocking `callC` in your JavaScript main thread.  
 

docs/examples/examples-divcon.md

@@ -1,10 +1,19 @@
 ---
 title:  Stdio Printf and Input Using a div Tag
-description: This C WebAssembly example shows how to printf and get characters to and from an HTML div tag using twr-wasm
+description: This C WebAssembly example shows how to implement a Read-Eval-Print Loop (REPL) in twr-wasm
 ---
 
-# divcon - Printf and Input Using a div Tag
-This simple WebAssembly C program demos inputting and printing characters with a `div` tag.
+# divcon - Printf and Input Using a `div` Tag
+## What It Does
+This example inputs a number, squares it, and prints the result using standard C library functions.
+  
+The divcon example demos:
+
+* A Read-Eval-Print Loop (REPL) 
+* using twr-wasm `class twrWasmModuleAsync` to `await` on blocking C code
+* getting and print characters to a `div` tag using twr-wasm `class twrConsoleDiv`
+
+## Running Examples and Source:
 
 - [view divcon example running live](/examples/dist/divcon/index.html)
 - [View divcon source code](https://github.com/twiddlingbits/twr-wasm/tree/main/examples/divcon)

docs/examples/examples-multi-io.md

@@ -3,7 +3,7 @@ title: Multi-io - WebAssembly C++ Multiple Console Example
 description: This example demos 6 simultaneous consoles. 2 div as streams, 2 canvas as terminals, and 2 canvas as 2D draw surfaces.
 ---
 
-# Multi-io -Multiple Console Example
+# Multi-io Multiple Console Example
 ## What It Does
 This example demos six simultaneous consoles:
 

docs/examples/examples-overview.md

@@ -27,11 +27,11 @@ These examples are a good place to learn how to configure clang and wasm-ld to c
 | terminal |A simple C program demos writing and inputting from a `<canvas>` tag<br>that twr-wasm configures as a windowed "terminal" | [terminal](examples-terminal.md)|
 | multi-io | Demo 6 simultaneous consoles: stream i/o, terminal, and 2D Drawing. | [multi-io](examples-multi-io.md)|
 
-## Draw 2D Examples
+## Draw 2D and Audio Examples
 | Name | Description | Link |
 | -----| ----------- | ---- |
 | balls | These fun Bouncing Balls are written in C++ and demo the 2D drawing<br>APIs with a C++ Canvas wrapper class | [balls](examples-balls.md) |
-| pong | A simple game of Pong written in C++ to demo 2D drawing APIs with a<br>C++ canvas wrapper class and taking user input from JS | [pong](examples-pong.md)
+| pong | A simple game of Pong written in C++ to demo 2D drawing and Audio APIs with<br>a C++ canvas wrapper class and taking user input from JS | [pong](examples-pong.md)
 | maze | This is an old Win32 program ported to wasm and demos 2D Draw APIs | [maze](examples-maze.md) |
 
 ## Call Argument Examples
@@ -40,7 +40,7 @@ These examples are a good place to learn how to configure clang and wasm-ld to c
 | callC | A demo of passing and returning values between JavaScript and Wasm module | [callc](examples-callc.md) |
 | fft | A demo of calling a C library to perform an FFT that is graphed in TypeScript | [fft](examples-fft.md) |
 
-## twrLibrary examples
+## twrLibrary Examples
 | Name | Description | Link |
 | -----| ----------- | ---- |
 | lib | A demo of createing a twrLibrary (use TypeScript to create C/C++ APIs) | [library](examples-lib.md) |

docs/index.md

@@ -20,7 +20,8 @@ twr-wasm is a simple, lightweight and easy to use library for building C/C++ Web
 
 - the optional TypeScript `class twrWasmModuleAsync` can be used to:
 
-    - integrate CLI C/C++ code with JavaScript
+    - integrate a C/C++ Read-Eval-Print Loop (REPL) with JavaScript
+    - integrate a C/C++ CLI or Shell with JavaScript
     - In JavaScript `await` on blocking/synchronous C/C++ functions. 
 
 - 2D drawing API for C/C++ compatible with JavaScript Canvas

examples/divcon/index.html

@@ -1,8 +1,8 @@
 <!doctype html>
 <html>
 <head>
-   <title>Div Console WebAssembly Example</title>
-   <meta name="description" content="Use a streaming character console with C/C++ WebAssembly that maps stdin and stdout to a div tag. Uses twr-wasm.">
+   <title>Div Console WebAssembly C/C++ Example</title>
+   <meta name="description" content="Map stdin and stdout to a div tag using twr-wasm class twrConsoleDiv. Implements a Read-Eval-Print Loop (REPL)">
 
    <!-- importmap used to find unbundled twr-wasm -->
    <!-- also see package.json 'alias' for parcel bundler example  -->
@@ -17,7 +17,7 @@
 </head>
 <body style="background-color:white;font-family: Arial">
    <h1>twrConsoleDiv Demo</h1>
-   This example shows how to map a simple streaming character twr-wasm Console onto a div tag as stdio.  
+   This example shows how to map a simple streaming character twr-wasm Console onto a div tag as stdio.  A Read-Eval-Print Loop (REPL) is also implemented.
    <br><br>
    <a href="/docsite/examples/examples-overview/">docs and more examples here</a>
    <br><br>

readme.md

@@ -12,8 +12,9 @@ twr-wasm is a simple, lightweight and easy to use library for building C/C++ Web
   - in C/C++, print and get characters to/from a `<canvas>` based "terminal"
   - localization support, UTF-8, and windows-1252 support
 - the optional TypeScript `class twrWasmModuleAsync` can be used to:
-  - integrate CLI C/C++ code with JavaScript
-  - In JavaScript `await` on blocking/synchronous C/C++ functions. 
+ - integrate a C/C++ Read-Eval-Print Loop (REPL) with JavaScript
+ - integrate a C/C++ CLI or Shell with JavaScript
+ - In JavaScript `await` on blocking/synchronous C/C++ functions. 
 - 2D drawing API for C/C++ compatible with JavaScript Canvas
 - audio playback APIs for C/C++
 - create your own C/C++ APIs using TypeScript by extending `class twrLibrary`