From be7ed254fac04fc97692170b2b57ea3dbf448560 Mon Sep 17 00:00:00 2001 From: crc Date: Wed, 15 Jan 2020 13:32:51 +0000 Subject: [PATCH] update release notes, glossary FossilOrigin-Name: 9b404145f6397de19857415ca9143fc13697702f24b9939eb343a83525a94a8d --- RELEASE-NOTES | 43 ++++++++++++++++++-------------- doc/Glossary-Concise.txt | 2 +- doc/Glossary-Names-and-Stack.txt | 2 +- doc/Glossary.html | 2 +- doc/Glossary.txt | 2 +- doc/book/glossary/glossary | 2 +- doc/words.tsv | 2 +- 7 files changed, 30 insertions(+), 25 deletions(-) diff --git a/RELEASE-NOTES b/RELEASE-NOTES index ba5518d..25567fd 100644 --- a/RELEASE-NOTES +++ b/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) diff --git a/doc/Glossary-Concise.txt b/doc/Glossary-Concise.txt index cdc1306..e371109 100644 --- a/doc/Glossary-Concise.txt +++ b/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: - diff --git a/doc/Glossary-Names-and-Stack.txt b/doc/Glossary-Names-and-Stack.txt index a1bbfae..b8fbbf4 100644 --- a/doc/Glossary-Names-and-Stack.txt +++ b/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: - diff --git a/doc/Glossary.html b/doc/Glossary.html index 926142c..2f54f91 100644 --- a/doc/Glossary.html +++ b/doc/Glossary.html @@ -3081,7 +3081,7 @@

s:evaluate

Data: s-?
Addr: -
-Float: -

+Float: -?

Evaluate string as if it was typed into the interpreter.

Class: class:word
Namespace: s
Interface Layer: all
diff --git a/doc/Glossary.txt b/doc/Glossary.txt index 2bda8f9..2f4630e 100644 --- a/doc/Glossary.txt +++ b/doc/Glossary.txt @@ -4720,7 +4720,7 @@ s:evaluate Data: s-? Addr: - - Float: - + Float: -? Evaluate string as if it was typed into the interpreter. diff --git a/doc/book/glossary/glossary b/doc/book/glossary/glossary index 2bda8f9..2f4630e 100644 --- a/doc/book/glossary/glossary +++ b/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. diff --git a/doc/words.tsv b/doc/words.tsv index 85546fc..3fc30e5 100644 --- a/doc/words.tsv +++ b/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