INSTALL.dos

   1 INSTALLING catdoc 0.90a on  MS-DOS system.\r
   2 \r
   3 Surprise, but MS-DOS is native platform for this version of catdoc.\r
   4 In difference of previous version, which was UNIX program, ported to\r
   5 DOS, this one was developed under DOS on nine-years old 286 laptop\r
   6 with Turbo C 2.0.\r
   7 \r
   8 So, catdoc works perfectly well on MS-DOS systems. \r
   9 \r
  10 Documentation can be found in files CATDOC.TXT and CATDOC.PS\r
  11 (both produced by UNIX man command)\r
  12 \r
  13 If you've fetched BINARY DISTRIBUTION, note following:\r
  14 \r
  15 1. catdoc expect to find its system-wide configuration file\r
  16    in the same directory as executable (and therefore require DOS\r
  17    version 3 or  above) If you wish to move charset and special char\r
  18    maps to location other than default (charsets subdirectory of\r
  19    directory, containing executable) you must have this configuration\r
  20    file.\r
  21 \r
  22 2. Any file name in configuration file can contain %s escape, which\r
  23    would be substituted by directory of executable.\r
  24 \r
  25 3. All configuration files can use either DOS or UNIX end-of-line\r
  26   convention.\r
  27 \r
  28 4. Per-user configuration probably wouldn't work. But try to define\r
  29    environment variable HOME and put catdoc.rc file in directory,\r
  30    pointed by it.\r
  31 \r
  32 5. Catdoc uses DOS country information as specified by COUNTRY statement\r
  33    in your configuration file to determine output encoding. This\r
  34    settings have priority over settings in configuration files (either\r
  35    per-user or system-wide). If it is not what you want, set \r
  36    use_locale = no in the configuration file.\r
  37 \r
  38 If you are insisting on COMPILING catdoc YOURSELF.\r
  39 Please note that catdoc was compiled under DOS using Turbo C 2.01,\r
  40 downloaded from http://community.borland.com/museum. You can get the\r
  41 same one. \r
  42 \r
  43 I've made some attempts to compile catdoc with Watcom C (16-bit),\r
  44 but haven't completely socceeded. If you do, let me know.   \r
  45 \r
  46 1. With 16-bit compilier, use COMPACT memory model\r
  47    If you are using Turbo C make -fmakefile.tc in src directory\r
  48    should be enough.  If you have to change anything  in\r
  49    the makefile.tc, please let me know.\r
  50    \r
  51 2. If you are using compilier other than Turbo C /Borland C or\r
  52    Watcom,  you should take look on fileutil.c file and possible\r
  53    add couple of #ifdefs  here. If your succed with it, send me a\r
  54    patch  (or entire modified file, if you don't know how to make\r
  55    a good unix-like patch). \r
  56 \r
  57 \r
  58 3. With 32-bit compilier you are on your own. I don't think that\r
  59   small utilities like catdoc should require extender or DPMI host,\r
  60   so I've never tried to build 32-bit version of catdoc for DOS,\r
  61   But if you mix buffer sizes from UNIX version and file-name\r
  62   dependent defines from DOS, you should probably achieve good\r
  63   results.\r
  64 \r
  65 4. With Turbo C you'll need file getopt.c which comes with Turbo C\r
  66    and unistd.h which is provided in compat directory.\r
  67    Compile getopt.c and add it to cc.lib and put unistd.h in\r
  68    your include directory. Later it might help you to port other\r
  69    unix software. With other compilier you can also make use\r
  70    of getopt.c in compat directory (which is from GNU), but I was\r
  71    unable to make it work with Watcom 10.0\r
  72 \r
  73 5. It is probably good idea to link wildargs.obj (or wildargv.obj)\r
  74    with catdoc. I didn't do it myself becouse I use korn shell on\r
  75    machine where I've developed catdoc, so I don't need to include\r
  76    parameter expansion in program.\r