From 8a70bc84f497b77975cd8fb91527b66e46a37e05 Mon Sep 17 00:00:00 2001
From: "Pedro M. Baeza" <pedro.baeza@gmail.com>
Date: Sat, 21 Feb 2015 19:17:58 +0100
Subject: [PATCH] [IMP] shell: README

---
 shell/README.md  | 22 -----------------
 shell/README.rst | 63 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 63 insertions(+), 22 deletions(-)
 delete mode 100644 shell/README.md
 create mode 100644 shell/README.rst

diff --git a/shell/README.md b/shell/README.md
deleted file mode 100644
index bc908d8ba..000000000
--- a/shell/README.md
+++ /dev/null
@@ -1,22 +0,0 @@
-Makes available in Odoo 8 the `shell` server command available for Odoo 9.
-
-To have this feature available this module just need to be in the
-addons path. To use it, in a terminal window run:
-
-    $ ./odoo.py shell -d <dbname>
-
-This will initialize a server instance and then jump into a Pyhton
-interactive shell, with full access to the Odoo API.
-
-Example session:
-
-    >>> self
-    res.users(1,)
-    >>> self.name
-    u'Administrator'
-    >>> self._name
-    'res.users'
-    >>> self.env
-    <openerp.api.Environment object at 0xb3f4f52c>
-    >>> self.env['res.partner'].search([('name', 'like', 'Ag')])
-    res.partner(7, 51)
diff --git a/shell/README.rst b/shell/README.rst
new file mode 100644
index 000000000..5360b1979
--- /dev/null
+++ b/shell/README.rst
@@ -0,0 +1,63 @@
+CLI shell for Odoo
+==================
+
+Makes available in Odoo 8 the `shell` server command available for Odoo 9.
+
+Installation
+============
+
+Just install the module.
+
+Configuration
+=============
+
+Nothing special to be configured.
+
+Usage
+=====
+
+To have this feature available this module just need to be in the
+addons path. To use it, in a terminal window run:
+
+    $ ./odoo.py shell -d <dbname>
+
+This will initialize a server instance and then jump into a Pyhton
+interactive shell, with full access to the Odoo API.
+
+Example session:
+
+    >>> self
+    res.users(1,)
+    >>> self.name
+    u'Administrator'
+    >>> self._name
+    'res.users'
+    >>> self.env
+    <openerp.api.Environment object at 0xb3f4f52c>
+    >>> self.env['res.partner'].search([('name', 'like', 'Ag')])
+    res.partner(7, 51)
+
+
+Credits
+=======
+
+Contributors
+------------
+
+* OpenERP S.A.
+* Daniel Reis <dgreis@sapo.pt>
+
+Maintainer
+----------
+
+.. image:: http://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: http://odoo-community.org
+
+This module is maintained by the OCA.
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+To contribute to this module, please visit http://odoo-community.org.