README.WIN32

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