4.10 Miscellaneous
The remainder of this chapter covers a few additional syntactic elements that didn't fit into any of the previous sections.
• #INCLUDE statement | ||
• #EXIT statement | ||
• #QUIT statement |
4.10.1 #INCLUDE statement
Everywhere within an EDL
script one can include another
EDL
file. This is done using the #INCLUDE
keyword,
followed by the name of the file to be included, and has the same effect
as if the file to be included had been pasted into the current EDL
script, replacing the line with the #INCLUDE
statement. Included
files themselves may contain further #INCLUDE
statements, up to 16
levels deep.
The name of the file to be included must follow the #INCLUDE
directly (i.e. on the same line and only with spaces and tab
characters in between). It must be enclosed either in double quotes
(i.e. it must have the form "..."
) or in angle braces
('<
' and '>
', i.e. have the form <...>
).
If the file name is enclosed in double quotes fsc2
tries to
figure out the location where it is stored according to the following
rules:
- If the name starts with a slash, '
/
', it is assumed that the file is given with a complete, absolute path. - If the file name starts with a tilde followed directly by a slash,
i.e. with "
~/
", the tilde is replaced by the name of the users home directory. - If the file name starts with any other character its path is taken to be relative to the path of the file it is included from.
If the file name is enclosed in <
and >
a default include
directory compiled into fsc2
will prepended to the file name,
whatever the name of the file is. If no default directory has been
compiled into fsc2
an error message is printed and interpretation
of the script stops.
If the file to be included can't be opened an error message is printed and
interpretation of the EDL
script is abandoned.
4.10.2 #EXIT statement
When the #EXIT
statement is found in an EDL
script this is
equivalent to the end of the file - everything following the statement
is discarded. In the main file of an EDL
script this signifies
the end of the EDL
script. If the file containing the
#EXIT
statement is an included file (see the #INCLUDE
statement above) fsc2
will immediately return to reading the file
the file was included from.
4.10.3 #QUIT statement
When the #QUIT
statement is encountered in an EDL
script
fsc2
treats this as the end of the EDL
script and won't
read any further lines. In the main file of an EDL
this is
equivalent to the #EXIT
statement. But within an included
EDL
file #EXIT
will induce fsc2
to return to the
including file while #QUIT
makes fsc2
stop completely,
i.e. it will not even return to higher level EDL
files.
This document was generated by Jens Thoms Toerring on September 6, 2017 using texi2html 1.82.