retroforth/RELEASE_NOTES.md

# RETRO 2019.12

This is the changelog for the development builds of Retro.
The version number is likely to change; I'm targetting a
July - September window for this release.

## Bug Fixes

- (all) strl* functions now only compiled if using GLIBC.
- (all) `d:add-header` is extended by retro.forth to remap spaces back to underscores
- (doc) fixed stack comments in glossary
- (ex ) fixed issue in mail.forth
- (rre) `clock:year` corrected
- (rre) `clock:month` corrected

## Build

- Merged Linux & BSD Makefiles

## Core Language

- rename: `a:nth` to `a:th`
- rename: `v:update-using` to `v:update`

## Documentation

- merged BSD, Linux, macOS build instructions
- updated Starting instructions

## Examples

- add bury.forth
- add compat.forth
- add mandelbrot.forth
- add shell.forth
- add sqlite3 wrapper
- corrected an issue in mail.forth

## General

- reorganized directory tree

## I/O

- (rre) added `clock:utc:` namespace

## Interfaces

- retro-compiler: runtime now supports scripting arguments
update build instructions for Linux users FossilOrigin-Name: 143f3866cf1133a751bf070091a2bf67112006bb8a0569f0394a87111344fa08 2019-04-30 21:55:12 +02:00			`# RETRO 2019.12`
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.`
add example to aid in porting traditional Forth code to RETRO FossilOrigin-Name: 0e26e375ab75910175a6ac73d321bd0c7f91d9acca008fed0d96294c8bf7aea0 2019-05-09 14:27:25 +02:00			`The version number is likely to change; I'm targetting a`
			`July - September window for this release.`
new example: naming quotes FossilOrigin-Name: b7cb708ed7e5c798fddf0c30e9ac2eaf7f2951a958b17599e62e81c20987d9d5 2019-01-31 22:37:28 +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
fix clock:year FossilOrigin-Name: f7be17407c77e34eba0af403e17ebe32d1387a5581989399bebd491241caf5a0 2019-05-01 13:59:13 +02:00			`- (all) strl* functions now only compiled if using GLIBC.`
stdlib: extended d:add-header to remap spaces back to underscores FossilOrigin-Name: f31078905b6171f34690c29fde881b32ae241b4184decb38acb7600a8ba4be86 2019-05-03 13:17:13 +02:00			- (all) `d:add-header` is extended by retro.forth to remap spaces back to underscores
stdlib: rename v:update-using to v:update FossilOrigin-Name: 67e96a5ca01d20af0a72a1d5af20aaeaddbf0b59cf1bec64bfbe6d4fe41d23eb 2019-05-03 21:01:46 +02:00			`- (doc) fixed stack comments in glossary`
add example to aid in porting traditional Forth code to RETRO FossilOrigin-Name: 0e26e375ab75910175a6ac73d321bd0c7f91d9acca008fed0d96294c8bf7aea0 2019-05-09 14:27:25 +02:00			`- (ex ) fixed issue in mail.forth`
			- (rre) `clock:year` corrected
			- (rre) `clock:month` corrected
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
fix clock:year FossilOrigin-Name: f7be17407c77e34eba0af403e17ebe32d1387a5581989399bebd491241caf5a0 2019-05-01 13:59:13 +02:00			`## Build`
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
fix clock:year FossilOrigin-Name: f7be17407c77e34eba0af403e17ebe32d1387a5581989399bebd491241caf5a0 2019-05-01 13:59:13 +02:00			`- Merged Linux & BSD Makefiles`
update copyright year in unu FossilOrigin-Name: 264fec34bc2430f967e2788ea101295c80205e93bf7aeab894afaeda96829cc5 2018-11-04 22:57:09 +01:00
rename `a:nth` to `a:th` FossilOrigin-Name: 7bec54156e9cab1d652c52805af071a62831b13fbd3a323b38ffa90abcb7f633 2019-05-01 14:18:25 +02:00			`## Core Language`

add example to aid in porting traditional Forth code to RETRO FossilOrigin-Name: 0e26e375ab75910175a6ac73d321bd0c7f91d9acca008fed0d96294c8bf7aea0 2019-05-09 14:27:25 +02:00			- rename: `a:nth` to `a:th`
			- rename: `v:update-using` to `v:update`
