contrib/groff/README.WIN32

   1 \r
   2 WIN32 port of GROFF and friends done by Blake McBride\r
   3 (blake@florida-software.com) 4/14/00.\r
   4 \r
   5 This port differs from other ports in that it uses the Microsoft\r
   6 compiler.  The changes were done such that they only have effect on\r
   7 the code when compiled with the Microsoft compiler.\r
   8 \r
   9 Note that not all preprocessors and output devices have been ported;\r
  10 missing are grohtml, grolbp, grn, refer, soelim, and groff.  Besides\r
  11 these programs, no utility program has been ported.  Of course,\r
  12 gxditview (which only runs on the X Window System, the standard Unix\r
  13 GUI) is missing also.\r
  14 \r
  15 \r
  16 The following programs were used, running on Windows NT 4.0:\r
  17 \r
  18   Microsoft Visual C++ 6.0\r
  19   Unix utilities under NT (gzip, tar, patch)\r
  20 \r
  21 \r
  22 Build Instructions\r
  23 ------------------\r
  24 \r
  25 . Unpack groff (using gzip & tar) as follows:\r
  26 \r
  27     cd \\r
  28     gzip -dc groff-1.16.tar.gz | tar xvf -\r
  29 \r
  30 . Now apply the patch file `win32-diffs':\r
  31 \r
  32     cd \groff-1.16\r
  33     patch -p1 < win32-diffs\r
  34 \r
  35   Note that with older versions of `patch', you will get a lot of\r
  36   *.orig files (most of them are empty) which can be safely deleted.\r
  37 \r
  38 . Edit the file `src/include/defs.h' and adapt the path names to\r
  39   your needs.\r
  40 \r
  41 . Build everything by typing:\r
  42 \r
  43     nmake -f Makefile.msc\r
  44 \r
  45 You are done.\r
  46 \r
  47 The `bin' directory contains some .cmd files to help show how to run\r
  48 stuff.  Since Windows 95/98 doesn't understand .cmd files, if you are\r
  49 operating under that OS, you'll have to rename them to .bat files. \r
  50 .bat files do have output redirection problems.\r
  51 \r
  52 \r
  53 The changes I made fall into two categories.\r
  54 \r
  55 1.  Makefiles.  Several makefiles were added.  All makefiles were named\r
  56     Makefile.msc.\r
  57 \r
  58 2.  The Groff build includes several scripts which generate auxiliary\r
  59     files used by groff (such as DESC, I, R, prologue, etc). \r
  60 \r
  61 \r
  62 Directories needed at runtime\r
  63 -----------------------------\r
  64 \r
  65 bin\r
  66 font\r
  67 tmac\r
  68 mm  (copied, including sub-directories, from contrib/mm)\r