c3359e9a89a89f41fcef526764fdf4191409ce26
[gnupg.git] / README
1                    The GNU Privacy Guard 2
2                   =========================
3                        Version 1.9.x
4
5
6 GnuPG 1.9 is the future version of GnuPG; it is based on some gnupg-1.3
7 code and the previous newpg package.  It will eventually lead to a
8 GnuPG 2.0 release.  
9
10 You should use this GnuPG version if you want to use the gpg-agent or
11 gpgsm (the S/MIME variant of gpg).  Note that the gpg-agent is also
12 helpful when using the standard gpg versions (1.4.x) the old 1.2.x).
13 There are no problems installing 1.4 and 1.9 alongside; in fact we
14 suggest to do this.
15
16
17 BUILD INSTRUCTIONS
18 ==================
19
20 GnuPG 1.9 depends on the following packages:
21
22   libgpg-error (ftp://ftp.gnupg.org/gcrypt/libgpg-error/)
23   libgcrypt    (ftp://ftp.gnupg.org/gcrypt/libgcrypt/)
24   libksba      (ftp://ftp.gnupg.org/gcrypt/libksba/)
25   libassuan    (ftp://ftp.gnupg.org/gcrypt/alpha/libassuan/)
26   
27 You also need the pinentry package for most function of GnuPG; however
28 it is not a build requirement.  pinentry is available at
29 ftp://ftp.gnupg.org/gcrypt/pinentry/ .
30
31 You should get the latest versions of course, the GnuPG configure
32 script complains if a version is not sufficient.
33
34 After building and installing the above packages in the order as given
35 above, you may now continue with GnuPG installation (you may also just
36 try to build GnuPG to see whether your already installed versions are
37 sufficient).
38
39 As with all packages, you just have to do
40
41  ./configure
42  make
43  make install
44
45 (Before doing install you might need to become root.)
46
47 If everything succeeds, you have a working GnuPG with support for
48 S/MIME and smartcards.  Note that there is no binary gpg but a gpg2 so
49 that this package won't conflict with a GnuPG 1.4 installation. gpg2
50 behaves just like gpg.
51
52 In case of problem please ask on gnupg-users@gnupg.org for advise.  Note
53 that this release is only expected to build on GNU and *BSD systems.
54
55
56
57 DOCUMENTATION
58 ==================
59
60 The complete documentation is in the texinfo manual named
61 `gnupg.info'.  Run "info gnupg" to read it.  If you want a a printable
62 copy of the manual, change to the "doc" directory and enter "make
63 gnupg.pdf".  For a HTML version enter "make gnupg.html" and point your
64 browser to gnupg.html/index.html.  Standard man pages for all
65 components are provided as well.
66