aboutsummaryrefslogtreecommitdiffstats
path: root/doc/expert/pre_incl
blob: c531096864445285c0c108ef93178652ecf02445 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
@Section
   @Tag { include }
   @Title { "@Include and @SysInclude" }
@Begin
@PP
include.sym @Index { @@Include symbol }
sysinclude.sym @Index { @@SysInclude symbol }
These symbols instruct Lout to temporarily switch to reading another
file, whose name appears in braces following the symbol.  For example,
@ID @Code {
"@Include { \"/usr/lout/fontdefs\" }"
}
will cause the contents of file "/usr/lout/fontdefs" to be read at the
point it occurs.  After that file is read, the current file is resumed.  The
included file may contain arbitrary Lout text, including other
@@Include commands.  The file is searched for first in the current
directory, then in a sequence of standard places which are not necessarily the
same places that databases are searched for.  @@SysInclude searches the
standard places only.
@End @Section