add glossary data for err: words

FossilOrigin-Name: 3f7d9bc3844127e0ca897394df23360f590de35d6acfbebd78cdc36d2d7ff0b4
This commit is contained in:
crc 2023-10-02 15:14:07 +00:00
parent 37ea186ccc
commit 18d6998de0
6 changed files with 103 additions and 14 deletions

View file

@ -11,22 +11,19 @@
* nga-c: split device code into separate source files
* use hashed dictionary search by default
* removed words deprecated in 2022.8
* new example: konilo-wiki.retro
* new example: converting konilo wiki blocks to HTML
* new example: double cell math (32-bit cells)
* GNUmakefile fix from drakonis
* addition of an i/o device for handling some errors
* fixed `f:tan` and `f:cos`
* added `file:read/bytes` and `file:write/bytes`
* fixed `f:tan` and `f:cos` (thanks to Doug Bell)
* Casket HTTP server is much, much faster
================================================================
Development Notes:
It is likely that starting with this release, the source
distribution will default to building an executable from
the amalgamation (example/amalgamate.retro) rather than
rebuilding the image with each build. A new Makefile target
will be added for those wanting or needing to build a
custom ngaImage.
* Support internal translation of UTF8 and UTF32
New words:
file:read/bytes file:write/bytes file:read/c
file:write/c err:set-handler err:set-defaults
err:dso err:dsu fill
================================================================

View file

@ -778,9 +778,21 @@ Return `TRUE` if the value is zero, or `FALSE` otherwise.
eq? D: nn-f A: - F: -
Compare two values for equality. Returns `TRUE` if they are equal or `FALSE` otherwise.
err:dso D: - A: - F: -
Error handler for data stack overflow
err:dsu D: - A: - F: -
Error handler for data stack underflow.
err:notfound D: - A: - F: -
Vectored. Error handler. Called when a word is not found by `interpret`.
err:set-defaults D: - A: - F: -
Set the default error handlers for various conditions.
err:set-handler D: an- A: - F: -
Set error handler for error code N.
f:* D: - A: - F: FF-F
Multiply two floating-point numbers, returning the result.

View file

@ -258,7 +258,11 @@ e:put D: e- A: - F: -
e:to-f D: e- A: - F: -n
e:zero? D: e-f A: - F: -
eq? D: nn-f A: - F: -
err:dso D: - A: - F: -
err:dsu D: - A: - F: -
err:notfound D: - A: - F: -
err:set-defaults D: - A: - F: -
err:set-handler D: an- A: - F: -
f:* D: - A: - F: FF-F
f:+ D: - A: - F: FF-F
f:- D: - A: - F: FF-F

View file

@ -1910,6 +1910,20 @@
$a $b eq?</xmp>
</p>
<hr/>
<h2>err:dso</h2>
<div style='margin-left: 1em;'><p><b>Data:</b> -<br>
<b>Addr:</b> -<br>
<b>Float:</b> -</p>
</div>
<p>Error handler for data stack overflow</p>
<table><tr><td><b>Class:</b> </td><td>class:word</td></tr><tr><td><b>Namespace:</b> </td><td>err</td></tr><tr><td><b>Interface Layer:</b> </td><td>all</td></tr></table><hr/>
<h2>err:dsu</h2>
<div style='margin-left: 1em;'><p><b>Data:</b> -<br>
<b>Addr:</b> -<br>
<b>Float:</b> -</p>
</div>
<p>Error handler for data stack underflow.</p>
<table><tr><td><b>Class:</b> </td><td>class:word</td></tr><tr><td><b>Namespace:</b> </td><td>err</td></tr><tr><td><b>Interface Layer:</b> </td><td>all</td></tr></table><hr/>
<h2>err:notfound</h2>
<div style='margin-left: 1em;'><p><b>Data:</b> -<br>
<b>Addr:</b> -<br>
@ -1917,6 +1931,20 @@
</div>
<p>Vectored. Error handler. Called when a word is not found by `interpret`.</p>
<table><tr><td><b>Class:</b> </td><td>class:word</td></tr><tr><td><b>Namespace:</b> </td><td>err</td></tr><tr><td><b>Interface Layer:</b> </td><td>all</td></tr></table><hr/>
<h2>err:set-defaults</h2>
<div style='margin-left: 1em;'><p><b>Data:</b> -<br>
<b>Addr:</b> -<br>
<b>Float:</b> -</p>
</div>
<p>Set the default error handlers for various conditions.</p>
<table><tr><td><b>Class:</b> </td><td>class:word</td></tr><tr><td><b>Namespace:</b> </td><td>err</td></tr><tr><td><b>Interface Layer:</b> </td><td>all</td></tr></table><hr/>
<h2>err:set-handler</h2>
<div style='margin-left: 1em;'><p><b>Data:</b> an-<br>
<b>Addr:</b> -<br>
<b>Float:</b> -</p>
</div>
<p>Set error handler for error code N. </p>
<table><tr><td><b>Class:</b> </td><td>class:word</td></tr><tr><td><b>Namespace:</b> </td><td>err</td></tr><tr><td><b>Interface Layer:</b> </td><td>all</td></tr></table><hr/>
<h2>f:*</h2>
<div style='margin-left: 1em;'><p><b>Data:</b> -<br>
<b>Addr:</b> -<br>

