# RETRO 2020.10

This update has focused on improvements to the toolchain and
general cleaups and bug fixes.

Of particular note: when building the C implementation, you
can now override the image and stack sizes when building. For
Python users, the core toolchain (retro-unu, retro-muri, and
retro-extend) has now been implemented in Python as well as C,
so you can now build RETRO without needing a C compiler.

## Notable Bugs Fixed

- fixed a bug in the glossary that caused names to appear twice
  (reported by Kiyoshi)
- fixed a bug in retro-describe due to use of a deprecated word
- retro.py: fixed a bug in the stack depth reporting
  (thanks to Scott McCallum for reporting this)
- fixed the `sh` instruction (which was totally broken prior to
  this, thanks to Scott for reporting this)
- `retro-describe` no longer uses the `-J` parameter when invoking
  `xargs` which should let it work on non-BSD systems.

## Build Improvements

- added a `make image-js` target to generate the image.js
- allow setting the image size, stack sizes when building

## Toolchain

- add Python implementations of retro-unu, retro-muri, retro-extend
- add support for generating an epub from the documentation
- add a tool to locate files using deprecated words

## General Improvements

- remove deprecated words

## For Unix Users

- added `script:current-file` to return the filename being processed
- added `script:current-line` to return the current line number being
  processed
- added `script:ignore-to-eol` to support commenting out lines when
  processing files
- added `script:abort-include` to support canceling rest of current
  file being processed
- added `//` to comment out lines (works with files and at the
  listener)
- deprecated words
  - sys:name (now script:name)
  - sys:argc (now script:arguments)
  - sys:argv (now script:get-argument)
- renamed
  - io:clock-operation (now clock:operation)
  - io:file-operation (now file:operation)
  - io:float-operation (now float:operation)
  - io:socket-operation (now socket:operation)

## For users of Python

- add Python implementations of retro-unu, retro-muri, retro-extend
- retro.py now supports the floating point i/o device
- added support for file i/o device
- added support for the basic (level 0) scripting interface
- source formatting should now be consistent across all files

## Documentation

- removed reference to old Makefile that no longer exists
- updates word namings for deprecated words that have been removed
- epub version of the documentation

## Examples

- add: markdown to xhtml
- add: retro in retro