|
Perform miscellaneous instructions to control Tefigel operating mode
and state or to access the underlying operating system.
Execute an operating system shell command:
system <command-string>
Print Tefigel version string:
version
Reset Tefigel internal state to initial state:
reset
Dump Tefigel internal state:
dump
Tune behavior of Tefigel:
switch <control-variable>=<control-value>
"Hook" a user-defined Tefigel subroutine to a given processing event:
hook <hook-event>=<hook-subroutine>
Remove association between a <hook-event> and a user-defined
<hook-subroutine>:
hook <hook-event>=
A <command-string> can be any command for the command interpreter
(shell) of the underlying operating system.
Instruction reset resets all Tefigel variables and filters,
and sets special characters, markers, control switches and event hooks
to their default start-up state.
Instruction dump prints all available information
about Tefigel status, including variables and name spaces,
special characters, markers, filters, control switches, event hooks,
and library path.
Switch <control-variable>'s may be set to the <control-value>'s
described in the following list:
- AUTO_NEWLINE
0: do not automatically print a CR-LF sequence after each output line;
1: [default] print a CR-LF sequence after each output line.
- CMD_CASE
0: Tefigel <instruction>'s are in upper case;
1: [default] Tefigel <instruction>'s are in lower case.
- ON_MISSING_FILE
0: silently ignore attempts to process or call non-existent files;
1: print a warning message when attempting to process or call non-existent files;
2: [default] print a fatal error message and terminate processing on attempts to process or call non-existent files.
- STRICT_CMDMARK
0: consider input lines starting with an instruction as command lines, even if a command marker has been defined;
1: [default] when a command marker is set, treat all input lines not starting with the current command marker as text lines.
- TRACE
0: [default] do not print tracing messages about Tefigel processing;
1: trace begin and end of file processing instruction execution;
2: same as 1, moreover trace execution of all instructions;
3: same as 2, moreover trace processing of all input lines, including text lines.
A <hook-subroutine> is a Tefigel script that can be associated
with one of the <hook-event>'s described in the following list:
- NEW_INPUT
The <hook-subroutine> (if any) associated with this event will be called when processing of a new input file begins. The file name of the new input file will be passed as a parameter to the <hook-subroutine>.
- EOF_INPUT
The <hook-subroutine> (if any) associated with this event will be called when processing of the current input file ends. The file name of the input file will be passed as a parameter to the <hook-subroutine>.
[Previous chapter]
[Next chapter]
[Back to top]
|
