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.21 < prev    next >
Text File  |  1994-01-25  |  2KB  |  42 lines
  1. @Section
  2.    @Title { "@Open and @Use" }
  3.    @Tag { open }
  4. @Begin
  5. @PP
  6. The @@Open symbol
  7. open.sym @Index { @@Open symbol }
  8. takes a cross reference or symbol
  9. invocation for its left parameter, and an arbitrary object, which must
  10. be enclosed in braces, for its right parameter.  The right parameter
  11. may refer to the exported parameters and nested definitions of the invocation
  12. denoted by the left parameter, and its value is the @@Open
  13. symbol's result.  The target of the cross reference may lie in an
  14. external database (Section {@NumberOf database}).  Any symbol available
  15. outside the @@Open which happens to have the same name as one of the
  16. symbols made available by the @@Open will be unavailable within the @@Open.
  17. @PP
  18. use.sym @Index { @@Use symbol }
  19. The @@Use symbol is an @@Open symbol in a
  20. different form.  It may only appear just after the definitions
  21. in Lout's input, and it is equivalent to enclosing the remainder of the
  22. input in an @@Open symbol.  For example,
  23. @ID {
  24.       @I definitions
  25. //1vx @Code "@Use" @Code "{" @I x @Code "}"
  26. //1vx @Code "@Use" @Code "{" @I y @Code "}"
  27. //1vx @I { rest of input }
  28. }
  29. is equivalent to
  30. @ID {
  31.       @I definitions
  32. //1vx @I x @Code "@Open"
  33. //1vx @Code "{" &4mt @I y @Code "@Open"
  34. //1vx   &4mt @Code "{" @I { rest of input }
  35. //1vx   &4mt @Code "}"
  36. //1vx @Code "}"
  37. }
  38. The @@Use symbol allows a set of standard packages to be opened without
  39. the inconvenience of enclosing the entire document in @@Open symbols.  Such
  40. enclosure could cause Basser Lout to run out of memory.
  41. @End @Section
  42.