retroforth/RELEASE_NOTES.md

# RETRO 12.2019.6

This is the changelog for the development builds of Retro.
I am currently planning to have the next release occur in
June 2019.

## Bug Fixes

## Build

- parallel builds now work
- refactor Makefile
- support for adding custom code to an image at build
  time (see packages/list)
- only build the toolchain and `retro` binary by default

## Core Language

- remove `set:from-results`
- add `if;`
- add `-if;`
- add `hook`
- add `set-hook`
- add `unhook`
- `c:put` primitive is a hookable word

## I/O and Extensions

### Floating Point

- add f:push
- add f:pop
- add f:dup-pair
- add f:drop-pair
- add f:rot
- add f:nip
- add f:min
- add f:max
- add f:limit
- add f:between?
- add f:inc
- add f:dec
- add f:case
- add f:dump-stack
- improved f:tuck
- improved f:over

### Unix

- add unix:get-cwd
- add unix:count-files-in-cwd
- add unix:for-each-file

## Nga

## Interfaces

- use strlcpy, strlcat instead of strcpy and strcat
- include copies of the above for users of glibc
- add retro-compiler
- add random number generator

### retro

- add random number generator
- add `-u filename` startup parameter to allow selection of
  image file
- add `image:save`

### retro-compiler

- new interface for creating turnkey executables on bsd, linux

### retro-ri

- support switching between multiple copies of the image
- add random number generator
- add image:save

## Tools

- use strlcpy, strlcat instead of strcpy and strcat
- retro-extend: cleaner output
- retro-extend: remove unused code
- retro-extend: allow multiple files
- retro-extend: reduce memory usage
- retro-extend: fix potential buffer overrun
- muri: remove the unused `c` directive

## Other

## Documentation

- add a collection of papers
- refactor glossary tool
- add HTML version of the Glossary
- add more concise text copies of the Glossary
- add man pages
- add BUILDING.md

## Examples

- add Abort.forth
- add atua-gophermap.forth
- add Buffer.forth
- add CaptureOutput.forth
- add DisplayNames.forth
- add EvaluateString.forth
- add FloatVar.forth
- add Forget.forth
- add HTML.forth
- add KeyValueStore.forth
- add Marker.forth
- add Naming_Quotes.forth
- add net_fetch.forth
- add paste.forth
- add Paste_to_Sprunge.forth
- add retro-extend.forth
- add retro-embedimage.forth
- add Save_and_Restore_Stack.forth
- add share.forth and shared.forth
- add uuencode.forth
- add uudecode.forth
- fix test block in defstruct.forth
- switch to dvorak key bindings in Roo.forth
- remove Hooks.forth (now in core language)
- improved edit.forth from Kiyoshi
- Casket-HTTP now supports server side scripting

## Final Notes
start new release notes FossilOrigin-Name: 4da8379389a13c0eda779357c49411d3a04f3b71d67324a97eb39d6bfbf9b326 2019-01-10 19:28:41 +01:00			`# RETRO 12.2019.6`
update release notes FossilOrigin-Name: da724defdd7ac9eb1580368de7f763a4ffe5393ff2cfc32364bb00cef1e88a17 2018-11-09 05:01:12 +01:00
new example: naming quotes FossilOrigin-Name: b7cb708ed7e5c798fddf0c30e9ac2eaf7f2951a958b17599e62e81c20987d9d5 2019-01-31 22:37:28 +01:00			`This is the changelog for the development builds of Retro.`
			`I am currently planning to have the next release occur in`
			`June 2019.`

