mirror of
git://git.gnupg.org/gnupg.git
synced 2024-10-31 20:08:43 +01:00
This commit was manufactured by cvs2svn to create branch
'GNUPG-1-9-BRANCH'.
This commit is contained in:
parent
5ba1e5cfb7
commit
bbe6101177
186
doc/README.W32
Normal file
186
doc/README.W32
Normal file
@ -0,0 +1,186 @@
|
||||
README.W32 -*- text -*-
|
||||
|
||||
This is a binary package with GnuPG for MS-Windows 95, 98, WNT, W2000
|
||||
and XP. See the file README for generic instructions and usage hints.
|
||||
|
||||
A FAQ comes with this package and a probably more recent one can be
|
||||
found online at http://www.gnupg.org/faq.html. See
|
||||
http://www.gnupg.org/docs-mls.html for a list of mailing lists. In
|
||||
particular the list gnupg-users@gnupg.org might be useful to answer
|
||||
questions - but please read the FAQ first.
|
||||
|
||||
|
||||
Installation directory:
|
||||
=======================
|
||||
|
||||
The installation directory of GnuPG is stored in the Registry under
|
||||
the key HKEY_LOCAL_MACHINE\Software\GNU\GnuPG with the name "Install
|
||||
Directory". The installer does not change the PATH environment
|
||||
variable to include this directory. You might want to do this
|
||||
manually.
|
||||
|
||||
Below the Installation directory, you will find directories named
|
||||
"Doc", "gnupg.nls" and "Src". The latter will be used for distributed
|
||||
patched, if any, and to store the source file if they have been
|
||||
included in this package. The source files usually require further
|
||||
unpacking using a the TAR utility.
|
||||
|
||||
|
||||
Internationalization support:
|
||||
=============================
|
||||
|
||||
Store the locale id (like "de") into the Registry under the key
|
||||
HKEY_CURRENT_USER\Software\GNU\GnuPG with the name "Lang". This must
|
||||
match one of the installed languages files in the directory named
|
||||
"gnupg.nls" below the installation directory. Note, that the ".mo"
|
||||
extension is not part of the lcoale id.
|
||||
|
||||
|
||||
Home directory:
|
||||
===============
|
||||
|
||||
GnuPG makes use of a per user home directory to store its keys as well
|
||||
as configuration files. The default home directory is a directory
|
||||
named "gnupg" below the application data directory of the user. This
|
||||
directory will be created if it does not exist. Being only a default,
|
||||
it may be changed by setting the name of the home directory into the
|
||||
Registry under the key HKEY_CURRENT_USER\Software\GNU\GnuPG using the
|
||||
name "HomeDir". If an environment varaibale "GNUPGHOME" exists, this
|
||||
even overrides the registry setting. The command line option
|
||||
"--homedir" may be used to override all other settings of the home
|
||||
directory.
|
||||
|
||||
|
||||
Reporting bugs:
|
||||
===============
|
||||
|
||||
Please check the documentation first before asking or reporting a
|
||||
bugs. In particular check the archives of the mailing lists (see
|
||||
www.gnupg.org) and the bug tracking system at http://bugs.gnupg.org
|
||||
(login is "guest" password is "guest") whether the problem is already
|
||||
known. Asking on the gnupg-users mailing list is also strongly
|
||||
encouraged; if you are not subscribed it may some time until a posting
|
||||
is approved (this is an anti-spam measure). Bug reporting addresses
|
||||
are listed in the file AUTHORS.
|
||||
|
||||
If you want to report a bug or have other problems, always give
|
||||
detailed description of the problem, the version of GnuPG you used,
|
||||
the version of the OS, whether it is the official version from
|
||||
gnupg.org or how you built it. Don't edit error messages - replacing
|
||||
sensitive information like user IDs, fingerprints and keyids is okay.
|
||||
If possible, switch to English messages by changing the "Lang" entry
|
||||
to empty (see under Internationalization support).
|
||||
|
||||
|
||||
How to build GnuPG from the source:
|
||||
===================================
|
||||
|
||||
Until recently all official GnuPG versions have been build using the
|
||||
Mingw32/CPD kit as available at
|
||||
ftp://ftp.gnupg.org/people/werner/cpd/mingw32-cqpd-0.3.2.tar.gz .
|
||||
However, for maintenance reasons we switched to Debian's mingw32 cross
|
||||
compiler package and that is now the recommended way of building GnuPG
|
||||
for W32 platforms. It might be possible to build it nativly on a W32
|
||||
platform but this is not supported. Please don't file any bug reports
|
||||
if it does not build with any other system than the recommended one.
|
||||
|
||||
According to the conditions of the GNU General Public License you
|
||||
either got the source files with this package, a written offer to send
|
||||
you the source on demand or the source is available at the same site
|
||||
you downloaded the binary package. If you downloaded the package from
|
||||
the official GnuPG site or one of its mirrors, the corresponding
|
||||
source tarball is available in the sibling directory named gnupg. The
|
||||
source used to build all versions is always the same and the version
|
||||
numbers should match. If the version number of the binary package has
|
||||
a letter suffix, you will find a patch file installed in the "Src"
|
||||
directory with the changes relative to the generic version.
|
||||
|
||||
The source is distributed as a BZIP2 or GZIP compressed tar archive.
|
||||
See the instructions in file README on how to check the integrity of
|
||||
that file. Wir a properly setup build environment, you unpack the
|
||||
tarball change to the created directory and run
|
||||
|
||||
$ ./autogen.sh --build-w32
|
||||
$ make
|
||||
$ cp g10/gpg*.exe /some_windows_drive/
|
||||
|
||||
Building a version with the installer is a bit more complex and
|
||||
basically works by creating a top directory, unpacking in that top
|
||||
directory, switching to the gnupg-1.x.y directory, running
|
||||
"./autogen.sh --build-w32" and "make", switching back to the top
|
||||
directory, running a "mkdir dist-w32; mkdir iconv", copying the
|
||||
required iconv files (iconv.dll, README.iconv, COPYING.LIB) into the
|
||||
iconv directory, running gnupg-1.x.y/scripts/mk-w32-dist and voila,
|
||||
the installer package will be available in the dist-w32 directory.
|
||||
|
||||
|
||||
Copying:
|
||||
========
|
||||
|
||||
GnuPG is
|
||||
|
||||
Copyright 1998, 1999, 2000, 2001, 2002, 2003, 2004,
|
||||
2005 Free Software Foundation, Inc.
|
||||
|
||||
GnuPG 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.
|
||||
|
||||
GnuPG 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., 59 Temple Place - Suite 330, Boston, MA
|
||||
02111-1307, USA
|
||||
|
||||
See the files AUTHORS and THANKS for credits, further legal
|
||||
information and bug reporting addresses pertaining to GnuPG.
|
||||
|
||||
For copying conditions of the GNU LIBICONV library see the file
|
||||
README.iconv.
|
||||
|
||||
The installer software used to create the official binary packages for
|
||||
W32 is NSIS (http://nsis.sourceforge.net/):
|
||||
|
||||
Copyright (C) 1999-2005 Nullsoft, Inc.
|
||||
|
||||
This license applies to everything in the NSIS package, except where
|
||||
otherwise noted.
|
||||
|
||||
This software is provided 'as-is', without any express or implied
|
||||
warranty. In no event will the authors be held liable for any
|
||||
damages arising from the use of this software.
|
||||
|
||||
Permission is granted to anyone to use this software for any
|
||||
purpose, including commercial applications, and to alter it and
|
||||
redistribute it freely, subject to the following restrictions:
|
||||
|
||||
1. The origin of this software must not be misrepresented; you must
|
||||
not claim that you wrote the original software. If you use this
|
||||
software in a product, an acknowledgment in the product
|
||||
documentation would be appreciated but is not required.
|
||||
|
||||
2. Altered source versions must be plainly marked as such, and must
|
||||
not be misrepresented as being the original software.
|
||||
|
||||
3. This notice may not be removed or altered from any source
|
||||
distribution.
|
||||
|
||||
The user interface used with the installer is
|
||||
|
||||
Copyright (C) 2002-2005 Joost Verburg
|
||||
|
||||
[It is distributed along with NSIS and the same conditions as stated
|
||||
above apply]
|
||||
|
||||
|
||||
The term "W32" is used to describe the API used by current Microsoft
|
||||
Windows versions. We don't use the Microsft terminology here; in
|
||||
hacker terminology, calling something a "win" is a form of praise.
|
||||
Keep in mind that Windows ist just a temporary workaround until you
|
||||
can switch to a complete Free Software system. Be the source always
|
||||
with you.
|
Loading…
Reference in New Issue
Block a user