home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / lout2.lzh / LOUT2 / DOC / TR.LOUT / ch3.01 < prev    next >
Text File  |  1994-01-25  |  894b  |  32 lines
  1. @Section
  2.    @Title { "@Begin" and "@End" }
  3.    @Tag { begin }
  4. @Begin
  5. @PP
  6. The body of a symbol @Code "@Sym" may be enclosed in @@Begin and
  7. begin. @Index { @@Begin symbol }
  8. end. @Index { @@End symbol }
  9. @@End @Code "@Sym" instead of the more usual braces:
  10. @ID @Code {
  11. "def @Section"
  12. "    named @Title {}"
  13. "    right @Body"
  14. "@Begin"
  15. "    @Title //2v @Body"
  16. "@End @Section"
  17. }
  18. They may also enclose the right or body parameter of a symbol invocation:
  19. @ID @Code {
  20. "@Chapter"
  21. "    @Title { Introduction }"
  22. "@Begin"
  23. "This subject needs no introduction."
  24. "@End @Chapter"
  25. }
  26. Apart from their utility as documentation aids, these forms allow Basser
  27. Lout to pinpoint mismatched braces, which can otherwise create total
  28. havoc.  For this reason, they should enclose the major parts of documents,
  29. such as chapters and sections.  Note that braces cannot be
  30. replaced by @@Begin and @@End in general.
  31. @End @Section
  32.