EMU(1) Emu EMU(1)
2001 July 9
NAME
emu - Emu language interpretter
SYNOPSIS
emu [-v | -u | -b -s -c dir -a -w -q] filename [-o outputfile]
DESCRIPTION
Emu is a scripting language designed by Aaron Kimball. From the
manual: "Emu allows for rapid creation of scripts readily embedded
within text files, or as standalone programs."
emu is the program which interprets Emu scripts.
OPTIONS
-a, --all
Assumes that all of the file is script, so the file does not need
to begin with <$ and close with $>.
-b, --background
Redirects output to /dev/null and disables user input.
-c dir, --curdir dir
Sets current directory to 'dir'.
-o file, --output file
Redirects all output to 'file'.
-s, --strict
All warnings are treated as errors, and Emu exits with code 1 on
error.
-q, --quiet-input
If a script is to be piped into stdin, this will suppress the
user interface provided by Emu.
-u, --usage
Displays a list of accepted switches.
-v, --version
Displays version information.
-w, --no-warnings
Warnings are disabled. May be used with -s.
--safe
File/device i/o is disabled. Console input is still allowed.
-
The script is read from stdin. If piping the script in, the use
of 'input' or 'getkey' may cause unexpected results.
- 1 - Formatted: December 26, 2024
EMU(1) Emu EMU(1)
2001 July 9
INVOKING SCRIPTS
Emu scripts may be invoked one of two ways:
1) Passing the script file as an argument to the interpretter ("emu
filename.emu")
2) By setting the executable attribute of the script file via chmod,
and then invoking emu shell-script style, by placing Emu's path on the
first line of the script like "#!/usr/bin/emu"
If the first line of an Emu script begins with "!#", the line is
ignored. Thus, if the script is to generate another script for a
different language (a bash script, for instance), its first line
should be "#!/usr/bin/emu", and the second line should be "#!/bin/sh".
EXTENSIBILITY
The Emu language is readily extensible via shared libraries. Any
library conformant to the Emu library specification (aviailable in the
documentation directory of Emu's installation) may be used with the
UseModule keyword in Emu. Emu library filenames should begin with
"libemu", and reside in a public library folder, such as /usr/lib.
FILES
/usr/bin/emu
The executable interpretter.
/usr/lib/libemu*.so
Any additional language module libraries.
LICENSE
Emu is released under the MIT Public License.
The following provisions are also asked:
1) That you may claim that any derivative works are "Based on Emu" but
can not actually call such derivatives "Emu".
2) That you do not advertize or bill your project as supported or
officially sanctioned by Emu or Aaron Kimball, without express written
permission to do so.
BUGS
Emu may well have many bugs. Each version is tested with as many forms
of input as possible, both correct and incorrect syntax. Emu does not
have any known issues with any program input, however it is very
possible that something slipped by. If any script crashes emu, please
- 2 - Formatted: December 26, 2024
EMU(1) Emu EMU(1)
2001 July 9
email the offending script and a description of the problem to Aaron
Kimball <kimballa@concentric.net>.
Emu is also too slow. I'm working on that.
AUTHOR
Emu was designed and implemented by Aaron Kimball
<kimballa@concentric.net>.
SEE ALSO
The Emu Language Reference, by Aaron Kimball
The Library SDK Reference, by Aaron Kimball
of Emu's installation path.
Emu documentation is available as hypertext files in the doc/ subdirectory
- 3 - Formatted: December 26, 2024
