A bunch of changes to support gnupg2 - not yet ready but it should not
[gpg4win.git] / README
1 This is gpg4win - the GUI Installer Builder for W32.
2
3
4 Instructions:
5 =============
6
7 1. Download the source and binary packages that are required to build
8    the installer:
9
10    $ cd packages
11    $ sh download.sh
12    [...]
13    $ cd ..
14
15    If you have downloaded gnupg-2.x, you need to repack it so that the
16    name of the apckage is gnupg2. For example:
17    
18     tar xjf gnupg-2.0.5.tar.bz2 
19     mv gnupg-2.0.5 gnupg2-2.0.5
20     tar chf gnupg2-2.0.5.tar.bz2 gnupg2-2.0.5
21
22
23 2. Configure the source tree for cross compilation:
24
25    $ configure --host=i586-mingw32msvc
26
27 3. Build the installer:
28
29    $ make
30
31 The installer will be made available in two files:
32
33 src/gpg4win-X.Y.Z.exe
34 src/gpg4win-src-X.Y.Z.exe
35
36
37 Basic requirements
38 ==================
39
40 A decent POSIX system is required for building this software as well
41 as GNU make.  We are using Debian GNU/Linux (Sid), however it should
42 work with current Testing (as of Februar 2006) too.  It might work with
43 Sarge - this has not been tested.  To satisfy all needs of configure
44 at least the following packages need to be installed:
45
46  mingw32
47  nsis
48  stow
49  unzip
50  texinfo
51  imagemagick
52  tetex-bin
53  tetex-extra
54  gs-common
55  hyperlatex
56
57
58 Building the Webpages
59 =====================
60
61 This has not been automated.  See the README file in the doc/website
62 directory.  To build the HTML version of the manuals you need to go to
63 doc/manual-de, run the command "make webversion" and copy the require
64 files to the desired location.  If you are a developer with write
65 access to the Sibversion, you may use the "online" target to actually
66 update the website.
67
68
69 Adding new packages to the installer:
70 =====================================
71
72 This requires editing a couple of files; we might eventually automate
73 some of these tasks.  Here is a short run up:
74
75 1. Add constants for the package FOO into include/config.nsi.in .
76
77 2. Create 2 new installer scripts, named src/inst-foo.nsi and
78    uninst-foo.nsi .
79
80 3. Add foo to one the variables gpg4win_bpgks (if foo should not be
81    build be the gpg4win) or gpg4win_spkgs (if foo should be build by
82    gpg4win) in src/Makefile.am
83
84 4. Add FOO to inst-sections.nsi.
85
86 5. Add detection of packages to configure.ac.  Check out the available
87    macros in m4/gpg4win.m4.  Depending on the way an upstream package
88    is packaged, you might need to write a new macro.
89
90 6. Add download information to packages/download.sh.
91
92 Then run the usual "./autogen.sh" to create the actual configure file
93 and run configure as described above.
94
95
96 Copyright
97 =========
98
99 The entire Gpg4win package is
100
101   Copyright (C) 2005, 2006, 2007 g10 Code GmbH
102   
103   GPG4Win is free software; you can redistribute it and/or modify it
104   under the terms of the GNU General Public License as published by
105   the Free Software Foundation; either version 2 of the License, or
106   (at your option) any later version.
107   
108   GPG4Win is distributed in the hope that it will be useful, but
109   WITHOUT ANY WARRANTY; without even the implied warranty of
110   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
111   General Public License for more details.
112   
113   You should have received a copy of the GNU General Public License
114   along with this program; if not, write to the Free Software
115   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
116   02110-1301, USA
117
118
119 This file
120 =========
121
122 Copyright 2005, 2006 g10 Code GmbH
123
124 This file is free software; as a special exception the author gives
125 unlimited permission to copy and/or distribute it, with or without
126 modifications, as long as this notice is preserved.
127
128 This file is distributed in the hope that it will be useful, but
129 WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
130 implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
131 PURPOSE.