update copyright year in unu FossilOrigin-Name: 264fec34bc2430f967e2788ea101295c80205e93bf7aeab894afaeda96829cc5 2018-11-04 22:57:09 +01:00			`## Bug Fixes`
will now start including a RELEASE_NOTES file for the release. (Starting w/2017.12) FossilOrigin-Name: 67239bbb7ebda09554e6be614bb7dc9d41ec486493be9cf243fa1cda1148ca89 2017-11-19 02:12:29 +01:00
begin prep for 2018.8 release FossilOrigin-Name: b12981c0facb74b4d1a08abd1058f02d22d99771e9e6a2fc5c20d07524efcc47 2018-07-31 17:38:06 +02:00			`## Build`
begin prep for 2018.4 release FossilOrigin-Name: 69afc8606886d53510f1897ea28af0d28284770ea6dca38e2cdc54216c90899a 2018-04-18 17:42:23 +02:00
start new release notes FossilOrigin-Name: 4da8379389a13c0eda779357c49411d3a04f3b71d67324a97eb39d6bfbf9b326 2019-01-10 19:28:41 +01:00			`- parallel builds now work`
roo example: use dvorak FossilOrigin-Name: 5fa3bea0d91e1050da20cea23fc661ad2578f5b11b479cb9ce1100568debd7f3 2019-01-16 18:57:12 +01:00			`- refactor Makefile`
some release notes updates FossilOrigin-Name: 5744b0cd5aae55215fe1e06f7a4b9302a81ae2b1b0fc85d9b627c6c667d13814 2019-02-07 05:12:24 +01:00			`- support for adding custom code to an image at build`
			`time (see packages/list)`
include source files in packages/ in final image FossilOrigin-Name: e78ad72ecc011b6db376e6205ed2ec198bbc221c12b17a079bc2bd0dc3da1138 2019-02-06 04:41:05 +01:00			- only build the toolchain and `retro` binary by default
more renamings of binaries FossilOrigin-Name: 71a5169ee7f1f927a78990f1ed2a571250a33b1bba93ab6d7f80d98d70fd690c 2018-11-04 22:34:56 +01:00
begin prep for 2018.8 release FossilOrigin-Name: b12981c0facb74b4d1a08abd1058f02d22d99771e9e6a2fc5c20d07524efcc47 2018-07-31 17:38:06 +02:00			`## Core Language`
will now start including a RELEASE_NOTES file for the release. (Starting w/2017.12) FossilOrigin-Name: 67239bbb7ebda09554e6be614bb7dc9d41ec486493be9cf243fa1cda1148ca89 2017-11-19 02:12:29 +01:00
start new release notes FossilOrigin-Name: 4da8379389a13c0eda779357c49411d3a04f3b71d67324a97eb39d6bfbf9b326 2019-01-10 19:28:41 +01:00			- remove `set:from-results`
add if; and -if; FossilOrigin-Name: 5c1a06cda34b3223dc0e1b552ced9bd07ab0b10327c246b4fb3fa69efb3de75f 2019-01-11 21:27:50 +01:00			- add `if;`
			- add `-if;`
hooks now part of core language FossilOrigin-Name: 9c7796470e71fe1e14f800ab7f0a00cb3f91cb265e2d52b6e4ab77e7c185c6bc 2019-01-19 05:49:47 +01:00			- add `hook`
			- add `set-hook`
			- add `unhook`
			- `c:put` primitive is a hookable word
rx: slightly smaller/faster s:eq? FossilOrigin-Name: cd500d6c046c27a6ff00ab3bf75e7b21f8727462fdcda50fbd01df0e3579baee 2018-02-12 19:23:34 +01:00
add f:min f:max f:limit f:between? f:inc f:dec FossilOrigin-Name: aa70ea4e2b3916c4511d69ace5a30b5342e446f952d14a4e0c0f886cc6102886 2019-01-28 15:38:15 +01:00			`## I/O and Extensions`

			`### Floating Point`

			`- add f:push`
			`- add f:pop`
			`- add f:dup-pair`
			`- add f:drop-pair`
			`- add f:rot`
			`- add f:nip`
			`- add f:min`
			`- add f:max`
			`- add f:limit`
			`- add f:between?`
			`- add f:inc`
			`- add f:dec`
add f:case FossilOrigin-Name: 104609852db68dd5733c8105225926e249d203a3ff25ae105f1acf3d7362bd8c 2019-01-28 16:27:24 +01:00			`- add f:case`
add f:dump-stack FossilOrigin-Name: 2d90f488cd7acd2419edfaeb6364675bd9122efe738a093aa03c80ffecebc84a 2019-01-29 03:21:52 +01:00			`- add f:dump-stack`
add f:min f:max f:limit f:between? f:inc f:dec FossilOrigin-Name: aa70ea4e2b3916c4511d69ace5a30b5342e446f952d14a4e0c0f886cc6102886 2019-01-28 15:38:15 +01:00			`- improved f:tuck`
			`- improved f:over`

