Changed license of this parser to LPGL.
[gnupg.git] / README
diff --git a/README b/README
index 8027b69..28637c1 100644 (file)
--- a/README
+++ b/README
@@ -3,15 +3,17 @@
                        Version 1.9.x
 
 
-GnuPG 1.9 is the future version of GnuPG; it is based on the gnupg-1.3
+GnuPG 1.9 is the future version of GnuPG; it is based on some gnupg-1.3
 code and the previous newpg package.  It will eventually lead to a
-GnuPG 2.0 release.  Note that GnuPG 1.3 and 1.9 are not always in sync
-and thus features and bug fixes done in 1.3 are not necessary
+GnuPG 2.0 release.  Note that GnuPG 1.4 and 1.9 are not always in sync
+and thus features and bug fixes done in 1.4 are not necessary
 available in 1.9.
 
 You should use this GnuPG version if you want to use the gpg-agent or
 gpgsm (the S/MIME variant of gpg).  Note that the gpg-agent is also
-helpful when using the standard gpg versions (1.2.x or 1.3.x).
+helpful when using the standard gpg versions (1.4.x as well as some of
+the old 1.2.x).  There are no problems installing 1.4 and 1.9
+alongside; in act we suggest to do this.
 
 
 BUILD INSTRUCTIONS
@@ -19,8 +21,8 @@ BUILD INSTRUCTIONS
 
 GnuPG 1.9 depends on the following packages:
 
-  libgpg-error (ftp://ftp.gnupg.org/gcrypt/alpha/libgpg-error/)
-  libgcrypt    (ftp://ftp.gnupg.org/gcrypt/alpha/libgcrypt/)
+  libgpg-error (ftp://ftp.gnupg.org/gcrypt/libgpg-error/)
+  libgcrypt    (ftp://ftp.gnupg.org/gcrypt/libgcrypt/)
   libassuan    (ftp://ftp.gnupg.org/gcrypt/alpha/libassuan/)
   libksba      (ftp://ftp.gnupg.org/gcrypt/alpha/libksba/)
   
@@ -51,7 +53,7 @@ If everything succeeds, you have a working GnuPG with support for
 S/MIME and smartcards.  Note that there is no binary gpg but a gpg2 so
 that this package won't confict with a GnuPG 1.2 or 1.3
 installation. gpg2 behaves just like gpg; it is however suggested to
-keep using gpg 1.2.x or 1.3.x.
+keep using gpg 1.2.x or 1.3.x. gpg2 is not even build by default.
 
 In case of problem please ask on gpa-dev@gnupg.org for advise.  Note
 that this release is only expected to build on GNU and *BSD systems.
@@ -63,6 +65,9 @@ and options given below.  See also the section `SMARTCARD INTRO'.
 COMMANDS
 ========
 
+See the info documentation ("info gnupg") for a full list of commands
+and options.
+
 gpgsm:
 ------
 
@@ -78,25 +83,6 @@ gpgsm:
    prepended before each block.
 
 
-gpg2: (Note that these card commands are also available with gpg 1.3.x)
------
-
---card-status
-
-   Show information pertaining smartcards implementing the OpenPGP
-   application.
-
---change-pin
-
-   Offers a menu to change the PIN of OpenPGP smartcards and to reset
-   the retry counters.
-
---card-edit
-
-   Offers a menu to change any data object on the card and to generate
-   the keys. 
-
-
 OPTIONS
 =======
 
@@ -399,7 +385,7 @@ modes for gpgsm, here is the entire list of ways to specify a key:
 
        +Heinrich Heine duesseldorf
 
- * [NEW] Exact match by subject's DN
+ * Exact match by subject's DN
 
    This is indicated by a leading slash, directly followed by the
    rfc2253 encoded DN of the subject.  Note that you can't use the
@@ -411,7 +397,7 @@ modes for gpgsm, here is the entire list of ways to specify a key:
 
       /CN=Heinrich Heine,O=Poets,L=Paris,C=FR
 
- * [NEW] Excact match by issuer's DN
+ * Excact match by issuer's DN
 
    This is indicated by a leading hash mark, directly followed by a
    slash and then directly followed by the rfc2253 encoded DN of the
@@ -422,10 +408,10 @@ modes for gpgsm, here is the entire list of ways to specify a key:
 
       #/CN=Root Cert,O=Poets,L=Paris,C=FR
 
- * [NEW] Exact match by serial number and subject's DN
+ * Exact match by serial number and issuer's DN
 
    This is indicated by a hash mark, followed by the hexadecmal
-   representation of the serial number, the followed by a slahs and
+   representation of the serial number, the followed by a slash and
    the RFC2253 encoded DN of the issuer. See note above.
 
    Example:
@@ -470,19 +456,17 @@ This requires that the gpg-agent is running.
 HOW TO EXPORT A PRIVATE KEY
 ===========================
 There is also limited support to export a private key in PKCS-12
-format. However the certificate is not stored and there is no MAC applied.
+format. However there is no MAC applied.
 
- gpgsm --call-protect-tool --p12-export  foo.key  >foo.p12
+ gpgsm --export-secret-key-p12 userID  >foo.p12
 
 
 SMARTCARD INTRO
 ===============
 
 GPG, the OpenPGP part of GnuPG, supports the OpenPGP smartcard
-(surprise!); see http://g10code.com/p-card.html.
-
-[Fixme: We need to explain this further]
-
+(surprise!); see http://g10code.com/p-card.html and
+http://www.gnupg.org/documentation/howtos.html#GnuPG-cardHOWTO .
 
 GPGSM, the CMS (S/MIME) part of GnuPG, supports two kinds of
 smartcards.  The most flexible way is to use PKCS#15 compliant cards,
@@ -511,8 +495,6 @@ For selecting the driver, see the options of scdaemon.  A useful
 debugging flag is "--debug 2048" showing the communication between
 scdaemon and the reader.
 
-[fixme: write more stuff]
-