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 Build everything by typing:
  36
  37     nmake -f Makefile.msc
  38
  39 You are done.
  40
  41 The bin directory contains some .cmd files to help show how to run
  42 stuff.  Since Windows 95/98 doesn't understand .cmd files, if you are
  43 operating under that OS you'll have to rename them to .bat files.
  44 .bat files do have output redirection problems.
  45
  46
  47 The changes I made fall into two categories.
  48
  49 1.  Makefiles.  Several makefiles were added.  All makefiles were named
  50     Makefile.msc.
  51
  52 2.  The Groff build includes several scripts which generate auxiliary
  53     files used by groff (such as DESC, I, R, prologue, etc).
  54
  55
  56 Directories needed at runtime
  57 -----------------------------
  58
  59 bin
  60 font
  61 tmac
  62 mm  (copied, including sub-directories, from contrib/mm)