Next: Special option: headlinebase   Previous: File inclusion   Contents: Contents

Including nested PerlPoint sources

If the type of an included file is specified as "PP", the file contents is made part of the presentation source.


  // include PerlPoint
  \INCLUDE{type=pp file="nested.pp"}

The nesting level is umlimited, but every file in a nesting hierarchy is read only once (to avoid confusion by circular nesting). (Including the same file multiply in different nesting hierarchies is possible without problems.)

A PerlPoint file can be included wherever a tag is allowed, but sometimes it has to be arranged slightly: if you place the inclusion directive at the beginning of a new paragraph and your included PerlPoint starts by a paragraph of another type than text, you should begin the included file by an empty line to let the parser detect the correct paragraph type. Here is an example: if the inclusion directive is placed like


  // include PerlPoint
  \INCLUDE{type=pp file="file.pp"}

and file.pp immediately starts with a verbatim block like


  <<VERBATIM
      verbatim
  VERBATIM

, the inclusion directive already opens a new paragraph which is detected to be text (because there is no special startup character). Now in the included file, from the parsers point of view the included PerlPoint is simply a continuation of this text, because a paragraph ends with an empty line. This trouble can be avoided by beginning such an included file by an empty line, so that its first paragraph can be detected correctly.

Next: Special option: headlinebase   Previous: File inclusion   Contents: Contents