* gpgv.c (tty_fprintf): New stub.
[gnupg.git] / doc / README.W32
1 This is a binary version of GnuPG for MS-Windows 95, 98, WNT, W2000
2 and XP.
3
4 A FAQ comes with this package and a probably more recent one can be
5 found online at http://www.gnupg.org/faq.html.  See
6 http://www.gnupg.org/docs-mls.html for a list of mailing lists. In
7 particular the list gnupg-users@gnupg.org might be useful to answer
8 questions - but please read the FAQ first.
9
10 Note: Due to the use of the NSIS installer, the information below are
11 mostly out of date.
12
13 Installation instructions:
14 --------------------------
15  1. Unpack the ZIP archive (alright, you already did this).
16  2. Copy "gpg.exe", "gpgv.exe" and "gpgkeys_ldap.exe" to a place
17     where you usually store your binaries.
18  3. Create a directory "c:\gnupg" (or any other as you like)
19  4. If you did not use the default directory "c:\gnupg", you
20     should enter a string with the directory into the Registry
21     under the key:
22          HKEY_CURRENT_USER -> Software -> GNU -> GnuPG
23     (you probably need to create the keys GNU and GnuPG) and insert a
24     new string under the name "HomeDir" with the value of the default
25     directory you want to use.  Please use forward slashes and not the
26     backslashes when setting filenames for GnuPG into the Registry.
27  5. Enter "gpg" and see what happens
28  6. Read the file README and the online HOWTOs
29
30
31 Internationalization support:
32 -----------------------------
33  1
34
35 Store the locale id (like "de") into the registry under the key
36 HKEY_CURRENT_USER\Software\GNU\GnuPG with the name "Lang".
37
38
39 How to build it from the source:
40 --------------------------------
41 This version has been build with the Mingw32/CPD kit using the latest
42 stable version of GnuPG.
43
44 First get the source: It has to be available at the same location you
45 found this binary package - if not you should have received a written
46 offer to get the source delivered to you See the file COPYING (section
47 3) for details.
48
49 If you got this package from its canonical place (ftp.gnupg.org), the
50 source is available at:
51
52   ftp://ftp.gnupg.org/gcrypt/gnupg/gnupg-1.2.n.tar.gz
53
54 or for development snapshots
55
56   ftp://ftp.gnupg.org/gcrypt/alpha/gnupg/gnupg-1.x.n.tar.gz
57
58 this is the same source as for the Unix version.  If your binary
59 version of GnuPG is called something like gnupg-w32-1.0.4-1.zip, you
60 should find a patch file named gnupg-w32-1.0.4-1.0.4-1.diff.gz at the
61 same location, which has to be applied to the stock gpg source file.
62 Instructions are at the top of this file.
63
64 To build it, you need the MingW32/CPD kit, which is available at
65
66   ftp://ftp.gnupg.org/people/werner/cpd/mingw32-cpd-0.3.2.tar.gz
67   ftp://ftp.gnupg.org/people/werner/cpd/gcc-core-2.95.2.tar.gz
68   ftp://ftp.gnupg.org/people/werner/cpd/binutils-2.9.1.tar.gz
69
70 gcc and binutils are stock GNU source which are available
71 at every GNU mirror. 
72
73 After you have installed this environment you should be able to do this:
74
75  $ scripts/autogen.sh --build-w32
76  $ make
77  $ mingw32 strip g10/gpg.exe
78  $ cp g10/gpg.exe  /some_windows_drive/
79
80 And everything hopefully works.  If there is a make problem in the
81 "po" directory you can eiterignore it or do a "touch po/all".  To
82 build the distribtion ZIP file, you have to create a directory
83 "dist-w32" and run "scripts/mk-w32-dist" right after a successul make
84 run.
85
86 Don't forget that MS-Windows ist just a temporary workaround until
87 you can switch to a GNU system ;-)
88
89 Be the source always with you.
90
91     Werner