summaryrefslogtreecommitdiff
path: root/README.WIN32
blob: 478d13a1fe0dcd9ea9653f7c95d617209764b737 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

WIN32 port of GROFF and friends done by Blake McBride
(blake@florida-software.com) 4/14/00.

This port differs from other ports in that it uses the Microsoft
compiler.  The changes were done such that they only have effect on
the code when compiled with the Microsoft compiler.

Note that not all preprocessors and output devices have been ported;
missing are grohtml, grolbp, grn, refer, soelim, and groff.  Besides
these programs, no utility program has been ported.  Of course,
gxditview (which only runs on the X Window System, the standard Unix
GUI) is missing also.


The following programs were used, running on Windows NT 4.0:

  Microsoft Visual C++ 6.0
  Unix utilities under NT (gzip, tar, patch)


Build Instructions
------------------

. Unpack groff (using gzip & tar) as follows:

    cd \
    gzip -dc groff-1.16.tar.gz | tar xvf -

. Now apply the patch file `win32-diffs':

    cd \groff-1.16
    patch -p1 < win32-diffs

  Note that with older versions of `patch', you will get a lot of
  *.orig files (most of them are empty) which can be safely deleted.

. Edit the file `src/include/defs.h' and adapt the path names to
  your needs.

. Build everything by typing:

    nmake -f Makefile.msc

You are done.

The `bin' directory contains some .cmd files to help show how to run
stuff.  Since Windows 95/98 doesn't understand .cmd files, if you are
operating under that OS, you'll have to rename them to .bat files. 
.bat files do have output redirection problems.


The changes I made fall into two categories.

1.  Makefiles.  Several makefiles were added.  All makefiles were named
    Makefile.msc.

2.  The Groff build includes several scripts which generate auxiliary
    files used by groff (such as DESC, I, R, prologue, etc). 


Directories needed at runtime
-----------------------------

bin
font
tmac
mm  (copied, including sub-directories, from contrib/mm)