More documentation

sybrenstuvel · sybrenstuvel · commit aa28c04ceb05 · 2011-07-30T23:48:00.000+02:00
diff --git a/doc/index.rst b/doc/index.rst
@@ -6,11 +6,22 @@
 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.
+
 Contents:
 
 .. toctree::
    :maxdepth: 2
 
+   intro
+   installation
+   license
+   usage
+   compatibility
+
+
 Indices and tables
 ==================
 
diff --git a/doc/installation.rst b/doc/installation.rst
@@ -0,0 +1,13 @@
+Installation
+==================================================
+
+Installation can be done in various ways. The simplest form uses pip
+or easy_install. Either one will work::
+
+    pip install rsa
+    easy_install rsa
+
+Depending on your system you may need to use ``sudo pip`` or ``sudo
+easy_install``.
+
+
diff --git a/doc/intro.rst b/doc/intro.rst
@@ -0,0 +1,19 @@
+Introduction
+==================================================
+
+Python-RSA's history starts in 2006. As a student assignment for the
+University of Amsterdam we wrote a RSA implementation. We chose Python
+for various reasons; one of the most important reasons was the
+`unlimited precision integer`_ support.
+
+.. _`unlimited precision integer`: http://docs.python.org/library/stdtypes.html#numeric-types-int-float-long-complex
+
+It started out as just a module for calculating large primes, and RSA
+encryption, decryption, signing and verification using those large
+numbers. It also included generating public and private keys. There
+was no functionality for working with byte sequences (such as files)
+yet.
+
+.. TODO:: write more history
+
+
diff --git a/doc/usage.rst b/doc/usage.rst
@@ -0,0 +1,11 @@
+Usage
+==================================================
+
+
+.. toctree::
+
+   keygen
+   simple_enc_dec
+   sign_verify
+   big_files
+