rename `a:nth` to `a:th` FossilOrigin-Name: 7bec54156e9cab1d652c52805af071a62831b13fbd3a323b38ffa90abcb7f633 2019-05-01 14:18:25 +02:00
update copyright year in unu FossilOrigin-Name: 264fec34bc2430f967e2788ea101295c80205e93bf7aeab894afaeda96829cc5 2018-11-04 22:57:09 +01:00			`## 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
add example to aid in porting traditional Forth code to RETRO FossilOrigin-Name: 0e26e375ab75910175a6ac73d321bd0c7f91d9acca008fed0d96294c8bf7aea0 2019-05-09 14:27:25 +02:00			`- merged BSD, Linux, macOS build instructions`
clarify the startup parameters a bit FossilOrigin-Name: 178bf848e73c4e1380a558d53d09e471d2ff0a62a040f1252c28e64b06373a90 2019-04-30 22:41:49 +02:00			`- updated Starting instructions`
add example of using sqlite3 via pipes FossilOrigin-Name: c5afff65edeeeff084caba6726c10369770fea6f5d8cd9676fb6f6e82f808573 2019-05-01 16:02:34 +02:00
retro-compiler: rename runtime source file FossilOrigin-Name: fc61e9ef4355c63e0cb69b6f44e24abae27b1b38f2be522368e08b77e39656e6 2019-05-02 17:02:48 +02:00			`## Examples`

new example: burying a value on the stack FossilOrigin-Name: 431f9fced77be362212c71b485c2740b04721c0f2e4b7eb40b588c0dbb12fae7 2019-05-09 14:33:34 +02:00			`- add bury.forth`
add example to aid in porting traditional Forth code to RETRO FossilOrigin-Name: 0e26e375ab75910175a6ac73d321bd0c7f91d9acca008fed0d96294c8bf7aea0 2019-05-09 14:27:25 +02:00			`- add compat.forth`
add mandelbrot.forth to examples (thanks to john_ cephalopoda) FossilOrigin-Name: 4cecba6ea5f27ff190567935d60c563884be40834eaf45ad0c9d10b79d8a06a2 2019-05-02 21:31:09 +02:00			`- add mandelbrot.forth`
new example: shell.forth FossilOrigin-Name: 798ba2f07c894a2b02bfe823068133863052cf23a879e0a2e1ad84ed29e90c44 2019-05-07 16:55:25 +02:00			`- add shell.forth`
add example to aid in porting traditional Forth code to RETRO FossilOrigin-Name: 0e26e375ab75910175a6ac73d321bd0c7f91d9acca008fed0d96294c8bf7aea0 2019-05-09 14:27:25 +02:00			`- add sqlite3 wrapper`
			`- corrected an issue in mail.forth`
retro-compiler: rename runtime source file FossilOrigin-Name: fc61e9ef4355c63e0cb69b6f44e24abae27b1b38f2be522368e08b77e39656e6 2019-05-02 17:02:48 +02:00
source tree reorganizations FossilOrigin-Name: 654eda2d23299be894f94e8b615e7432de6a3bd5dbb6f4caa454cc20e65a510b 2019-05-02 18:25:16 +02:00			`## General`

			`- reorganized directory tree`

add clock:utc words FossilOrigin-Name: b969358356e3fbb866f4ce24ff004b6f415238342f1ff24e38c1563480fe674d 2019-05-02 13:13:11 +02:00			`## I/O`

add example to aid in porting traditional Forth code to RETRO FossilOrigin-Name: 0e26e375ab75910175a6ac73d321bd0c7f91d9acca008fed0d96294c8bf7aea0 2019-05-09 14:27:25 +02:00			- (rre) added `clock:utc:` namespace
add clock:utc words FossilOrigin-Name: b969358356e3fbb866f4ce24ff004b6f415238342f1ff24e38c1563480fe674d 2019-05-02 13:13:11 +02:00
retro-compiler: rename runtime source file FossilOrigin-Name: fc61e9ef4355c63e0cb69b6f44e24abae27b1b38f2be522368e08b77e39656e6 2019-05-02 17:02:48 +02:00			`## Interfaces`
add example of using sqlite3 via pipes FossilOrigin-Name: c5afff65edeeeff084caba6726c10369770fea6f5d8cd9676fb6f6e82f808573 2019-05-01 16:02:34 +02:00
retro-compiler: rename runtime source file FossilOrigin-Name: fc61e9ef4355c63e0cb69b6f44e24abae27b1b38f2be522368e08b77e39656e6 2019-05-02 17:02:48 +02:00			`- retro-compiler: runtime now supports scripting arguments`