View file

@ -2966,6 +2966,28 @@ Example #1:
------------------------------------------------------------------------
err:dso
Data: -
Addr: -
Float: -
Error handler for data stack overflow
Class: class:word | Namespace: err | Interface Layer: all
------------------------------------------------------------------------
err:dsu
Data: -
Addr: -
Float: -
Error handler for data stack underflow.
Class: class:word | Namespace: err | Interface Layer: all
------------------------------------------------------------------------
err:notfound
Data: -
@ -2977,6 +2999,28 @@ Vectored. Error handler. Called when a word is not found by `interpret`.
Class: class:word | Namespace: err | Interface Layer: all
------------------------------------------------------------------------
err:set-defaults
Data: -
Addr: -
Float: -
Set the default error handlers for various conditions.
Class: class:word | Namespace: err | Interface Layer: all
------------------------------------------------------------------------
err:set-handler
Data: an-
Addr: -
Float: -
Set error handler for error code N.
Class: class:word | Namespace: err | Interface Layer: all
------------------------------------------------------------------------
f:*
Data: -

View file

@ -258,7 +258,11 @@ e:put e- - - Display an encoded number. class:word {n/a} {n/a} e rre
e:to-f e- - -n Decode an encoded floating-point value. class:word {n/a} {n/a} e rre
e:zero? e-f - - Return `TRUE` if the value is zero, or `FALSE` otherwise. class:word {n/a} {n/a} e rre
eq? nn-f - - Compare two values for equality. Returns `TRUE` if they are equal or `FALSE` otherwise. class:primitive #1 #2 eq?\n $a $b eq? {n/a} global all
err:dso - - - Error handler for data stack overflow class:word {n/a} {n/a} err all
err:dsu - - - Error handler for data stack underflow. class:word {n/a} {n/a} err all
err:notfound - - - Vectored. Error handler. Called when a word is not found by `interpret`. class:word {n/a} {n/a} err all
err:set-defaults - - - Set the default error handlers for various conditions. class:word {n/a} {n/a} err all
err:set-handler an- - - Set error handler for error code N. class:word {n/a} {n/a} err all
f:* - - FF-F Multiply two floating-point numbers, returning the result. class:word .3.1415 .22 f:* {n/a} f rre
f:+ - - FF-F Add two floating-point numbers, returning the result. class:word .3.1 .22 f:+ {n/a} f rre
f:- - - FF-F Subtract F2 from F1 returning the result. class:word .22.3 .0.12 f:- {n/a} f rre

1 $ -c - - Return ASCII:NUL (0). class:macro {n/a} {n/a} global all
258 e:to-f e- - -n Decode an encoded floating-point value. class:word {n/a} {n/a} e rre
259 e:zero? e-f - - Return `TRUE` if the value is zero, or `FALSE` otherwise. class:word {n/a} {n/a} e rre
260 eq? nn-f - - Compare two values for equality. Returns `TRUE` if they are equal or `FALSE` otherwise. class:primitive #1 #2 eq?\n $a $b eq? {n/a} global all
261 err:dso - - - Error handler for data stack overflow class:word {n/a} {n/a} err all
262 err:dsu - - - Error handler for data stack underflow. class:word {n/a} {n/a} err all
263 err:notfound - - - Vectored. Error handler. Called when a word is not found by `interpret`. class:word {n/a} {n/a} err all
264 err:set-defaults - - - Set the default error handlers for various conditions. class:word {n/a} {n/a} err all
265 err:set-handler an- - - Set error handler for error code N. class:word {n/a} {n/a} err all
266 f:* - - FF-F Multiply two floating-point numbers, returning the result. class:word .3.1415 .22 f:* {n/a} f rre
267 f:+ - - FF-F Add two floating-point numbers, returning the result. class:word .3.1 .22 f:+ {n/a} f rre
268 f:- - - FF-F Subtract F2 from F1 returning the result. class:word .22.3 .0.12 f:- {n/a} f rre