retroforth/RELEASE_NOTES.md

# RETRO 12.2019.6

## Bug Fixes

## Build

- parallel builds now work
- refactor Makefile

## Core Language

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

## 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

### 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

## 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

## Other

## Documentation

- add man pages

## Examples

- add Buffer.forth
- add CaptureOutput.forth
- add DisplayNames.forth
- add KeyValueStore.forth
- add net_fetch.forth
- add paste.forth
- add Paste_to_Sprunge.forth
- add Save_and_Restore_Stack.forth
- add share.forth and shared.forth
- switch to dvorak key bindings in Roo.forth
- remove Hooks.forth (now in core language)

## 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
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`
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
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`
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`
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`
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
start work on adding man pages FossilOrigin-Name: 9c6bfe623f70c0bf30adc7a4580298516fc0e0fdb8ef5cda8b1327132a5da8b8 2019-01-22 15:29:51 +01:00			`- add man pages`

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 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 a key-value store to examples FossilOrigin-Name: dc62e866805f3f89bfa34769b3add2c4cc8cd1a4ac6b522f1634d698bd3e8aa7 2019-01-15 17:10:41 +01:00			`- add KeyValueStore.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`
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 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)`
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`