NAME

F-Lower - Toy scripting language with a stack and postfix notation

SYNOPSIS

fl [ -h | -v | -q | -e code | -i file | script ]

DESCRIPTION

F-Lower is a toy scripting language with a stack and postfix notation. Its main trait is that the basics look much like in Forth:

3.141592 constant PI
variable diagonal
: hypot dup * swap dup * + sqrt ;
3 4 hypot diagonal !
diagonal @ . cr

But control structures are much more friendly, like in Logo:

2 3 < { ( Yay! ) cr } iftrue \ Parens print out text.
{ ( Ho! ) } 3 times cr /* Block comments are like in C instead. */
1 { ( Hey ) 1+ } while [ dup 3 <= ] repeat drop cr

F-Lower was a learning project and doesn't have clear goals. As of version 1.3.1, it's little more than a programmable calculator for the command line.

This manual page describes the command line interface.

OPTIONS

Invoked without options, F-Lower enters an interactive prompt.

-h, --help

Show a list of command line options with brief explanations, then exit.

-v, --version

Show the current version number and exit without doing anything else.

-q, --quiet

Suppress the banner and prompt at the interactive prompt.

-e code, --exec code

Interpret some code given directly on the command line, then exit.

-i file, --include file

Interpret the given file as per the include word and go interactive.

script

Interpret the given script, then exit.

As of version 1.3.1 beta, all options are mutually exclusive.

EXIT STATUS

code 0

The requested action was completed successfully.

code 1

The parser encountered an unknown word or bad number.

code 2

There was an error in the F-Lower source code passed to the interpreter.

code 3

An input/output error was encountered.

code 4

Caught an attempt to redefine an already existing word.

BUGS

As of version 1.3.1, error code 3 is returned instead of error code 4.

AUTHORS

F-Lower is a No Time To Play project.

LICENSE

This software is free and open source under the Artistic License 2.0

SEE ALSO

Ripen scripting engine - a precursor of F-Lower.