unix interface: add some directory related words FossilOrigin-Name: 0ec5a358a46e9fcdb58109e5a8f7394662a09986e5bb395ad42b5c1a46a49f96 2019-02-01 21:26:17 +01:00			`### Unix`

			`- add unix:get-cwd`
			`- add unix:count-files-in-cwd`
			`- add unix:for-each-file`

initial support of new instructions for i/o in primary C interfaces FossilOrigin-Name: f974eae71e05b1b9ddbc3d7c85b5eb9e48fddf73111e173b0b6acbc3c8f6fbc7 2018-11-22 01:05:28 +01:00			`## Nga`

begin prep for 2018.8 release FossilOrigin-Name: b12981c0facb74b4d1a08abd1058f02d22d99771e9e6a2fc5c20d07524efcc47 2018-07-31 17:38:06 +02:00			`## Interfaces`
will now start including a RELEASE_NOTES file for the release. (Starting w/2017.12) FossilOrigin-Name: 67239bbb7ebda09554e6be614bb7dc9d41ec486493be9cf243fa1cda1148ca89 2017-11-19 02:12:29 +01:00
more cleanups FossilOrigin-Name: 87ef440789795b1f6ea207b9b07a598b5ee0598bca0fe98c5e43d460f1f43df1 2019-01-11 04:26:40 +01:00			`- use strlcpy, strlcat instead of strcpy and strcat`
new example: using pipes and curl to make network requests FossilOrigin-Name: 4ee196650050b118929e3c2af90a3145321f7cb76e57a9c9e8b8b49f5354a0a3 2019-01-18 18:33:31 +01:00			`- include copies of the above for users of glibc`
use snprintf in retro-compiler instead of sprintf FossilOrigin-Name: a4bf46b447abe61d2bba28b19a30298de7948cb06c38e3b49fa93f2485b2fd23 2019-01-11 18:57:51 +01:00			`- add retro-compiler`
add random number generator FossilOrigin-Name: df5f0a97872a37bd503488968379b564c03154c60a5d8deea6e361021e199a1d 2019-01-19 18:28:17 +01:00			`- add random number generator`
more cleanups FossilOrigin-Name: 87ef440789795b1f6ea207b9b07a598b5ee0598bca0fe98c5e43d460f1f43df1 2019-01-11 04:26:40 +01:00
use snprintf in retro-compiler instead of sprintf FossilOrigin-Name: a4bf46b447abe61d2bba28b19a30298de7948cb06c38e3b49fa93f2485b2fd23 2019-01-11 18:57:51 +01:00			`### retro`
small improvement to s:format FossilOrigin-Name: 79d5f09c0fc6200d6712a38eac8e3f7b53ceb582c9cd6e5df4238ffaef72ec02 2018-09-06 17:50:08 +02:00
add random number generator FossilOrigin-Name: df5f0a97872a37bd503488968379b564c03154c60a5d8deea6e361021e199a1d 2019-01-19 18:28:17 +01:00			`- add random number generator`
rre: add -u command line option FossilOrigin-Name: 56a0437f8913f2f670fc6244e102d23f608a40f67c0e93d66bcc471a2ce43555 2019-01-22 15:35:31 +01:00			- add `-u filename` startup parameter to allow selection of
			`image file`
