This is gpg4win - the GUI Installer Builder for W32.

See also the file doc/README.en.txt.

Instructions:
=============

1. Download the source and binary packages that are required to build
   the installer:

   $ cd packages
   $ sh download.sh
   [...]
   $ cd ..

2. Configure the source tree for cross compilation:

   $ ./autogen.sh --build-w32

3. Build the installer:

   $ make

The installer will be made available in three files:

src/gpg4win-X.Y.Z.exe
src/gpg4win-light-X.Y.Z.exe
src/gpg4win-src-X.Y.Z.exe


Basic requirements
==================

A decent POSIX system is required for building this software as well
as GNU make.  We are using Debian GNU/Linux (Lenny); due to a little
bug in the mingw32 compiler it is highly suggested to put a line
  deb http://apt.intevation.org lenny/mingw .
into /etc/apt/sources and update the mingw packages.  To satisfy all
needs of configure at least the following packages need to be
installed:

 build-essential (libc6-dev, gcc, g++, make)
 automake, autoconf (if building from SVN)
 mingw32
 nsis
 stow
 unzip
 texinfo
 imagemagick
 tetex-bin
 tetex-extra
 latex-xcolor (for the compendium)
 tr
 gs-common
 hyperlatex
 sharutils (uudecode for claws icon patch)
 gettext (msgfmt, dcgettext, gmsgfmt, xgettext for glib)
 libglib2.0-dev (glib-genmarshal for glib)


Building the Webpages
=====================

This has not been automated.  See the README file in the doc/website
directory.  To build the HTML version of the manuals you need to go to
doc/manual-de, run the command "make webversion" and copy the require
files to the desired location.  If you are a developer with write
access to the Sibversion, you may use the "online" target to actually
update the website.

Development Branches
====================

The old version of gpg4win (version < 1.2) is since 1.1.3 tracked by
the SVN branch: branches/gpg4win-1-branch.  Only important fixes will
go into this version.  The current version is in the SVN trunk starts
as version 1.9 and will soon lead to version 2.0.



Adding new packages to the installer:
=====================================

This requires editing a couple of files; we might eventually automate
some of these tasks.  Here is a short run up:

1. Add constants for the package FOO into include/config.nsi.in .

2. Create 2 new installer scripts, named src/inst-foo.nsi and
   uninst-foo.nsi and add them to EXTRA_DIST in src/Makefile.am.

3. Add foo to one the variables gpg4win_bpgks (if foo should not be
   build be the gpg4win) or gpg4win_spkgs (if foo should be build by
   gpg4win) in src/Makefile.am .  Also add any required configure
   flags etc.

4. Add FOO to inst-sections.nsi.

5. Add detection of packages to configure.ac.  Check out the available
   macros in m4/gpg4win.m4.  Depending on the way an upstream package
   is packaged, you might need to write a new macro.

6. Add download information to packages/download.sh.

7. If the package ships pkg-config (*.pc) support files, you need add
   post install instructions to Makefile.am.  Note that *.pc files may
   be in the "runtime" directory ${pkgidir} if the package is built
   within gpg4win (or peculiarly shipped), or in the development
   package ${pkgidir_dev}.

Then run the usual "./autogen.sh" to create the actual configure file
and run configure as described above.


Version numbers
===============

We use a specific order of version numbers.  This is best shown by an
example:

  1.0.0             - The final 1.0.0 release. 
  1.0.1-svn1234     - A snapshot based on SVN revision 1234
  1.0.1-svn1235     - A newer snapshot
  1.0.1rc1-svn1236  - A snapshot while preparing for a release candidate
  1.0.1rc1          - The first release candidate for 1.0.1
  1.0.1-svn1240     - yet another snapshot
  1.0.1             - The final 1.0.1 release

The important point is that we bump up the version number before we do
an release and append a suffix to mark it as a development version.
This allows other software to use a configure check for the next to be
released version of gpg4win.



Copyright
=========

The entire Gpg4win package is

  Copyright (C) 2005, 2006, 2007, 2008, 2009 g10 Code GmbH
  
  GPG4Win is free software; you can redistribute it and/or modify it
  under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.
  
  GPG4Win is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  General Public License for more details.
  
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  02110-1301, USA


This file
=========

Copyright 2005, 2006, 2008 g10 Code GmbH

This file is free software; as a special exception the author gives
unlimited permission to copy and/or distribute it, with or without
modifications, as long as this notice is preserved.

This file is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.