* gpg.sgml: Document keyserver-option http-proxy, import-option
[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 Installation instructions:
11 --------------------------
12  1. Unpack the ZIP archive (alright, you already did this).
13  2. Copy "gpg.exe", "gpgv.exe" and "gpgkeys_ldap.exe" to a place
14     where you usually store your binaries.
15  3. Create a directory "c:\gnupg" (or any other as you like)
16  4. If you did not use the default directory "c:\gnupg", you
17     should enter a string with the directory into the Registry
18     under the key:
19          HKEY_CURRENT_USER -> Software -> GNU -> GnuPG
20     (you probably need to create the keys GNU and GnuPG) and insert a
21     new string under the name "HomeDir" with the value of the default
22     directory you want to use.  Please use forward slashes and not the
23     backslashes when setting filenames for GnuPG into the Registry.
24  5. Enter "gpg" and see what happens
25  6. Read the file README and the online HOWTOs
26
27
28 Internationalization support:
29 -----------------------------
30   1. Decide where to store the translation files for your language.
31      Here we assume the directory "c:/gnu/locale/fr"
32
33   2. Set the directory with the translations into the Registry under
34      the key:
35         HKEY_CURRENT_USER -> Control Panel -> Mingw32 -> NLS
36      (you probably need to create the keys Mingw32 and NLS) using a string
37      entry with the name "MoDir".
38   3. Select which language to use and copy the currect translation file
39      under the name "gnupg.mo" into the directory set in step 2
40      (Example:  "copy fr.mo c:\gnu\locale\fr\gnupg.mo")
41   4. Done.
42
43 Currently we only support the Codepages 437, 850 und Latin1.  If you have
44 problems, either delete the gnupg.mo file or don't set the environment
45 variable
46
47
48
49 How to build it from the source:
50 --------------------------------
51 This version has been build with the Mingw32/CPD kit using the latest
52 stable version of GnuPG.
53
54 First get the source: It has to be available at the same location you
55 found this binary package - if not you should have received a written
56 offer to get the source delivered to you See the file COPYING (section
57 3) for details.
58
59 If you got this package from its canonical place (ftp.gnupg.org), the
60 source is available at:
61
62   ftp://ftp.gnupg.org/gcrypt/gnupg/gnupg-1.2.n.tar.gz
63
64 or for development snapshots
65
66   ftp://ftp.gnupg.org/gcrypt/alpha/gnupg/gnupg-1.x.n.tar.gz
67
68 this is the same source as for the Unix version.  If your binary
69 version of GnuPG is called something like gnupg-w32-1.0.4-1.zip, you
70 should find a patch file named gnupg-w32-1.0.4-1.0.4-1.diff.gz at the
71 same location, which has to be applied to the stock gpg source file.
72 Instructions are at the top of this file.
73
74 To build it, you need the MingW32/CPD kit, which is available at
75
76   ftp://ftp.gnupg.org/people/werner/cpd/mingw32-cpd-0.3.2.tar.gz
77   ftp://ftp.gnupg.org/people/werner/cpd/gcc-core-2.95.2.tar.gz
78   ftp://ftp.gnupg.org/people/werner/cpd/binutils-2.9.1.tar.gz
79
80 gcc and binutils are stock GNU source which are available
81 at every GNU mirror. 
82
83 After you have installed this environment you should be able to do this:
84
85  $ scripts/autogen.sh --build-w32
86  $ make
87  $ mingw32 strip g10/gpg.exe
88  $ cp g10/gpg.exe  /some_windows_drive/
89
90 And everything hopefully works.  If there is a make problem in the
91 "po" directory you can eiterignore it or do a "touch po/all".  To
92 build the distribtion ZIP file, you have to create a directory
93 "dist-w32" and run "scripts/mk-w32-dist" right after a successul make
94 run.
95
96 Don't forget that MS-Windows ist just a temporary workaround until
97 you can switch to a GNU system ;-)
98
99 Be the source always with you.
100
101     Werner