home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / utils / rtfprsr / readme < prev    next >
Text File  |  1995-05-18  |  3KB  |  68 lines
  1. RTF-stuff 1.06a1
  2. 05 Apr 91    Paul DuBois    dubois@primate.wisc.edu
  3.  
  4. This directory contains source and documentation [sic] for a simple
  5. RTF (Rich Text Format) translation tool.  Files in this format can be
  6. produced with, e.g., Microsoft Word, or on NeXT machines.
  7.  
  8. If you use the Imakefile, you must obtain the WRPRC imake distribution.
  9. If you want to skip that and just use the Makefile you will have to edit
  10. some of the make variable definitions.  Use "make -n" and "make -n install"
  11. to see what will happen on your machine first!
  12.  
  13. Documentation that is in troff format should be formatted with the -ms
  14. macros.
  15.  
  16. The WRPRC imake distribution is available via anonymous ftp to host
  17. ftp.primate.wisc.edu in ~ftp/pub.
  18.  
  19. The translators currently available are listed below.  Most of them
  20. don't do anything interesting.
  21.  
  22. rtf2null    RTF -> nothing
  23. rtf2text    RTF -> plain text
  24. rtf2troff    RTF -> troff
  25. rtfwc        "translates" RTF into character, word and paragraph count
  26. rtfdiag        RTF diagnostic program, used mainly to test RTF reader
  27. rtfskel        RTF translator skeleton, for use in building new translators
  28.  
  29. Each translator uses a tool which reads an RTF input stream and passes
  30. pieces of it to a writer.
  31.  
  32. There is also a tool, rtfindent, which reads an RTF file and writes it in
  33. somewhat more readable form.  This is helpful when designing a translator,
  34. to see what RTF files look like, but the output should not be fed into
  35. a translator.
  36.  
  37. Distribution files of interest:
  38.  
  39. rtf.h        RTF header file; include in any source file using
  40.         RTF-specific info.
  41. reader.c    RTF reader.  Must be part of any RTF translator.  See the
  42.         sample translators for examples of use.
  43. rtfskel.c    Skeleton translator.  You can rip this apart to use as the
  44.         basis for new translators.
  45. Porting        Some notes on machine dependencies.
  46.  
  47. Version History:
  48.  
  49. 20 Jan 91 V1.00.  Project conceived.
  50.  
  51. 07 Feb 91 V1.01.  First release for FTP on indri.
  52.  
  53. 08 Feb 91 V1.02.  Added rtfskel.
  54.  
  55. 08 Feb 91 V1.03.  Style reprocessing and built-in destination readers were
  56.     actually tried in the balance.  And found wanting.  Fixed 'em.
  57.     Put some actually useful stuff in rtfdiag.
  58.  
  59. 09 Feb 91 V1.04.  Renamed rtfAscii class to rtfText.  Original name was poor
  60.     since character values can be outside ascii range (> 127).
  61.  
  62. 04 Mar 91 V1.05.  Lots of changes, most notably that twice as many control
  63.     symbols are recognized by the reader.  Also some bug fixes.  See
  64.     "Changes-1.05".
  65.  
  66. 05 Apr 91 V1.06a1.  Alpha release of 1.06.  See "Changes-1.06".  Major
  67.     thing is tbl support for rtf2troff.
  68.