home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / anwor032.zip / antiword.0.32 / Docs / FAQ < prev    next >
Text File  |  2001-08-01  |  3KB  |  71 lines

  1. Frequently Asked Questions (Unix version)
  2. =========================================
  3.  
  4. Q1: How do I install antiword?
  5. A1: (a) Make a suitable directory like '$HOME/src/antiword' and copy the
  6.         'antiword.tar.gz' file to this directory.
  7.     (b) decompress: 'gunzip antiword.tar.gz'
  8.     (c) unpack: 'tar xvf antiword.tar'
  9.     (d) compile: 'make all'
  10.     (e) install: 'make install'. This will install antiword in the $HOME/bin
  11.         directory.
  12.     (f) copy the file called 'fontnames' and one or more mapping files from
  13.         the Resources directory to the $HOME/.antiword directory (note the
  14.         dot before antiword!).
  15.     NOTE: you can skip point (f) if your system administrator already copied
  16.           these files to /opt/antiword/share.
  17.  
  18. Q2: How do I use antiword?
  19. A2: Type antiword -h and see.
  20.  
  21. Q3: How does antiword deal with Word macro viruses?
  22. A3: Antiword does not run any Word macros because it can't do so.
  23.     Therefore such a virus will not harm your computer system.
  24.  
  25. Q4: What is the purpose of the file 'fontnames' in the '/opt/antiword/share'
  26.     or '$HOME/.antiword' directory?
  27. A4: This file provides a translation table from the fontnames as they are
  28.     found in a Word document to the fontnames as they are known to a Postscript
  29.     printer.
  30.     The file 'fontnames' is user-editable to make it suit the collection
  31.     of fonts on your Postscript printer.
  32.  
  33. Q5: What is 'Hidden text'?
  34. A5: Hidden text is Microsoft speak for text that will or will not be shown
  35.     on the screen, subject to the users preferences, but such text is never
  36.     printed.
  37.  
  38. Q6: Antiword claims to support all ISO-8859 character sets, but I can't see
  39.     any of this.
  40. A6: There is support for all ISO-8859 character sets, but only in the text
  41.     output, not in the PostScript output.
  42.     The result can only be seen if your xterm, vtterm, kvt or similar
  43.     terminal emulation program uses a font compatible with that ISO-8859
  44.     character set.
  45.  
  46. Q7: What is the right mapping file (-m option) in my situation?
  47. A7: The correct mapping file depends on the character set you need for a
  48.     specific language.
  49.     For languages from Western Europe (English, French, German) that will be
  50.     mapping file 8859-1.txt.
  51.     For languages from Eastern Europe (Polish, Czech, Slovak, Croatian) that
  52.     will be mapping file 8859-2.txt. (When working under OS/2 you might also
  53.     try mapping file cp1250.txt)
  54.     For Esperanto that will be mapping file 8859-3.txt.
  55.     For Russian that will be mapping file 8859-5.txt or koi8-r.txt. (When
  56.     working under OS/2 you might also try mapping file cp1251.txt)
  57.     For Hebrew that will be mapping file 8859-8.txt.
  58.     If your system supports it, you might also try UTF-8.txt.
  59.  
  60. Q8: I tried UTF-8, but some documents show more garbage than text. Why?
  61. A8: UTF-8 will only work if the document was saved by an Unicode enabled
  62.     version of Word (or if Word used ISO-8859-1 as its internal encoding).
  63.     The following versions of Word are known to be Unicode enabled:
  64.     Word 6 and Word 7 for oriental langages, all versions of Word 97,
  65.     Word 98 (Mac), Word 2000, Word 2001 (Mac) and Word 2002 (aka Word XP).
  66.  
  67. Q9: Why can't antiword read from stdin directly? Why use a temporary file?
  68. A9: The information in a Word document is not stored sequentially. Therefore
  69.     the use of the "fseek" function can't be avoided. So antiword must copy
  70.     stdin to a temporary file first and then process that file.
  71.