From f2a5a6894eed2d32be87b9783befeb21dfa319dc Mon Sep 17 00:00:00 2001
From: Takafumi Arakaki <aka.tkf@gmail.com>
Date: Sun, 17 Jun 2012 00:51:52 +0200
Subject: [PATCH] Add install section and improve usage section

---
 doc/source/index.rst | 48 +++++++++++++++++++++++++++++++++++---------
 1 file changed, 38 insertions(+), 10 deletions(-)

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 3d7b244..d746d09 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -96,21 +96,45 @@ EIEIO and json.el.  EIN is currently tested in Emacs 24.1.
 .. _smartrep.el: https://github.com/myuhe/smartrep.el
 
 
+Install
+-------
+
+Using el-get
+^^^^^^^^^^^^
+
+If you use developmental version of `el-get`_, you can install it
+easily using it.  Emacs IPython Notebook is registered as package
+``ein``.
+
+.. _el-get: https://github.com/dimitri/el-get
+
+Manual install
+^^^^^^^^^^^^^^
+
+Put Emacs lisp ``ein*.el`` files and Python file ``ein.py`` in
+a directory defined in your :el:symbol:`load-path`.
+
+Setup
+^^^^^
+
+Here is the minimal configuration.  See customization_ for more details.
+
+.. sourcecode:: cl
+
+   (require 'ein)
+
+
 Usage
 -----
 
+1. Start `IPython notebook server`_.
 
-1. Install module.
-   Put Emacs lisp ``ein*.el`` files and Python file ``ein.py`` in your
-   load path.
+2. Hit ``M-x ein:notebooklist-open`` to open notebook list.  This will
+   open :ref:`notebook list <notebook-list-commands>` buffer.
 
-2. Require module::
-
-     (require 'ein)
-
-3. Start `IPython notebook server`_.
-
-4. Hit ``M-x ein:notebooklist-open`` to open notebook list.
+3. In the notebook list buffer, you can open notebooks by hitting
+   ``[Open]`` buttons.  See :ref:`notebook <notebook-commands>`
+   section for what you can do in the notebook buffer.
 
 .. _`IPython notebook server`:
    http://ipython.org/ipython-doc/stable/interactive/htmlnotebook.html
@@ -119,6 +143,8 @@ Usage
 Commands/Keybinds
 -----------------
 
+.. _notebook-list-commands:
+
 Notebook list
 ^^^^^^^^^^^^^
 
@@ -130,6 +156,8 @@ port or URL of the IPython notebook server.
 .. el:function:: ein:notebooklist-open-notebook-global
 .. el:function:: ein:notebooklist-new-scratch-notebook
 
+.. _notebook-commands:
+
 Notebook
 ^^^^^^^^