update release notes, glossary

FossilOrigin-Name: 9b404145f6397de19857415ca9143fc13697702f24b9939eb343a83525a94a8d

RELEASE-NOTES

@@ -1,22 +1,5 @@
 # RETRO 2020.01
 
-- rename package/list to package/list.forth
-- include signing keys for this and the next release
-- fix n:MIN and n:MAX queries on some of the interfaces
-- reduce default image size; max number of open files
-- updated html export for retro sources: averages 7.4% faster conversion, 26% smaller output across my test set
-- use a trick from https://getkiss.org/blog/20191004a to disable requests for a favicon in Atua-WWW
-- fix a bug in s:WHITESPACE and use it in c:whitespace?
-- reorganize source tree
-- add s:get-word
-- moved the assembler into rx.muri
-- add prefix:\
-- add prefix:^
-- deprecate as{
-- deprecate }as
-- deprecate prefix:"
-- deprecate "
-
 The 2020.1 release of RETRO brings many improvements.
 
 # Signed Releases
@@ -33,6 +16,9 @@ The HTML export for the examples has been updated. It now averages
 a 7.4% decrease in conversion and a 26% decrease in exported file
 size.
 
+retro-locate(1) was added to search the `tags` file created by
+retro-tags(1).
+
 # Assembler
 
 The assembler is now provided by Rx. This was a technical challenge,
@@ -71,12 +57,11 @@ The use of assembly to fine tune select words has allowed both
 size reduction and performance improvements.
 
 A few words have been deprecated due to lack of use and will be
-removed in the 2020.04 release:
+removed in the 2020.4 release:
 
 - prefix:"
 - "
 
-
 # Nga
 
 I reorganized the source tree. This separates the implementations
@@ -99,3 +84,23 @@ issues were found.
 I added an `s:get-word`, removed some deprecated words, and updated
 the memory limits to reduce overall memory usage under the default
 configuration.
+
+# Documentation
+
+The documentation has been updated, adding in new examples, removing
+material that is no longer relevant, and several new sections were
+added.
+
+# Examples
+
+New examples:
+
+- HTTP GET via sockets
+- HTTP POST via sockets
+- enum
+- minimize (from Kiyoshi)
+- fifo queue
+
+Updated:
+
+- Gott example (from Kiyoshi)

doc/Glossary-Concise.txt

@@ -1195,7 +1195,7 @@ Return `TRUE` if s1 ends with s2 or `FALSE` otherwise.
 s:eq?                    D: ss-f  A: -  F: -
 Compare two strings for equality. Return `TRUE` if identical or `FALSE` if not.
 
-s:evaluate               D: s-?  A: -  F: -
+s:evaluate               D: s-?  A: -  F: -?
 Evaluate string as if it was typed into the interpreter.
 
 s:filter                 D: sq-s  A: -  F: -

doc/Glossary-Names-and-Stack.txt

@@ -397,7 +397,7 @@ s:copy                   D: sa-  A: -  F: -
 s:empty                  D: -s  A: -  F: -
 s:ends-with?             D: ss-f  A: -  F: -
 s:eq?                    D: ss-f  A: -  F: -
-s:evaluate               D: s-?  A: -  F: -
+s:evaluate               D: s-?  A: -  F: -?
 s:filter                 D: sq-s  A: -  F: -
 s:for-each               D: sq-  A: -  F: -
 s:format                 D: ...s-s  A: -  F: -

doc/Glossary.html

@@ -3081,7 +3081,7 @@
 <h2>s:evaluate</h2>
 <div style='margin-left: 1em;'><p><b>Data:</b> s-?<br>
 <b>Addr:</b> -<br>
-<b>Float:</b> -</p>
+<b>Float:</b> -?</p>
 </div>
 <p>Evaluate string as if it was typed into the interpreter.</p>
 <table><tr><td><b>Class:</b> </td><td>class:word</td></tr><tr><td><b>Namespace:</b> </td><td>s</td></tr><tr><td><b>Interface Layer:</b> </td><td>all</td></tr></table><hr/>

doc/Glossary.txt

@@ -4720,7 +4720,7 @@ s:evaluate
 
   Data:  s-?
   Addr:  -
-  Float: -
+  Float: -?
 
 Evaluate string as if it was typed into the interpreter.
 

doc/book/glossary/glossary

@@ -4720,7 +4720,7 @@ s:evaluate
 
   Data:  s-?
   Addr:  -
-  Float: -
+  Float: -?
 
 Evaluate string as if it was typed into the interpreter.
 

doc/words.tsv

@@ -397,7 +397,7 @@ s:copy	sa-	-	-	Copy a string (s) to a destination (a). This will include the ter
 s:empty	-s	-	-	Return an empty string.			class:word	{n/a}	{n/a}	s	all	
 s:ends-with?	ss-f	-	-	Return `TRUE` if s1 ends with s2 or `FALSE` otherwise.			class:word	{n/a}	{n/a}	s	all	
 s:eq?	ss-f	-	-	Compare two strings for equality. Return `TRUE` if identical or `FALSE` if not.			class:word	    'hello 'again s:eq?\n    'test  'test  s:eq?	{n/a}	s	all	
-s:evaluate	s-?	-	-	Evaluate string as if it was typed into the interpreter.			class:word	{n/a}	{n/a}	s	all	
+s:evaluate	s-?	-	-?	Evaluate string as if it was typed into the interpreter.			class:word	{n/a}	{n/a}	s	all	
 s:filter	sq-s	-	-	Execute the quote once for each value in the string. If the quote returns `TRUE`, append the value into a new string. If `FALSE` the value will be discarded.			class:word	{n/a}	{n/a}	s	all	
 s:for-each	sq-	-	-	Execute the quote once for each value in the string.			class:word	{n/a}	{n/a}	s	all	
 s:format	...s-s	-	-	Construct a new string using the template passed and items from the stack.			class:word	{n/a}	{n/a}	s	all