home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / catdo_35.zip / README.catdoc < prev    next >
Text File  |  1999-12-17  |  3KB  |  87 lines
  1.                       CATDOC ver. 0.35
  2.                 Copyright(c) by Softweyr 96-98
  3.  
  4.      Free converter from MS-Word to TeX or plain text.
  5.  
  6.                           OVERVIEW
  7.  
  8. This program extracts text from MS-Word files, trying to preserve
  9. as much special printable characters as possible. 
  10.  
  11. It doesn't even try to preserve fancy Word formatting, becouse
  12. Word users usually don't care about document structure, and it is
  13. this very thing, which important for LaTeX users.
  14.  
  15. Catdoc was designed to work with Cyrillic MS-Word files, so it
  16. can convert Cyrillic from ANSI 1251 code page to KOI-8 (for UNIX)
  17. or CP 866 (for DOS). This feature can be disabled at compile time.
  18.  
  19.                        SUPPORTED PLATFORMS
  20.  
  21. Catdoc was tested by author on Linux, BSDI and Solaris (gcc 2.7.x) and DOS 
  22. (Watcom C 10, 16-bit). There was also reports of successiful uses
  23. of catdoc on Digital UNIX, HP-UX and other flavors of UNIX, and even
  24. on Windows NT (as 32-bit console application).
  25.  
  26. I don't expect any troubles with catdoc on any platform which has
  27. ANSI C compilier and supports notion of stdout and stderr.
  28.  
  29.                      SUPPORTED VERSIONS OF WORD
  30.  
  31. Catdoc was tested on files produced by MS-Word 6.0 for Windows and
  32. MS-Word 7.0 for Window-95. It definitely doesn't work with Word-97 
  33. files, stored in UNICODE. It should also work with earlier versions
  34. of Word, or even MS-Write but it was never tested. 
  35.  
  36.  
  37.                    LIMITATION
  38.  
  39. Doesn't handle any embedded OLE objects, including MS-Equation
  40. Doesn't handle fastsaves and footnotes properly (modifications
  41. and footnotes are printed at the end of text as separate paragraphs)
  42. Can output garbage in place of OLE objects. (it is better to have
  43. garbage, then lose part of text). Doesn't output proper table
  44. headers in Latex mode.
  45.                     
  46.  
  47.                    LICENSE
  48.  
  49. This program is distributed under GNU Public License
  50.  
  51. Full text of this license can be obtained from:
  52. http://www.gnu.ai.mit.edu/copyleft/gpl.html
  53.  
  54.                    INSTALLATION
  55.  
  56. All platforms:
  57.  
  58.   Check if you need Cyrillic translation. If not so,
  59.   uncomment line 
  60. #define LATIN1
  61.   in catdoc.c
  62.  
  63. Unix
  64.  
  65. compile catdoc.c with 
  66.  
  67. cc catdoc.c -o catdoc
  68.  
  69. and put resulting binary in any directory on your path. 
  70. Put manual page (catdoc.1) into appropriate directory.
  71.  
  72. If you have Tcl/Tk version 7.6 or higher you can also
  73. install accompainiing wordview script, which is X11 interface
  74. to catdoc. It should be installed into same directory as catdoc
  75. itself. Edit first line of the script to point to your copy
  76. of wish.
  77.  
  78. Dos
  79.  
  80. compile catdoc.c with your favorite C compilier and put
  81. catdoc.exe in any directory on your path. If you use 16-bit
  82. compilier, use small memory model
  83.  
  84.                    AUTHOR
  85.  
  86. Victor Wagner <vitus@fe.msk.su>
  87.