* gpg.sgml: Document new way of enabling the PKA functions. Some minor
[gnupg.git] / doc / README.W32
1 README.W32                                                -*- text -*-
2
3 This is a binary package with GnuPG for MS-Windows 95, 98, WNT, W2000
4 and XP. See the file README for generic instructions and usage hints.
5
6 A FAQ comes with this package and a probably more recent one can be
7 found online at http://www.gnupg.org/faq.html.  See
8 http://www.gnupg.org/docs-mls.html for a list of mailing lists. In
9 particular the list gnupg-users@gnupg.org might be useful to answer
10 questions - but please read the FAQ first.
11
12
13 Installation directory:
14 =======================
15
16 The installation directory of GnuPG is stored in the Registry under
17 the key HKEY_LOCAL_MACHINE\Software\GNU\GnuPG with the name "Install
18 Directory".  The installer does not change the PATH environment
19 variable to include this directory.  You might want to do this
20 manually.
21
22 Note, that this registry entry is also used to locate the keyserver
23 helper programs (e.g. gpgkeys_ldap).
24
25 Below the Installation directory, you will find directories named
26 "Doc", "gnupg.nls" and "Src".  The latter will be used for distributed
27 patched, if any, and to store the source file if they have been
28 included in this package.  The source files usually require further
29 unpacking using the TAR utility.
30
31
32 Internationalization support:
33 =============================
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".  This must
37 match one of the installed languages files in the directory named
38 "gnupg.nls" below the installation directory.  Note, that the ".mo"
39 extension is not part of the locale id.
40
41
42 Home directory:
43 ===============
44
45 GnuPG makes use of a per user home directory to store its keys as well
46 as configuration files.  The default home directory is a directory
47 named "gnupg" below the application data directory of the user.  This
48 directory will be created if it does not exist.  Being only a default,
49 it may be changed by setting the name of the home directory into the
50 Registry under the key HKEY_CURRENT_USER\Software\GNU\GnuPG using the
51 name "HomeDir".  If an environment variable "GNUPGHOME" exists, this
52 even overrides the registry setting.  The command line option
53 "--homedir" may be used to override all other settings of the home
54 directory.
55
56
57 Reporting bugs:
58 ===============
59
60 Please check the documentation first before asking or reporting a
61 bugs.  In particular check the archives of the mailing lists (see
62 www.gnupg.org) and the bug tracking system at http://bugs.gnupg.org
63 (login is "guest" password is "guest") whether the problem is already
64 known.  Asking on the gnupg-users mailing list is also strongly
65 encouraged; if you are not subscribed it may some time until a posting
66 is approved (this is an anti-spam measure). Bug reporting addresses
67 are listed in the file AUTHORS.
68
69 If you want to report a bug or have other problems, always give
70 detailed description of the problem, the version of GnuPG you used,
71 the version of the OS, whether it is the official version from
72 gnupg.org or how you built it.  Don't edit error messages - replacing
73 sensitive information like user IDs, fingerprints and keyids is okay.
74 If possible, switch to English messages by changing the "Lang" entry
75 to empty (see under Internationalization support).
76
77
78 How to build GnuPG from the source:
79 ===================================
80
81 Until recently all official GnuPG versions have been build using the
82 Mingw32/CPD kit as available at
83 ftp://ftp.gnupg.org/people/werner/cpd/mingw32-cqpd-0.3.2.tar.gz .
84 However, for maintenance reasons we switched to Debian's mingw32 cross
85 compiler package and that is now the recommended way of building GnuPG
86 for W32 platforms.  It might be possible to build it nativly on a W32
87 platform but this is not supported.  Please don't file any bug reports
88 if it does not build with any other system than the recommended one.
89
90 According to the conditions of the GNU General Public License you
91 either got the source files with this package, a written offer to send
92 you the source on demand or the source is available at the same site
93 you downloaded the binary package.  If you downloaded the package from
94 the official GnuPG site or one of its mirrors, the corresponding
95 source tarball is available in the sibling directory named gnupg.  The
96 source used to build all versions is always the same and the version
97 numbers should match.  If the version number of the binary package has
98 a letter suffix, you will find a patch file installed in the "Src"
99 directory with the changes relative to the generic version.
100
101 The source is distributed as a BZIP2 or GZIP compressed tar archive.
102 See the instructions in file README on how to check the integrity of
103 that file.  Wir a properly setup build environment, you unpack the
104 tarball change to the created directory and run
105
106  $ ./autogen.sh --build-w32
107  $ make
108  $ cp g10/gpg*.exe  /some_windows_drive/
109
110 Building a version with the installer is a bit more complex and
111 basically works by creating a top directory, unpacking in that top
112 directory, switching to the gnupg-1.x.y directory, running
113 "./autogen.sh --build-w32" and "make", switching back to the top
114 directory, running a "mkdir dist-w32; mkdir iconv", copying the
115 required iconv files (iconv.dll, README.iconv, COPYING.LIB) into the
116 iconv directory, running gnupg-1.x.y/scripts/mk-w32-dist and voila,
117 the installer package will be available in the dist-w32 directory.
118
119
120 Copying:
121 ========
122
123 GnuPG is
124
125   Copyright 1998, 1999, 2000, 2001, 2002, 2003, 2004, 
126             2005 Free Software Foundation, Inc.
127
128   GnuPG is free software; you can redistribute it and/or modify it
129   under the terms of the GNU General Public License as published by
130   the Free Software Foundation; either version 2 of the License, or
131   (at your option) any later version.
132
133   GnuPG is distributed in the hope that it will be useful, but WITHOUT
134   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
135   or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
136   License for more details.
137
138   You should have received a copy of the GNU General Public License
139   along with this program; if not, write to the Free Software
140   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
141   02110-1301, USA
142
143 See the files AUTHORS and THANKS for credits, further legal
144 information and bug reporting addresses pertaining to GnuPG.
145
146 For copying conditions of the GNU LIBICONV library see the file
147 README.iconv.
148   
149 The installer software used to create the official binary packages for
150 W32 is NSIS (http://nsis.sourceforge.net/):
151
152   Copyright (C) 1999-2005 Nullsoft, Inc.
153
154   This license applies to everything in the NSIS package, except where
155   otherwise noted.
156
157   This software is provided 'as-is', without any express or implied
158   warranty. In no event will the authors be held liable for any
159   damages arising from the use of this software.
160
161   Permission is granted to anyone to use this software for any
162   purpose, including commercial applications, and to alter it and
163   redistribute it freely, subject to the following restrictions:
164
165   1. The origin of this software must not be misrepresented; you must
166      not claim that you wrote the original software. If you use this
167      software in a product, an acknowledgment in the product
168      documentation would be appreciated but is not required.
169
170   2. Altered source versions must be plainly marked as such, and must
171      not be misrepresented as being the original software.
172
173   3. This notice may not be removed or altered from any source
174      distribution.
175
176 The user interface used with the installer is
177
178   Copyright (C) 2002-2005 Joost Verburg
179
180   [It is distributed along with NSIS and the same conditions as stated
181   above apply]
182
183
184 The term "W32" is used to describe the API used by current Microsoft
185 Windows versions.  We don't use the Microsft terminology here; in
186 hacker terminology, calling something a "win" is a form of praise.
187 Keep in mind that Windows ist just a temporary workaround until you
188 can switch to a complete Free Software system.  Be the source always
189 with you.