DOS-only/00README.TXT

   1 Basic installation instructions for Antiword for DOS
   2 ====================================================
   3 Unpack antiword.zip
   4   pkunzip -d antiword.zip c:\antiword
   5
   6 NOTE: experienced users of DOS may want to edit their autoexec.bat in order
   7 to add the Antiword directory to their PATH variable.
   8
   9 If you don't do this, you will need to go into the Antiword directory before
  10 running the program.
  11
  12
  13 More advanced installation
  14 ==========================
  15 These instructions can be followed under all versions of Windows, but are
  16 most useful under Windows NT, 2000 and XP.
  17
  18 (1) Go to the configuration screen and choose system and environment. Make a
  19     HOME environment variable containing C:\home\yourname or H:\loginname or
  20     something similar.
  21 (2) Follow the basic installation instructions, but use %HOME%\antiword as
  22     the Antiword directory.
  23
  24
  25 Problems
  26 ========
  27
  28 If get an dpmi error like: "Load error: no DPMI - Get csdpmi*.zip", you can
  29 download the missing component from:
  30 ftp://ftp.fh-koblenz.de/pub/DJGPP/current/v2misc/csdpmi5b.zip
  31
  32
  33 Differences between the Unix version of Antiword and the DOS version
  34 ====================================================================
  35
  36 (1)
  37 The Unix version looks for its mapping files in $HOME/.antiword.
  38 The DOS version looks for its mapping files in %HOME%\antiword if HOME is set
  39 and in C:\antiword if HOME is not set.
  40
  41 (2)
  42 The Unix version reads its font information from a file called fontnames.
  43 The DOS version reads its font information from a file called fontname.txt.
  44
  45 (3)
  46 The DOS version expects its mapping files to be in DOS text format. That means
  47 that all lines must end with a carriage return, line feed combination. (CR+NL)
  48
  49 (4)
  50 The Unix version needs mapping file 8859-1.txt for Latin1 text and 8859-2.txt
  51 for Latin2 text.
  52 The DOS version needs mapping file cp850.txt for Latin1 text and cp852.txt for
  53 Latin2 text.
  54
  55 (5)
  56 The DOS version rejects all files with long filenames.
  57 Please use the DOS name (8+3) instead.
  58
  59 (6)
  60 The Antiword executable (antiword.exe) can be placed in any directory. If you
  61 choose a directory from your %PATH%, you will not have to use a full pathname
  62 every time.
  63
  64 (7)
  65 Under DOS the default mapping file does not depend on the locale. Locale is
  66 a POSIX feature. Under DOS the default mapping file depends on the active
  67 codepage.
  68
  69
  70 Examples of use
  71 ===============
  72
  73 To get text output
  74 ==================
  75
  76 (1) display a Word document in Latin1, one page at a time
  77 antiword -m cp850.txt filename.doc | more
  78
  79 (2) save the text version of a Word document in Latin2 in a file
  80 antiword -m cp852.txt filename.doc > filename.txt
  81
  82 (3) display a Word document in Hebrew, one page at a time
  83 antiword -m cp862.txt filename.doc | more
  84
  85 (4) save the text version of a Word document in Russian Cyrillic in a file
  86 antiword -m cp866.txt filename.doc > filename.txt
  87
  88 To get PostScript output
  89 ========================
  90
  91 (1) save the PostScript version of a Word document in Latin1 in a file,
  92     generate PostScript for printing on European A4 size paper
  93 antiword -p a4 -m 8859-1.txt filename.doc > filename.ps
  94
  95 (2) save the PostScipt version of a Word document in Latin2 in a file,
  96     generate PostScript for printing on American letter size paper
  97 antiword -p letter -m 8859-2.txt filename.doc > filename.ps
  98
  99 (3) save the PostScript version of a Word document in Cyrillic in a file,
 100     generate PostScript for printing on European A4 size paper
 101 antiword -p a4 -m 8859-5.txt filename.doc > filename.ps
 102
 103 NOTE: PostScript ouput is only supported for character sets Latin1, Latin2 and
 104       Cyrillic.
 105
 106 NOTE: You need different mapping files for text and PostScript.
 107
 108 The order of the switches is not important to Antiword. If you specify two or
 109 more settings of the same switch, Antiword will use the rightmost one.
 110
 111
 112 Screen fonts
 113 ============
 114
 115 This section is only for the few people who want Antiword output in more than
 116 one character set.
 117
 118 If you want Antiword to display a character set other than the ones you know
 119 your version of DOS can display already, you must first load a screen font.
 120 This screen font must match the mapping file or files you are using.
 121
 122 You can download the freeware collection of VGA screen fonts and font
 123 loader fntcol16.zip (452 KB) from SimTel:
 124 http://www.simtel.net/pub/pd/49501.html
 125 or
 126 ftp://ftp.simtel.net/pub/simtelnet/msdos/screen/fntcol16.zip