retroforth/man/retro.1
crc aa99e1b54a nga-c: -t now takes a command line argument for the file name
this closes #63. rick noted that -t is not consistent with -f,
the changes here address this. -f now loads code blocks from a
file, and -t will load both code and test blocks.

FossilOrigin-Name: b32065ff68714f4c6b86e17da44c4778a0ce9ceb7db81a3466edd3da312d47e0
2021-06-01 13:42:30 +00:00

47 lines
1.2 KiB
Groff

.Dd January 2021
.Dt RETRO 1
.Os
.Sh RETRO
.Nm retro
.Nd "a modern, pragmatic forth development system"
.Sh SYNOPSIS
.Nm
.Op Fl h
.Op Fl i
.Op Fl t Ar filename
.Op Fl f Ar filename
.Op Fl u Ar filename
.Op Fl r Ar filename
.Op Ar filename Ar script-args
.Sh DESCRIPTION
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.
.Nm
is the main interface for interacting with Retro. It provides both
an interactive and a scripting model.
.Sh OPTIONS
.Bl -tag -width -indent
.It Fl h
Display a help screen.
.It Fl i
Start Retro in interactive mode.
.It Fl s
Start Retro in interactive mode and suppress the startup message.
.It Fl t Ar filename
Run any code and test blocks in the specified file.
.It Fl f Ar filename
Run any code blocks in the specified file.
.It Fl u Ar filename
Load and use the specified image file rather than the integral one.
.It Fl r Ar filename
Load and run the code in the specified image file rather than the integral one.
.It filename script-args
Run code blocks in a single file. Pass script-args to the code being run.
.El
If invoked with no arguments,
.Nm
will run in interactive mode.
.Sh AUTHORS
.An Charles Childers Aq Mt crc@forthworks.com