diff options
Diffstat (limited to 'doc/expert/pre_incl')
| -rw-r--r-- | doc/expert/pre_incl | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/expert/pre_incl b/doc/expert/pre_incl new file mode 100644 index 0000000..c531096 --- /dev/null +++ b/doc/expert/pre_incl @@ -0,0 +1,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 |