From a2a557e23d10691176f103d7daf99426cd447a6d Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.com>
Date: Mon, 14 Nov 2011 18:02:12 -0500
Subject: [PATCH] usage

---
 README.rst | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/README.rst b/README.rst
index 03e3921..2e256bd 100644
--- a/README.rst
+++ b/README.rst
@@ -4,3 +4,45 @@ Python Version Tools
 **tl;dr**: Pythonbrew done right.
 
 (work in progress)
+
+
+Usage
+-----
+
+List all available Pythons::
+
+    $ pyenv list
+    python-2.5 (python-2.5.6)
+    python-2.6 (python-2.6.7)
+    python-2.7 (python-2.7.2)
+    pypy (pypy-1.6)
+
+Update the cache::
+
+    $ pyenv update
+    # Downloads all required files and such.
+
+Build a Python::
+
+    $ pyenv build 2.7
+
+Build all major versions of Python::
+
+    $ pyenv build --all-major
+
+Build all versions of Python::
+
+    $ pyenv build --all
+
+
+Config
+------
+
+Contents of `~/.pyenv/`:
+
+  `pythons`
+    Python installations.
+  `cache`
+    Dependencies.
+  `formula`
+    Python version formulas.