2023-10-03 21:01:15 +02:00
|
|
|
.Dd October 2023
|
2019-01-22 15:29:51 +01:00
|
|
|
.Dt RETRO 1
|
|
|
|
|
.Os
|
|
|
|
|
.Sh RETRO
|
|
|
|
|
.Nm retro
|
|
|
|
|
.Nd "a modern, pragmatic forth development system"
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm
|
2019-01-22 19:05:02 +01:00
|
|
|
.Op Fl h
|
2021-06-01 15:42:30 +02:00
|
|
|
.Op Fl i
|
2023-10-03 21:01:15 +02:00
|
|
|
.Op Fl v
|
2021-06-01 15:42:30 +02:00
|
|
|
.Op Fl t Ar filename
|
2019-01-22 19:05:02 +01:00
|
|
|
.Op Fl f Ar filename
|
2024-01-22 18:58:42 +01:00
|
|
|
.Op Fl p Ar filename
|
2019-01-22 19:05:02 +01:00
|
|
|
.Op Fl u Ar filename
|
2019-11-25 21:09:30 +01:00
|
|
|
.Op Fl r Ar filename
|
2019-01-22 19:05:02 +01:00
|
|
|
.Op Ar filename Ar script-args
|
2019-01-22 15:29:51 +01:00
|
|
|
.Sh DESCRIPTION
|
2019-01-22 19:05:02 +01:00
|
|
|
RETRO is a modern, pragmatic Forth drawing influences from many sources.
|
|
|
|
|
It's clean, elegant, tiny, and easy to grasp and adapt to various uses.
|
2019-01-22 15:29:51 +01:00
|
|
|
|
|
|
|
|
.Nm
|
2019-01-22 19:05:02 +01:00
|
|
|
is the main interface for interacting with Retro. It provides both
|
2020-06-09 14:40:29 +02:00
|
|
|
an interactive and a scripting model.
|
2019-01-22 19:05:02 +01:00
|
|
|
.Sh OPTIONS
|
|
|
|
|
.Bl -tag -width -indent
|
2019-03-03 19:02:12 +01:00
|
|
|
.It Fl h
|
2019-09-18 18:48:15 +02:00
|
|
|
Display a help screen.
|
2019-03-03 19:02:12 +01:00
|
|
|
.It Fl i
|
2019-09-18 18:48:15 +02:00
|
|
|
Start Retro in interactive mode.
|
|
|
|
|
.It Fl s
|
2021-01-07 17:02:18 +01:00
|
|
|
Start Retro in interactive mode and suppress the startup message.
|
2023-10-03 21:01:15 +02:00
|
|
|
.It Fl v
|
2023-10-10 11:54:47 +02:00
|
|
|
Run in verbose mode, showing debugging information. Verbose output is written to /dev/stderr.
|
2021-06-01 15:42:30 +02:00
|
|
|
.It Fl t Ar filename
|
|
|
|
|
Run any code and test blocks in the specified file.
|
2019-03-03 19:02:12 +01:00
|
|
|
.It Fl f Ar filename
|
2019-09-18 18:48:15 +02:00
|
|
|
Run any code blocks in the specified file.
|
2024-01-22 18:58:42 +01:00
|
|
|
.It Fl p Ar filename
|
|
|
|
|
Run the code in the specified file.
|
2019-04-02 22:25:21 +02:00
|
|
|
.It Fl u Ar filename
|
2019-09-18 18:48:15 +02:00
|
|
|
Load and use the specified image file rather than the integral one.
|
2019-11-25 21:09:30 +01:00
|
|
|
.It Fl r Ar filename
|
|
|
|
|
Load and run the code in the specified image file rather than the integral one.
|
2019-03-03 19:02:12 +01:00
|
|
|
.It filename script-args
|
|
|
|
|
Run code blocks in a single file. Pass script-args to the code being run.
|
2019-01-22 19:05:02 +01:00
|
|
|
.El
|
2020-06-09 14:40:29 +02:00
|
|
|
|
|
|
|
|
If invoked with no arguments,
|
|
|
|
|
.Nm
|
|
|
|
|
will run in interactive mode.
|
2019-01-22 15:29:51 +01:00
|
|
|
.Sh AUTHORS
|
|
|
|
|
.An Charles Childers Aq Mt crc@forthworks.com
|
