home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / lout2.lzh / LOUT2 / MAN / lout.1 next >
Text File  |  1994-02-26  |  4KB  |  100 lines
  1. .TH LOUT 1
  2. .SH NAME
  3. lout - prepare Lout document for printing
  4. .SH SYNOPSIS
  5. lout [ -i<filename> ] files
  6. .SH DESCRIPTION
  7. Invoke the Basser Lout interpreter on the concatenation of the named
  8. files, producing a PostScript file on standard output suitable for
  9. printing on PostScript printers using lpr(1).  If no files are named,
  10. stdin is used instead.  The special file name - may be used to denote
  11. standard input.  There may be white space between flags like -i and
  12. their associated <filename> or <dirname> values.
  13. .P
  14. An optional .lout suffix may be used for Lout source and include
  15. files.  When invoking files ending in this suffix the suffix may be
  16. omitted.
  17. .SH OPTIONS
  18. .TP 16
  19. -i<filename>  
  20. Search the directories of the include file path (see below) for
  21. <filename> or <filename>.lout and include it.  There may be
  22. multiple -i options.
  23. .TP
  24. -s
  25. Suppress all reading and writing of the cross reference database;
  26. other databases are not affected.  Useful when many simple documents that
  27. don't do any cross referencing are stored in one directory.
  28. .TP
  29. -e<filename>
  30. Direct error messages to <filename> instead of to stderr.
  31. .TP
  32. -o<filename>
  33. Direct PostScript output to <filename> instead of to stdout.
  34. .TP
  35. -I<dirname>
  36. Add <dirname> to the list of directories searched for @Include files
  37. and -i option files.  There may be multiple -I options.  @Include first
  38. searches the current directory, then searches the -I directories in the
  39. order given, and finally searches the default include file directory
  40. (see below).  @SysInclude and the -i option omit the search of the
  41. current directory.
  42. .TP
  43. -C<dirname>
  44. Add <dirname> to the list of directories searched for character
  45. encoding (.CEV) files.  There may be multiple -C options; the directories
  46. are searched in the order given, and finally the default encoding
  47. vectors directory is searched (see below).
  48. .TP
  49. -F<dirname>
  50. Add <dirname> to the list of directories searched for font metrics
  51. (.AFM) files.  There may be multiple -F options; the directories are
  52. searched in the order given, and finally the default font metrics
  53. directory is searched (see below).
  54. .TP
  55. -D<dirname>
  56. Add <dirname> to the list of directories searched for Lout database
  57. files.  There may be multiple -D options.  @Database searches the
  58. current directory, then the -D directories in the order given, and
  59. finally searches the default databases directory (see below).
  60. @SysDatabase omits the search of the current directory.
  61. .TP
  62. -u
  63. Print usage information on stderr.
  64. .TP
  65. -V
  66. Print version information on stderr.
  67. .TP
  68. -EPS
  69. Produce output in the form of an EPS (Encapsulated PostScript) file,
  70. suitable for inclusion in another document.
  71. .SH LIMITS
  72. .nf
  73. At most 255 input files (no limit on @IncludeGraphic files)
  74. At most 255 characters per input line
  75. At most 100 fonts (each different size counts as one font)
  76. At most 5 deep nesting of @Include files
  77. .SH FILES
  78. .nf
  79. Binary file:                    <BINDIR>/lout
  80. Default include file directory: <LIBDIR>/include
  81. Default databases directory:    <LIBDIR>/data
  82. Default font metrics directory: <LIBDIR>/font
  83. Default encoding vectors dir.:  <LIBDIR>/evec
  84. Lout documentation directory:   <DOCDIR>
  85. .fi
  86. .SH SEE ALSO
  87. .P
  88. lpr(1), ghostview(1)
  89. .SH REFERENCES
  90. .P
  91. For a description of the Lout document formatting system,
  92. see Jeffrey H. Kingston, "Document Formatting with Lout",
  93. Tech. Rep. 449, Basser Dept. of Computer Science, The
  94. University of Sydney 2006, Australia (December 1992).
  95. See Adobe Systems Inc., "PostScript Language Reference Manual
  96. (Second Edition)", Addison-Wesley, 1990, for PostScript.
  97. .SH AUTHOR
  98. .P
  99. Jeffrey H. Kingston
  100.