Fixed card removal problems
[gnupg.git] / doc / README.W32
index 18f745d..6417e90 100644 (file)
-README.W32                                                -*- text -*-
+                         README.W32 
+                        ============
+                         2004-12-22
 
-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.
+  This is a precompiled version of gnupg 1.9.14 for MS Windows.
+  Please see the manual (gnupg.pdf) for the current limitations.  Be
+  aware that this is the first released version and thus bugs are
+  pretty likely.
 
-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.
+  Please copy all files to the directory c:\gnupg and follow the
+  manual instructions.
   
-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.
+  This software has been build using Debian's mingw package, version
+  3.3.1.20030804.1-1.  Libraries are all compiled statically, versions
+  of the used libraries are:
+  
+   gpg-error-config: 1.1-cvs
+   libgcrypt-config: 1.2.1-cvs
+   ksba-config: 0.9.11-cvs
+   libassuan-config: 0.6.9-cvs
+  
+  as these are all CVS versions you need to get the from the CVS.  See
+  www.gnupg.org for details.  Use 2004-12-22 18:00 UTC as revision
+  date.  The source code of GnuPG itsself is available at
+  ftp://ftp.gnupg.org/gcrypt/alpha/gnupg/gnupg-1.9.14.tar.bz2
+  ftp://ftp.gnupg.org/gcrypt/alpha/gnupg/gnupg-1.9.14.tar.bz2.sig
+  
+  Building has been done by running the command
+  
+   ./autogen.sh --build-w32
+  
+  for all these libraries and then for gnupg.  The PDF file has been
+  produced by first converting the logo file to pdf and the running
+  "make gnupg.pdf" in the doc directory.  All executables have been
+  stripped.
+  
+  In case of questions please contact us at info@g10code.com or better
+  write to the mailing list gnupg-devel@gnupg.org.
+  
+  Thanks,
+  
+    The g10 Code team