begin final prep for 2020.10 release

FossilOrigin-Name: d7d23e5d4eadc29362e87f247c855f748b48eb0e23b349abf063d8c57b81ac9d

KNOWN-ISSUES

@@ -1,11 +1,18 @@
+Bug tracking is now handled via the tracker on sr.ht. See
+https://todo.sr.ht/~crc_/retroforth for the full list.
+
+This file contains a brief summary of 
+
 retro-compiler
 
-  The retro-compiler currently fails to work on at least some
-  ARM Linux systems. See https://todo.sr.ht/~crc_/retroforth/3
+    The retro-compiler currently fails to work on at least some
+    ARM Linux systems.
+
+    See https://todo.sr.ht/~crc_/retroforth/3
 
 retro-unix
 
-  Scripting Interface
-
-    sys:abort-include causes an invalid instruction error in
+    `sys:abort-include` causes an invalid instruction error in
     some circumstances. (Reported by Xiyoshi)
+ 
+    See https://todo.sr.ht/~crc_/retroforth/17

RELEASE-NOTES

@@ -1,21 +1,40 @@
 # RETRO 2020.10
 
-Tooling
+This update has focused on improvements to the toolchain and
+general cleaups and bug fixes.
+
+Of particular note: when building the C implementation, you
+can now override the image and stack sizes when building. For
+Python users, the core toolchain (retro-unu, retro-muri, and
+retro-extend) has now been implemented in Python as well as C,
+so you can now build RETRO without needing a C compiler.
+
+## Notable Bugs Fixed
 
-- added a `make image-js` target to generate the image.js
 - fixed a bug in the glossary that caused names to appear twice
   (reported by Kiyoshi)
 - fixed a bug in retro-describe due to use of a deprecated word
+- retro.py: fixed a bug in the stack depth reporting
+  (thanks to Scott McCallum for reporting this)
+- fixed the `sh` instruction (which was totally broken prior to
+  this, thanks to Scott for reporting this)
+
+## Build Improvements
+
+- added a `make image-js` target to generate the image.js
 - allow setting the image size, stack sizes when building
+
+## Toolchain
+
 - add Python implementations of retro-unu, retro-muri, retro-extend
 - add support for generating an epub from the documentation
 - add a tool to locate files using deprecated words
 
-Standard Library
+## General Improvements
 
 - remove deprecated words
 
-Unix
+## For Unix Users
 
 - added `script:current-file` to return the filename being processed
 - added `script:current-line` to return the current line number being
@@ -36,21 +55,21 @@ Unix
   - io:float-operation (now float:operation)
   - io:socket-operation (now socket:operation)
 
-Python
+## For users of Python
 
-- fixed a bug in the stack depth reporting (thanks to Scott McCallum for
-  noticing this)
-- fixed the `sh` instruction (which was totally broken prior to this, thanks
-  to Scott for reporting this)
+- add Python implementations of retro-unu, retro-muri, retro-extend
 - retro.py now supports the floating point i/o device
 - added support for file i/o device
+- added support for the basic (level 0) scripting interface
+- source formatting should now be consistent across all files
 
-Documentation
+## Documentation
 
 - removed reference to old Makefile that no longer exists
 - updates word namings for deprecated words that have been removed
+- epub version of the documentation
 
-Examples
+## Examples
 
 - add: markdown to xhtml
 - add: retro in retro

example/detect-devices.retro

@@ -8,11 +8,12 @@ description of each.
   #2 [ 'floating-point s:put nl ] case
   #3 [ 'block-store s:put nl ] case
   #4 [ 'filesystem s:put nl ] case
-  #5 [ 'reserved s:put nl ] case
+  #5 [ 'clock s:put nl ] case
   #6 [ 'reserved s:put nl ] case
   #7 [ 'sockets s:put nl ] case
   #8 [ 'unix-syscalls s:put nl ] case
   #9 [ 'scripting s:put nl ] case
+  #10 [ 'random-number-generator s:put nl ] case
   #1000 [ 'saving-image s:put nl ] case
   'unknown:_ s:put n:put nl ;