gerbv_open_image() can now take a zip archive as an argument.
[geda-gerbv/spe.git] / README-win32.txt
blob85170a7458f2cdbc5a2ee8abc7dda615c403b36e
1 $Id$
3  
4 Yes, gerbv runs on windows too!  To build from source, you need cygwin
5 and also the mingw compilers.  It builds as a native WIN32 application.
6 You may also use mingw instead of cygwin to build gerbv.
8 The configure script is set up to assume that you are using the native
9 win32 gtk libraries as opposed to the cygwin ones.  One method which
10 seems to work for building from source is:
12 - Go to http://www.gtk.org and follow links to gtk for win32.
14 - Download all of the runtime, developer, and source .zip, .tar.gz, and
15   .bz2  files for glib, atk, pango, gtk+, gettext, libiconv, pkg-config,
16   and the others there.  Save all of these files to ~/gtk_win32_downloads.
18 - In cygwin, 
20   cd /path/to/gerbv/sources
22   and run
24   ./win32/extract_gtk_win32.
26   This will extract all of the runtime files you need to
27   ~/gtk_win32_runtime and the developer files to ~/gtk_win32.
30 - In cygwin,
32   ./win32/build_gerbv
35   This script is a wrapper on top of the normal configure script
36   and has all of the correct options to get gerbv to build under
37   cygwin/mingw.
39   ./win32/build_gerbv --help
41   will give a complete list of options for build_gerbv
44 If you have the normal cygwin and cygwin for X gtk libraries installed
45 you will have problems.  It is related to libtool changing things like
46 -L/path/to/nativewin32gtk -lgtk to /usr/lib/libgtk-2.0.a.  Watch when
47 gerbv.exe in src/ is actually linked and you'll see it happen.
48 An ugly work around is to just modify the Makefile to not use libtool
49 for linking or to run the link command by hand.  But that is ugly.
50 Anyone with a real fix?  I worked around this by not installing the
51 X gtk libraries on my cygwin installation.
53 Binary Version:
54 ---------------
55 The installer was created using NSIS (http://nsis.sourceforge.net).
57 The gerbv.nsi file in the win32 directory was used to build the
58 installer.  Note, gerbv.nsi is actually created from gerbv.nsi.in
59 by build_gerbv in the win32 directory.