Added a bit of docstring

2 files changed, 7 insertions, 0 deletions

diff --git a/rsa/__init__.py b/rsa/__init__.py
index 2680171..b66fe37 100755
--- a/rsa/__init__.py
+++ b/rsa/__init__.py
@@ -7,6 +7,9 @@ WARNING: this implementation does not use random padding, compression of the
 cleartext input to prevent repetitions, or other common security improvements.
 Use with care.
 
+If you want to have a more secure implementation, use the functions from the
+``rsa.pkcs1`` module.
+
 """
 
 __author__ = "Sybren Stuvel, Marloes de Boer, Ivo Tamboer, and Barry Mead"
diff --git a/rsa/pkcs1.py b/rsa/pkcs1.py
index 58aa312..d84c24c 100644
--- a/rsa/pkcs1.py
+++ b/rsa/pkcs1.py
@@ -3,12 +3,16 @@
 This module implements certain functionality from PKCS1 version 1.5. For a
 very clear example, read http://www.di-mgt.com.au/rsa_alg.html#pkcs1schemes
 
+At least 8 bytes of random padding is used when encrypting a message. This makes
+these methods much more secure than the ones in the ``rsa`` module.
+
 '''
 
 import os
 
 from rsa import common, transform, core
 
+
 def _pad_for_encryption(message, target_length):
     r'''Pads the message for encryption, returning the padded message.