some release notes updates FossilOrigin-Name: 5744b0cd5aae55215fe1e06f7a4b9302a81ae2b1b0fc85d9b627c6c667d13814 2019-02-07 05:12:24 +01:00			- add `image:save`
add random number generator FossilOrigin-Name: df5f0a97872a37bd503488968379b564c03154c60a5d8deea6e361021e199a1d 2019-01-19 18:28:17 +01:00
use snprintf in retro-compiler instead of sprintf FossilOrigin-Name: a4bf46b447abe61d2bba28b19a30298de7948cb06c38e3b49fa93f2485b2fd23 2019-01-11 18:57:51 +01:00			`### retro-compiler`
update release notes FossilOrigin-Name: e27f9e4df26bc5e5f78edd74822f18e560a555168215b4a49e6f0bdaa8de558d 2019-01-03 16:34:14 +01:00
new example: using pipes and curl to make network requests FossilOrigin-Name: 4ee196650050b118929e3c2af90a3145321f7cb76e57a9c9e8b8b49f5354a0a3 2019-01-18 18:33:31 +01:00			`- new interface for creating turnkey executables on bsd, linux`
update release notes FossilOrigin-Name: e27f9e4df26bc5e5f78edd74822f18e560a555168215b4a49e6f0bdaa8de558d 2019-01-03 16:34:14 +01:00
use snprintf in retro-compiler instead of sprintf FossilOrigin-Name: a4bf46b447abe61d2bba28b19a30298de7948cb06c38e3b49fa93f2485b2fd23 2019-01-11 18:57:51 +01:00			`### retro-ri`

			`- support switching between multiple copies of the image`
add random number generator FossilOrigin-Name: df5f0a97872a37bd503488968379b564c03154c60a5d8deea6e361021e199a1d 2019-01-19 18:28:17 +01:00			`- add random number generator`
add glossary entry for image:save FossilOrigin-Name: 473faf456552f8c1fd30ccc693a4801107aa3e5cb674ce1d672e46c52c44973d 2019-02-06 14:20:46 +01:00			`- add image:save`
update release notes FossilOrigin-Name: e27f9e4df26bc5e5f78edd74822f18e560a555168215b4a49e6f0bdaa8de558d 2019-01-03 16:34:14 +01:00
update copyright year in unu FossilOrigin-Name: 264fec34bc2430f967e2788ea101295c80205e93bf7aeab894afaeda96829cc5 2018-11-04 22:57:09 +01:00			`## Tools`
will now start including a RELEASE_NOTES file for the release. (Starting w/2017.12) FossilOrigin-Name: 67239bbb7ebda09554e6be614bb7dc9d41ec486493be9cf243fa1cda1148ca89 2017-11-19 02:12:29 +01:00
more cleanups FossilOrigin-Name: 87ef440789795b1f6ea207b9b07a598b5ee0598bca0fe98c5e43d460f1f43df1 2019-01-11 04:26:40 +01:00			`- use strlcpy, strlcat instead of strcpy and strcat`
retro-extend: reduce memory use, fix a potential buffer overrun, allow import of multiple files, remove dead code FossilOrigin-Name: 4984d5cfd588d94c370e0ab6bec5c6a0a45e45297ff1e02bca0149c0fe380bc3 2019-01-16 15:50:25 +01:00			`- retro-extend: cleaner output`
			`- retro-extend: remove unused code`
			`- retro-extend: allow multiple files`
			`- retro-extend: reduce memory usage`
			`- retro-extend: fix potential buffer overrun`
new example: naming quotes FossilOrigin-Name: b7cb708ed7e5c798fddf0c30e9ac2eaf7f2951a958b17599e62e81c20987d9d5 2019-01-31 22:37:28 +01:00			- muri: remove the unused `c` directive
more cleanups FossilOrigin-Name: 87ef440789795b1f6ea207b9b07a598b5ee0598bca0fe98c5e43d460f1f43df1 2019-01-11 04:26:40 +01:00
update copyright year in unu FossilOrigin-Name: 264fec34bc2430f967e2788ea101295c80205e93bf7aeab894afaeda96829cc5 2018-11-04 22:57:09 +01:00			`## Other`

			`## Documentation`
will now start including a RELEASE_NOTES file for the release. (Starting w/2017.12) FossilOrigin-Name: 67239bbb7ebda09554e6be614bb7dc9d41ec486493be9cf243fa1cda1148ca89 2017-11-19 02:12:29 +01:00
new example: naming quotes FossilOrigin-Name: b7cb708ed7e5c798fddf0c30e9ac2eaf7f2951a958b17599e62e81c20987d9d5 2019-01-31 22:37:28 +01:00			`- add a collection of papers`
glossary: start cleanup of html generation FossilOrigin-Name: 0a12cecbea1c42f9133f76f7cf8b8d2c4ffade4700d1732f518d9810fe7dd93f 2019-01-23 21:29:23 +01:00			`- refactor glossary tool`
			`- add HTML version of the Glossary`
