README.MSYS.md
1# MSYS Fallback Makefile
2
3This is a simple, straightforward Makefile for building LibGD with
4MinGW on MSYS (or possibly Cygwin). It is here for anyone who doesn't
5want to deal with autotools or CMake on Windows or who can't get
6either of them working on their particular setup.
7
8Note that this Makefile only builds the library and test cases; the
9standalone utilities are ignored. If you need those, you'll need to
10use one of the other build systems (or add them yourself.)
11
12## To build LibGD:
13
141. Install MinGW and MSYS (see <http://www.mingw.org/wiki/Getting_Started>).
15 You will need to install zip and unzip as well as the 32-bit C compiler
16 and related tools.
17
182. Install LibJpeg, LibPng, LibTiff, Zlib and FreeType from
19 <http://gnuwin32.sourceforge.net> and install them all in
20 `c:/tools/GnuWin32/`. (You can get these libraries from other
21 places and/or install them in different locations, but you'll need to
22 edit the Makefile accordingly if you do.)
23
243. Skip ahead to the next step. If that doesn't work, edit the
25 Makefile to fix what went wrong. Things to try include:
26 * Ensure SRC contains an up-to-date list of source files. (Take a
27 look at libgd_la_SOURCES src/Makefile.am for a reference.)
28 * Ensure that the paths and #defines for unsupported libraries
29 are commented out. They're nicely grouped into clusters to
30 simplify that.
31
324. `cd` to this directory and type:
33
34 make
35 make check
36
37 If both commands succeed, you're done. (Note that some of the
38 testcases will fail, just because they test features not enabled
39 here. This is fine. As long as most tests pass, you're probably
40 okay.)
41
425. Type
43
44 make dist
45
46 This will create libgd-win.zip, a zip file containing the new
47 library and its dependants. Note that this step may pick up extra
48 DLLs; it sweeps up all of the DLLs in the directories pointed to
49 by *_DLLDIR Makefile variables.
50
51 Before type "make dist", please make sure you have installed
52 zip command in msys. Or you can try:
53 * If you use msys, you can install msys-zip(lib, docs, lic)
54 in MinGW Installation Manager/all package.
55 * If you use msys2, you can install msys/zip by pacman and running:
56
57 pacman -S msys/zip
58
59 Alternately, you can copy the lib (in src/) to wherever it needs
60 to go.
61
62
63## Stuff that Doesn't Work
64
65* LibXpm: It's probably nothing serious, just more trouble than it's
66 worth.
67* LibFontconfig: I couldn't find Windows binaries for it anywhere
68 reputable.
69