home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / ps-to-text / freeware_readme.txt next >
Text File  |  1996-09-20  |  3KB  |  85 lines
  1. PS-To-Text, Utilities, Convert Postscript documents to plain ASCII text
  2. Greetings,
  3.  
  4. Here's a PS to Text filter that works pretty well.  It is pretty
  5. simple, as it does not interpret PS, but merely parses it based on previous
  6. knowledge about the relevant PS operators.  
  7.  
  8. This program is not currently a part of any product.  Enjoy.
  9.  
  10. David
  11.  
  12.  
  13. ------------------------------------------------------------
  14. Features:
  15.  
  16. - filters PS text back into text
  17. - keeps page, paragraph and line breaks
  18. - traps kerning in some PS implementations
  19. - can handle included PS files, provided the file is by a supported 
  20.     creator
  21. - supports following PS creators:
  22.   + VAX Document (Latin, and Japanese)
  23.   + DECwrite (Latin, and Japanese)
  24.   + dtroff
  25.   + troff
  26.   + Rags
  27. - creators are registered in a run-time accessed dat file
  28.   + it has not been too difficult to add new creators
  29. - runs on U*x and VMS and Dos 
  30.  
  31.  
  32. Usage:
  33. - on VMS, copy executable, to any directory
  34.   + invoke with a symbol
  35.   + Make sure that dat file resides in your top-level directory
  36. - on U*X, compile and link.  Please call the executable 'ps2text'
  37.   + place dat file in top level shell
  38.   + invoke by typing 'ps2text'
  39. - on DOS, copy the executable ps2text.dos
  40. - the first parameter is the input file
  41. - the second parameter is the output file.  If missing, output goes to the
  42.   terminal
  43. - a modicum of help is available via -h or '?'
  44.  
  45.  
  46. Notes:
  47. - some error messages, but not ideal
  48. - code is pretty thoroughly commented
  49. - no Mac PS yet.  Feel free to try and get it working and send it to me
  50. - more graphics creators are needed
  51. - Please feel free to send flame-free comments and criticisms, bug fixes,
  52.   new creators, and whatnot to VAXUUM::PARMENTER.  This is the first U*X work
  53.   I've ever done, so I'm especially interested in that side of things.
  54. - Output is usually quite wide.  It typically looks better with your terminal
  55.   set to 132 width mode
  56. - Code has no global variables.  If you decide to extend it, please do so
  57.   without introducing any global variables
  58.  
  59.  
  60. The posting contains:
  61. - ps2text.c: the main converter
  62. - psdat.c: reads the dat file
  63. - ps2text.dat: dat file of registered PS creators
  64. - ps2text.h: include file for the 'c' source files
  65. - ps2text.exe: VMS executable
  66. - ps2text.opt: VMS options file
  67.  
  68. To build:
  69. - cc ps2text, psdat
  70. - link ps2text/opt
  71.  
  72. To run:
  73. - copy pstext.dat into your home directory
  74. - define logical: $ps2text to the directory containing ps2text.dat
  75. - define symbol:  ps2text :== $disk:[directory]ps2text.exe
  76. - ps2text foo.ps [output file] ! output file is optional
  77.  
  78.  
  79. All files are located in 
  80.   via::$user3:[parmenter.public.ps]
  81.  
  82. Enjoy,
  83.  
  84. David
  85.