new example: html generation using combinators FossilOrigin-Name: 88a6e16492d1df45f275965cce9c0ff45f63a388fb10c15da065bdd78a2a6489 2019-01-24 18:49:29 +01:00			`- add more concise text copies of the Glossary`
start work on adding man pages FossilOrigin-Name: 9c6bfe623f70c0bf30adc7a4580298516fc0e0fdb8ef5cda8b1327132a5da8b8 2019-01-22 15:29:51 +01:00			`- add man pages`
some release notes updates FossilOrigin-Name: 5744b0cd5aae55215fe1e06f7a4b9302a81ae2b1b0fc85d9b627c6c667d13814 2019-02-07 05:12:24 +01:00			`- add BUILDING.md`
start work on adding man pages FossilOrigin-Name: 9c6bfe623f70c0bf30adc7a4580298516fc0e0fdb8ef5cda8b1327132a5da8b8 2019-01-22 15:29:51 +01:00
update copyright year in unu FossilOrigin-Name: 264fec34bc2430f967e2788ea101295c80205e93bf7aeab894afaeda96829cc5 2018-11-04 22:57:09 +01:00			`## Examples`
will now start including a RELEASE_NOTES file for the release. (Starting w/2017.12) FossilOrigin-Name: 67239bbb7ebda09554e6be614bb7dc9d41ec486493be9cf243fa1cda1148ca89 2017-11-19 02:12:29 +01:00
add two new examples from Kiyoshi FossilOrigin-Name: 4f930733947c1331f846262d820152b2a6276dc9cd7cf1fa307129dbff71157c 2019-02-06 13:45:02 +01:00			`- add Abort.forth`
new example: gophermap generation for Atua FossilOrigin-Name: 971ccb9f19419f398f81631d2443cc591eee436a791ae45f920fe0f61001d689 2019-02-07 05:56:24 +01:00			`- add atua-gophermap.forth`
Add Buffer example FossilOrigin-Name: f66f25fad64e757973afac7ce55f9b31f3eedfb0f8cbbaf6354d75629718d4b2 2019-01-19 19:31:34 +01:00			`- add Buffer.forth`
new example: capture output to a string FossilOrigin-Name: 16f71f9d141b18d1f6c04c5f33e46839b9d61852b0ee3458e60f31cacfcbd9b7 2019-01-19 15:22:21 +01:00			`- add CaptureOutput.forth`
add example showing a way to display the dictionary words grouped by class FossilOrigin-Name: 511442745496c5e00e2717940adde6a2db9fb5d882d560495ededeb2c4bf54e1 2019-01-14 22:23:35 +01:00			`- add DisplayNames.forth`
add two new examples from Kiyoshi FossilOrigin-Name: 4f930733947c1331f846262d820152b2a6276dc9cd7cf1fa307129dbff71157c 2019-02-06 13:45:02 +01:00			`- add EvaluateString.forth`
add example: FloatVar.forth from Kiyoshi FossilOrigin-Name: 7eeef4b92e2df4e7c70d2633dd4db72c70b1ece2312267e078189a065690f18a 2019-02-13 20:30:14 +01:00			`- add FloatVar.forth`
add two new examples from Kiyoshi FossilOrigin-Name: 4f930733947c1331f846262d820152b2a6276dc9cd7cf1fa307129dbff71157c 2019-02-06 13:45:02 +01:00			`- add Forget.forth`
new example: html generation using combinators FossilOrigin-Name: 88a6e16492d1df45f275965cce9c0ff45f63a388fb10c15da065bdd78a2a6489 2019-01-24 18:49:29 +01:00			`- add HTML.forth`
add a key-value store to examples FossilOrigin-Name: dc62e866805f3f89bfa34769b3add2c4cc8cd1a4ac6b522f1634d698bd3e8aa7 2019-01-15 17:10:41 +01:00			`- add KeyValueStore.forth`
add example of a Marker word to restore the dictionary and heap pointers FossilOrigin-Name: 178319a0c34517aea1a03eca369e581b7266a9fc5ad65c998bc6a02dee6fe568 2019-01-23 02:50:05 +01:00			`- add Marker.forth`
new example: naming quotes FossilOrigin-Name: b7cb708ed7e5c798fddf0c30e9ac2eaf7f2951a958b17599e62e81c20987d9d5 2019-01-31 22:37:28 +01:00			`- add Naming_Quotes.forth`
new example: using pipes and curl to make network requests FossilOrigin-Name: 4ee196650050b118929e3c2af90a3145321f7cb76e57a9c9e8b8b49f5354a0a3 2019-01-18 18:33:31 +01:00			`- add net_fetch.forth`
new example: capture output to a string FossilOrigin-Name: 16f71f9d141b18d1f6c04c5f33e46839b9d61852b0ee3458e60f31cacfcbd9b7 2019-01-19 15:22:21 +01:00			`- add paste.forth`
Add Paste to Sprunge example FossilOrigin-Name: e8a6fc3064ad8519b731cca3cbae649117441f54e985423af58e66347f094c69 2019-01-19 17:42:24 +01:00			`- add Paste_to_Sprunge.forth`
add retro-extend written in retro FossilOrigin-Name: 454964c4c38d225882f00a27d4902a6ba18ef4489ce551942ee2814b079f6381 2019-01-30 02:42:25 +01:00			`- add retro-extend.forth`
add retro-embedimage in retro FossilOrigin-Name: 347e9c4f8b25909358903096f110922fe2d278532037eca4445b52edbd739f91 2019-02-03 05:06:16 +01:00			`- add retro-embedimage.forth`
new example of saving & restoring the stack FossilOrigin-Name: a04800a5ceee2398f2b2a0dcffe9b5867177c4e1eb2cd0a3d81be5e06d180f84 2019-01-18 18:58:40 +01:00			`- add Save_and_Restore_Stack.forth`
add share+shared (personal pastebin) to examples FossilOrigin-Name: a84588260b71d754b48f5aca953e3583600eb44fd3ecff424467bc4fa785e2a0 2019-01-18 22:33:49 +01:00			`- add share.forth and shared.forth`
new example: uuencode FossilOrigin-Name: d7e5bded138fed008e3c2d396b6e11f5ed5ae1dacec648af63b056a0aac22621 2019-01-25 22:52:15 +01:00			`- add uuencode.forth`
add uudecode example FossilOrigin-Name: 1ae8eea6b2580aa8306cdb1741ccb7be8c824278132555e081c3451b0132c545 2019-01-26 05:29:24 +01:00			`- add uudecode.forth`
add example: FloatVar.forth from Kiyoshi FossilOrigin-Name: 7eeef4b92e2df4e7c70d2633dd4db72c70b1ece2312267e078189a065690f18a 2019-02-13 20:30:14 +01:00			`- fix test block in defstruct.forth`
new example of saving & restoring the stack FossilOrigin-Name: a04800a5ceee2398f2b2a0dcffe9b5867177c4e1eb2cd0a3d81be5e06d180f84 2019-01-18 18:58:40 +01:00			`- switch to dvorak key bindings in Roo.forth`
hooks now part of core language FossilOrigin-Name: 9c7796470e71fe1e14f800ab7f0a00cb3f91cb265e2d52b6e4ab77e7c185c6bc 2019-01-19 05:49:47 +01:00			`- remove Hooks.forth (now in core language)`
some commentary expansions in rre.forth FossilOrigin-Name: 384228cb9891ab97d56fecf940d0214af1a555440c03019aa8f3b8b50a7895d8 2019-02-05 21:22:17 +01:00			`- improved edit.forth from Kiyoshi`
update casket http server w/scripting support FossilOrigin-Name: e3abdcda50e585341f113665298fb0bd02ad67565cbdced1773f55958f80e3b6 2019-02-13 20:18:20 +01:00			`- Casket-HTTP now supports server side scripting`
add example showing a way to display the dictionary words grouped by class FossilOrigin-Name: 511442745496c5e00e2717940adde6a2db9fb5d882d560495ededeb2c4bf54e1 2019-01-14 22:23:35 +01:00
update copyright year in unu FossilOrigin-Name: 264fec34bc2430f967e2788ea101295c80205e93bf7aeab894afaeda96829cc5 2018-11-04 22:57:09 +01:00			`## Final Notes`