Use sphinxcontrib-emacs for autodoc

Author: tkf

doc/source/conf.py

@@ -31,6 +31,7 @@
 extensions = [
  'sphinx.ext.autodoc',
  'sphinx.ext.intersphinx',
+ 'sphinxcontrib.emacs',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -258,3 +259,8 @@
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {'http://docs.python.org/': None}
+
+
+# -- Options for Emacs ----------------------------------------------------
+
+emacs_lisp_load_path = [os.path.abspath(os.path.join('..', '..',))]

doc/source/index.rst

@@ -1,17 +1,34 @@
-.. Emacs Python Environment documentation master file, created by
- sphinx-quickstart on Thu Mar 13 19:36:29 2014.
- You can adapt this file completely to your liking, but it should at least
- contain the root `toctree` directive.
-
-Welcome to Emacs Python Environment's documentation!
-====================================================
-
-Contents:
-
-.. toctree::
- :maxdepth: 2
-
-
+.. include:: ../../README.rst
+
+.. el:require:: python-environment
+
+End user configuration
+======================
+
+.. el:variable:: python-environment-directory
+ :auto:
+.. el:variable:: python-environment-default-root-name
+ :auto:
+.. el:variable:: python-environment-virtualenv
+ :auto:
+
+API functions
+=============
+
+.. el:function:: python-environment-make
+ :auto:
+.. el:function:: python-environment-make-block
+ :auto:
+.. el:function:: python-environment-run
+ :auto:
+.. el:function:: python-environment-run-block
+ :auto:
+.. el:function:: python-environment-exists-p
+ :auto:
+.. el:function:: python-environment-bin
+ :auto:
+.. el:function:: python-environment-lib
+ :auto:
 
 Indices and tables
 ==================