Commits

crcx committed 2c244c8 Draft

update html documentation

Comments (0)

Files changed (1)

www/docs/The_Ngaro_Virtual_Machine.html

 <p>Ngaro provides a hardware character generator. This takes data off the stack,
 so you should make sure the character value is <em>on the stack</em> before using it.
 To use this, write the value 1 to port 2 and wait for an I/O event.</p>
-<p>The VM is expected to clear the screen when a negative value is passed.</p>
+<p>When a negative value is passed, the VM should clear the screen and position
+the cursor in the upper left corner.</p>
 <p>Usage Example:</p>
 <pre class="literal-block">
 #98 #1 #2 out,
 </tr>
 </thead>
 <tbody valign="top">
+<tr><td>1</td>
+<td><ul class="first last simple">
+<li></li>
+</ul>
+</td>
+<td>0</td>
+<td>Save the image</td>
+</tr>
+<tr><td>2</td>
+<td>filename</td>
+<td>0</td>
+<td>Include a file ( like --with )</td>
+</tr>
 <tr><td>-1</td>
 <td>filename, mode</td>
 <td>handle</td>
 </tr>
 <tr><td>-2</td>
 <td>handle</td>
-<td>flag</td>
+<td>byte</td>
 <td>Read a byte from a file</td>
 </tr>
 <tr><td>-3</td>
 </tbody>
 </table>
 <p>At a minimum, an implementation must provide support for -1, -5, -6, -8, and -9.</p>
+<p>For -5 and -6, &quot;depth&quot; refers to the number of items on the specified stack.</p>
 <p>For -10, the application must provide a buffer address on the stack, and a
 pointer to a string. The VM should search the system environment for the
-string and copy its value to the application memory, starting at the providedbuffer address.
-If an environment variable is not found, the VM should store a value of zero in the provided
-buffer address.</p>
+string and copy its value to the application memory, starting at the provided
+buffer address. If an environment variable is not found, the VM should store a
+value of zero in the provided buffer address.</p>
 <p>For -13, if the returned value is zero, the image can assume a 32-bit environment.</p>
 <p>For -14, if the VM is using big endian internally, this should return a value of 1.</p>
 </div>