💾 Archived View for schinkel.bevuta.com › uf › uf.gmi captured on 2024-06-16 at 12:29:02. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2023-11-04)

-=-=-=-=-=-=-

Home

                    88        88 88888888888  
                    88        88 88           
                    88        88 88           
                    88        88 88aaaaa      
                    88        88 88"""""      
                    88        88 88           
                    Y8a.    .a8P 88           
                     `"Y8888Y"'  88           

Version: 8

"UF" is a traditional Forth system for the "uxn/varvara" virtual

computer. Uf is written in Tal and itself and provides an interactive

text interface, uxn assembler, decompiler and screen editor. The

system is not threaded, it compiles to native UXN code, but currently

only minimal optimizations are performed. The mapping of Forth

source code to VM instructions is nevertheless relatively direct,

so performance should be more than sufficient in all but the most

speed-critical situations. Cells are 16 bits, the full system

consists of around 25K, with around 4K needed for screen memory and

buffers.

Suggestions for improvement or patches providing enhancements and

corrections are very welcome, see the User's manual for information

on how to contact the author.

This software was written by Felix L. Winkelmann and has been released

into the public domain. Do with it whatever you like.

Installation instructions and general information

Download precompiled ROM

Get the source code

Release History:

Version 8:

* All calls to Forth words use immediate branches now, which reduces

the code size of the prebuilt ROMs by several kilobytes.

* Renamed ROMs to "uf0.rom" (minimal), "uf.rom" (tools) and "ufx.rom"

(graphical console + editor).

* Heavily commented both the uxntal kernel and the Forth source code.

* Fixed corner case in "bounce" example (thanks to Harry Prins).

* Adapted kernel to newest UXN system version for stack-access

primitives (many thanks to Devine for resurrecting the wst/rst

system device ports).

* The kernel uses immediate branches were possible, which reduces

the kernel size slightly.

* `pause` has been removed, `rfind` has been exposed.

* Added `halt` and `input-type`.

Version 7:

* `include`/`included` catches attempts at nested inclusion

(thanks to Alex Wennerberg for pointing this out).

* Fixed `sample` to also set the sample length (thanks to Harry

Prins for pointing out this problem).

* Dropped metadata stuff.

* Added "lib" subdirectory with a few helpful things.

Version 6:

* Fixed off-by-one errors in `>=` and `<='.

* Allow ^x in unlocked mode.

* Added `include` and `included` (suggested by Alex Wennerberg).

* Fixed bug in `clamp` and thus make `at-xy` work, which uses it.

* Dropped ^i handling (uxnemu already shows stacks on F2).

* Use text color for cursor to be visible in monochromatic mode.

* Added icon to banner.

* Added metadata.

Version 5:

* Added `audio` to select current audio device.

* `page` was not exposed to the default dictionary (thanks to Éric

Ortie).

* `]` didn't restore the proper vocabulary order.

Version 4:

* Fixed serious bug in logic for input-grab (used by ^r, ^g and

^m) which caused return stack underflows.

* ^d joins next line if followed by whitespace.

* Unrecognized control-code combinations are ignored now.

* Loading a block prints the block number.

* A warning is shown when a word is redefined.

* Added `-;`.

* `thru` ignores non-existent blocks.

Version 3:

* Added ^l (page) shortcut (suggested by Devine Lu Linvega).

* Added support for multiline snarf + paste (^ENTER, ^x).

* Newlines in snarfed text spanning multiple lines and pasted

text are correctly handled now.

* New words `2variable`, `2constant` and `where`.

* Made some small optimizations in the kernel (courtesy of

Devine Lu Linvega).

* Exposed `stdin` to override console input events.

* Using the scroll-wheel in the editor jumps to previous or next

block.

* Sh-Up recalls last entered line in interactive mode.

* Shift + Arrow-keys replace block-navigation keys ^h, ^n and ^p.

* Added ^y as an alias for ^v.

* ^g, followed by a number of digits allows

direct jump to indicated block.

* Removed `copy`, use ^r to copy block interactively.

* Added ^m to move block.

* Fixed missing argument in `filedelete`.

Version 2:

* Small optimizations in kernel, suggested by Devine Lu Linvega.

* Typo fixes in documentation, thanks to Devine Lu Linvega and

Prof. Dr. Dr. Feinfinger.

* Fixed wrong calculation in `depth`.

* New words `snarf`, `yank`, `theme` expose editor functionality

for general use.

* `.s` prints the contents of the working stack now to the

graphical console instead of just invoking the system's debug

port.

* New words: `2r@`, `pick`, `.vocs`, `marker`, `list` and `new`.

* `unused` is now available in the full non-graphical environment.

* Added minimal support for shadow (documentation) blocks: `Doc`

and `Code` (and ctrl-key ^h) switch between a block and the

corresponfing shadow block (blocks 1000+).

* `filename` doesn't use pad but dedicated 256 byte buffer.

* The cursor position in the editor is retained now properly

between block changes.

* Fixed bug in `scan` (thanks to Alex Wennerberg).

* The tabulator key inserts spaces instead of overwriting

following text.

* Block lines starting with "\" are drawn in a different color.

* Fixed bug in `postpone`.

Version 1:

* Initial release