home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / e / textps.doc < prev    next >
Text File  |  2020-01-01  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. TEXTPS(LOCAL)     MISC. REFERENCE MANUAL PAGES      TEXTPS(LOCAL)
  5.  
  6.  
  7.  
  8. NAME
  9.      textps - convert text file to PostScript
  10.  
  11. SYNOPSIS
  12.      textps [ -h ] [ -v ] [ -c charset ] < input > output
  13.  
  14.  
  15. DESCRIPTION
  16.      textps converts an ordinary text file to  PostScript,  suit-
  17.      able  for printing on a PostScript printer such as the Apple
  18.      Laserwriter, or viewing with a PostScript previewer such  as
  19.      ghostscript,  or  Preview  on the NeXT.  Reads from standard
  20.      input, writes to  standard  output.   textps  converts  text
  21.      files  to Courier-11, 66 lines to the page, 80 characters to
  22.      the line.  Handles pagination, tabs, line  wrap,  overstruck
  23.      characters  (via  backspace)  and overstruck lines (via car-
  24.      riage return).  Absorbs ANSI escape sequences without print-
  25.      ing  them.   If  the input file is already PostScript, it is
  26.      simply copied to the output without alteration.  textps pro-
  27.      duces no special effects.
  28.  
  29.      Unlike most other "enscriptors", textps handles 8-bit  char-
  30.      acter  sets  correctly.   The  default file character set on
  31.      MS-DOS or OS/2 PCs is the current code page, the NeXT  char-
  32.      acter  set on NeXT workstations, and ISO 8859-1 Latin Alpha-
  33.      bet 1 elsewhere.  Override the default  character  set  with
  34.      command-line  options.  Shift-In/Shift-Out codes (Ctrl-N and
  35.      Ctrl-O) within the text are also handled correctly, allowing
  36.      for representation of 8-bit characters in the 7-bit environ-
  37.      ment, for example in e-mail.
  38.  
  39.  
  40. OPTIONS
  41.      -h   displays a help message.
  42.  
  43.      -v   produces a page  showing  the  textps  program  version
  44.           number and the printer's PostScript version number.
  45.  
  46.      -c   specifies the file's character set.   The  choices  are
  47.           apple  (Apple  QuickDraw),  cp437  (IBM code page 437),
  48.           cp850 (IBM code page 850),  decmcs  (DEC  multinational
  49.           character set), latin1 (ISO Latin Alphabet 1), and next
  50.           (the NeXT character set).  The character set  name  can
  51.           be abbreviated as long as you have given enough charac-
  52.           ters to distinguish it from the others.
  53.  
  54. EXAMPLES
  55.      textps < infile > outfile
  56.  
  57.      textps < infile | lpr
  58.  
  59.      textps -c cp850 < infile > prn
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TEXTPS(LOCAL)     MISC. REFERENCE MANUAL PAGES      TEXTPS(LOCAL)
  71.  
  72.  
  73.  
  74.      textps -v -c latin1 < infile | lpr
  75.  
  76.  
  77. ERRORS
  78.      Returns an exit status code of 0 on success, 1  on  failure.
  79.      Fails  only  if  it  is  invoked  with  invalid command line
  80.      options, in which case an error message  is  printed,  along
  81.      with usage instructions.
  82.  
  83.  
  84. BUGS
  85.      textps constructs its own internal font, which contains  all
  86.      of  the  characters of Latin Alphabet 1, plus 32 additional.
  87.      File characters that don't have equivalents  in  this  font,
  88.      such  as  PC line- and box- drawing characters, are approxi-
  89.      mated with ASCII characters like  '+',  '-',  '|'  and  'X'.
  90.      Characters that cannot be translated are shown as '?'.
  91.  
  92.      PC code pages 857, 860, 861, 863, and 865 are  treated  like
  93.      code page 437.
  94.  
  95.      Printers  with  PostScript  versions  prior  to  47.0  might
  96.      display certain characters as spaces: broken bar, copyright,
  97.      trade mark, not sign,  fractions,  superscripts,  Y/y-acute,
  98.      Icelandic  Thorn/thorn  and  Eth/eth.   Use the -v option to
  99.      have the printer display its PostScript version number.
  100.  
  101.      When textps is installed as a print filter, there is no  way
  102.      way  to pass options to it.  So, for example, you can't tell
  103.      it to use a different character  set.   In  that  case,  run
  104.      textps "manually":
  105.  
  106.      textps -c decmcs < decmcs.txt | lpr
  107.  
  108.  
  109. AUTHOR
  110.      Frank da Cruz, Columbia University,  July  1991,  with  help
  111.      and/or  PostScript  code  from Bur Davis of Adobe and Darrel
  112.      Hankerson of Auburn University.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.