Chapter 2 - File Sections

2.1 - Purpose        top

An input file for Tefigel may contain one or more <file-section>'s of three types: text, Tefigel code, and comment blocks. File sections allow to improve readability of Tefigel files and can be freely defined within each Tefigel file in no particular order. By default the content of a Tefigel file whose name ends in ".tfg" is assumed to start with a <tefigel-section>. The content of a Tefigel file whose name does not end in ".tfg" is assumed to start with a <text-section>.

2.2 - Usage        top

Define a <text-section>:

   text
   <text-section>
   endtext

   tefigel
   <tefigel-section>
   endtefigel

   <comment-marker>\
   <comment-section>
   <comment-marker>/

2.3 - Description        top

A <file-section> consists of zero or more <logical-line>'s.

The content of a <text-section> is subject to textual substitution of <variable>'s and in-line function calls via <subprogram-reference>'s. Lines starting with the current <command-marker> are treated as <command>'s. Lines starting with the current <comment-marker> are treated as <comment-line>'s.

The content of a <tefigel-section> is processed as a sequence of <command>'s or subroutine and function calls via <subprogram-reference>'s. Lines starting with any current <instruction-marker>, possibly preceded by blanks and/or tabs, are processed as the corresponding <instruction>. In particular, lines starting with the current <comment-marker>, possibly preceded by blanks and/or tabs, are treated as <comment-line>'s.

The content of a <comment-section>, including its opening and closing delimiters, is treated as a sequence of <comment-line>'s.

Both <text-section>'s and <tefigel-section>'s may contain any number of <comment-section>'s.

[Previous chapter]    [Next chapter]    [Back to top]