home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / printers / textps.txt < prev   
Text File  |  2020-01-01  |  5KB  |  128 lines
  1. TEXTPS.EXE  -  Convert a plain-text file to PostScript.
  2.  
  3.  
  4. Author: Frank da Cruz, Columbia University
  5.  
  6.   Copyright (C) 1991, 1996, Trustees of Columbia University in the City
  7.   of New York, all rights reserved.
  8.  
  9. Acknowledgements to Bur Davis of Adobe Systems, Darryl Hankerson of
  10. Auburn University, and Jeffrey Altman of Columbia University.
  11.  
  12.  
  13. DESCRIPTION
  14.  
  15. TEXTPS converts an ordinary plain-text file to PostScript, suitable for
  16. printing on a PostScript printer such as the Apple Laserwriter, or viewing
  17. with a PostScript previewer such as ghostscript, or NeXTSTEP Preview.
  18.  
  19. TEXTPS reads the plain text file from standard input and writes the
  20. PostScript file to standard output.  Thus TEXTPS would normally be used with
  21. standard input/output file redirection, for example:
  22.  
  23.   textps < oofa.txt > lpt1
  24.  
  25. TEXTPS converts text files to Courier-11, 66 lines to the page, 80
  26. characters to the line, with options to select different page sizes.
  27.  
  28. It handles pagination, tabs, line wrap, overstruck characters (via
  29. backspace) and overstruck lines (via carriage return).  TEXTPS absorbs
  30. ANSI escape sequences without printing them.  If the input file is
  31. already PostScript, it is simply copied to the output without alteration.
  32. TEXTPS produces no special effects such as page headings, 2-up or 4-up
  33. printing, or rotation.
  34.  
  35. Unlike most other "enscriptors", TEXTPS handles 8-bit character sets
  36. correctly.  The default file character set in Microsoft Windows is CP437; in
  37. DOS or OS/2 it is the current code page; in NeXTSTEP it is the NeXT character
  38. set, and it is ISO 8859-1 Latin Alphabet 1 elsewhere.  You can override the
  39. default character set with a command-line option.  Shift-In/Shift-Out codes
  40. (Ctrl-N and Ctrl-O) within the text are also handled correctly, allowing for
  41. representation of 8-bit characters in the 7-bit environment, for example in
  42. e-mail.
  43.  
  44.  
  45. OPTIONS
  46.  
  47.  -h  Displays a help message.
  48.  
  49.  -v  Produces a page showing the textps program version number and the
  50.      printer's PostScript version number.
  51.  
  52.  -l number
  53.      Specifies the number of lines on a page.  The default is 66.  Use
  54.      70 for A4 paper.
  55.  
  56.  -w number
  57.      Specifies the number of characters on line.  The default is 80.
  58.  
  59.  -c  Specifies the file's character set.  The choices are apple (Apple
  60.      QuickDraw), cp437 (IBM code page 437), cp850 (IBM code page 850),
  61.      decmcs (DEC multinational character set), latin1 (ISO Latin Alphabet 1),
  62.      and next (the NeXT character set).  The character set name can be
  63.      abbreviated as long as you have given enough characters to distinguish
  64.      it from the others.
  65.  
  66.  
  67. EXAMPLES
  68.  
  69. textps < infile > outfile                (file conversion)
  70.  
  71. textps < infile | lpr                    (UNIX)
  72.  
  73. textps -c cp850 < infile > prn           (DOS or Windows)
  74.  
  75. textps -v -c apple < infile | lpr        (UNIX with character-set override)
  76.  
  77. To use TEXTPS with Kermit 95, give its pathname and the device name of your
  78. PostScript printer in a SET PRINTER command; for example:
  79.  
  80.   set printer |d:\k95\textps.exe>lpt1
  81.  
  82. in which:
  83.  
  84.   |                   is the "pipe" sign
  85.   d:\k95\textps.exe   is the pathname of the TEXTPS program
  86.   >                   is the output redirection sign
  87.   lpt1                is the name of the printer 
  88.  
  89. Then all material that is routed to your printer by host-generated escape
  90. sequence (transparent print or autoprint) or by other events in the terminal
  91. Window (such as Kverbs like \kDump or \kPrintFF) will go through TEXTPS first
  92. for conversion to PostScript.
  93.  
  94. Note: Spaces are not allowed in the Kermit 95 SET PRINTER "filename" field.
  95.  
  96.  
  97. ERRORS
  98.  
  99. TEXTPS returns an exit status code of 0 on success, 1 on failure.  TEXTPS
  100. fails only if it is invoked with invalid command line options, in which case
  101. an error message is printed, along with usage instructions.
  102.  
  103.  
  104. BUGS
  105.  
  106. TEXTPS constructs its own internal font, which contains all of the
  107. characters of Latin Alphabet 1, plus 32 additional.  File characters that
  108. don't have equivalents in this font, such as PC line- and box- drawing
  109. characters, are approximated with ASCII characters like '+', '-', '|' and
  110. 'X'.  Characters that cannot be translated are shown as '?'.
  111.  
  112. PC code pages 857, 860, 861, 863, and 865 are treated like code page 437.
  113.  
  114. Printers with PostScript versions prior to 47.0 might display certain
  115. characters as spaces: broken bar, copyright, trade mark, not sign,
  116. fractions, superscripts, Y/y-acute, Icelandic Thorn/thorn and Eth/eth.  Use
  117. the -v option to have the printer display its PostScript version number.
  118.  
  119. When textps is installed as a print filter (e.g. in UNIX, to be used
  120. automatically by lpr), there is no way way to pass options to it.  So, for
  121. example, you can't tell it to use a different character set.  In that case,
  122. run textps "manually" and then print its output; for example:
  123.  
  124.   textps -c decmcs < decmcs.txt | lpr
  125.  
  126.  
  127. (End of TEXTPS.DOC)
  128.