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