From 0e6474263dfbaecfa326237df7431bb023bd7493 Mon Sep 17 00:00:00 2001
From: crc <crc@noemail.net>
Date: Tue, 13 Oct 2020 12:41:26 +0000
Subject: [PATCH] begin final prep for 2020.10 release

FossilOrigin-Name: d7d23e5d4eadc29362e87f247c855f748b48eb0e23b349abf063d8c57b81ac9d
---
 KNOWN-ISSUES                 | 17 ++++++++++-----
 RELEASE-NOTES                | 41 ++++++++++++++++++++++++++----------
 example/detect-devices.retro |  3 ++-
 3 files changed, 44 insertions(+), 17 deletions(-)

diff --git a/KNOWN-ISSUES b/KNOWN-ISSUES
index c9c9693..38caf99 100644
--- a/KNOWN-ISSUES
+++ b/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
diff --git a/RELEASE-NOTES b/RELEASE-NOTES
index b88738b..83ae5cb 100644
--- a/RELEASE-NOTES
+++ b/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
diff --git a/example/detect-devices.retro b/example/detect-devices.retro
index ac67c7f..54c85c4 100644
--- a/example/detect-devices.retro
+++ b/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 ;