updated docs

Author: myheroyuki

doc/compatibility.rst

@@ -5,9 +5,10 @@ Compatibility with standards
 .. index:: compatibility
 
 Python-RSA implements encryption and signatures according to PKCS#1
-version 1.5. This makes it compatible with the OpenSSL RSA module.
+version 1.5. Additionally, Python-RSA implements multiprime encryption according to PKCS#1
+version 2.1. This makes it largely compatible with the OpenSSL RSA module.
 
-Keys are stored in PEM or DER format according to PKCS#1 v1.5. Private
+Keys are stored in PEM or DER format according to PKCS#1 v2.1. Private
 keys are compatible with OpenSSL. However, OpenSSL uses X.509 for its
 public keys, which are not supported.
 

doc/index.rst

@@ -8,7 +8,8 @@ Welcome to Python-RSA's documentation!
 
 Python-RSA is a pure-Python RSA implementation. It supports
 encryption and decryption, signing and verifying signatures, and key
-generation according to PKCS#1 version 1.5.
+generation according to PKCS#1 version 1.5. Additionally, Python-RSA 
+implements multirime encryption according to PKCS#1 version 2.1.
 
 If you have the time and skill to improve the implementation, by all
 means be my guest. The best way is to clone the `Git

doc/usage.rst

@@ -40,6 +40,11 @@ Alternatively you can use :py:meth:`rsa.PrivateKey.load_pkcs1` and
     ...     keydata = privatefile.read()
     >>> privkey = rsa.PrivateKey.load_pkcs1(keydata)
 
+PKCS#1 v2.1 allows you to generate RSA keys with multiple primes:
+
+    >>> import rsa
+    >>> (pubkey, privkey) = rsa.newkeys(512, nprimes=3)
+
 
 Time to generate a key
 ++++++++++++++++++++++