l3 - interpret l3 programs
l3 [-f FILE] [-l STATE_LOAD] [-s STATE_SAVE] [-i] [-d] [-h]
This command-line version is best used for unattended execution; to fully use l3 requires the graphical interface; see l3gui(1).
When a FILE argument is present (-f), the FILE is executed. Execution continues until the end-of-file is reached, or an error is encountered. In both cases a state file is produced (either FILE.l3s, or STATE_SAVE from -s) along with whatever output FILE produced.
When a STATE_LOAD argument is given (-l), the state is loaded. This implicitly loads the script FILE that originally produced STATE_LOAD. Then, this original script is scanned and new expressions are executed. Expressions previously executed successfully are not executed again. The final state is written back to STATE_LOAD, or STATE_SAVE if -s was given.
When -i is given, any files specified are executed first, and the toplevel started after. If any error occurs, the error is printed and the toplevel is entered immediately, even if unread files remain.
Expressions entered at the toplevel are executed immediately. The expressions are appended to the current FILE if present, otherwise they form a new script. On end-of-file, the the state is saved in one of STATE_SAVE, STATE_LOAD, FILE.l3s, or st.l3s (in that order), and the interpreter exits.
Errors simply cause a return to the toplevel.
Print help and exit.
show program's version number and exit
show this help message and exit
Execute this script in l3.
Start l3 from this state file.
Save l3 state to this file.
Go to Python console on exit. This allows moving between Python and l3. To restart, use l3.run()
Import all l3 modules (from … import *) when using -i. Allows for interactive Python code updates.
L3HOME The path to the l3 installation root.
Michael Hohn, email@example.com
Copyright © 2004-8 Lawrence Berkeley National Laboratory
l3 is released under the BSD license. See license.txt for details.