From e63781eed341bf12bc66b1fcecc66dc0cf6487f0 Mon Sep 17 00:00:00 2001
From: Paul McCarthy <pauld.mccarthy@gmail.com>
Date: Tue, 5 Apr 2016 10:54:53 +0100
Subject: [PATCH] Adjusted documentation table-of-contents. Works nicer now.

---
 doc/conf.py           |  2 +-
 doc/fsl.data.rst      | 13 +++++++++++++
 doc/fsl.rst           |  7 +++++++
 doc/fsl.utils.rst     | 20 ++++++++++++++++++++
 doc/index.rst         | 25 -------------------------
 fsl/data/__init__.py  | 15 ---------------
 fsl/utils/__init__.py | 18 ------------------
 7 files changed, 41 insertions(+), 59 deletions(-)
 delete mode 100644 doc/index.rst

diff --git a/doc/conf.py b/doc/conf.py
index ff39e3029..81d9fbe5c 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -52,7 +52,7 @@ source_suffix = '.rst'
 #source_encoding = 'utf-8-sig'
 
 # The master toctree document.
-master_doc = 'index'
+master_doc = 'fsl'
 
 # General information about the project.
 project = u'fslpy'
diff --git a/doc/fsl.data.rst b/doc/fsl.data.rst
index 31516eabd..b1d9ab529 100644
--- a/doc/fsl.data.rst
+++ b/doc/fsl.data.rst
@@ -1,6 +1,19 @@
 fsl.data package
 ================
 
+.. toctree::
+   :hidden:
+
+   fsl.data.atlases
+   fsl.data.constants
+   fsl.data.featimage
+   fsl.data.featresults
+   fsl.data.image
+   fsl.data.melodicimage
+   fsl.data.melodicresults
+   fsl.data.model
+   fsl.data.tensorimage
+
 .. automodule:: fsl.data
     :members:
     :undoc-members:
diff --git a/doc/fsl.rst b/doc/fsl.rst
index 378faff43..cb3575e0b 100644
--- a/doc/fsl.rst
+++ b/doc/fsl.rst
@@ -1,6 +1,13 @@
 fsl package
 ===========
 
+.. toctree::
+   :hidden:
+
+   fsl.version
+   fsl.utils
+   fsl.data
+
 .. automodule:: fsl
     :members:
     :undoc-members:
diff --git a/doc/fsl.utils.rst b/doc/fsl.utils.rst
index df2c72c59..a8d95ca9a 100644
--- a/doc/fsl.utils.rst
+++ b/doc/fsl.utils.rst
@@ -1,6 +1,26 @@
 fsl.utils package
 =================
 
+.. toctree::
+   :hidden:
+
+   fsl.utils.async
+   fsl.utils.colourbarbitmap
+   fsl.utils.dialog
+   fsl.utils.imagepanel
+   fsl.utils.layout
+   fsl.utils.memoize
+   fsl.utils.notifier
+   fsl.utils.path
+   fsl.utils.platform
+   fsl.utils.runwindow
+   fsl.utils.settings
+   fsl.utils.status
+   fsl.utils.textbitmap
+   fsl.utils.transform
+   fsl.utils.typedict
+   fsl.utils.webpage
+
 .. automodule:: fsl.utils
     :members:
     :undoc-members:
diff --git a/doc/index.rst b/doc/index.rst
deleted file mode 100644
index 96904a848..000000000
--- a/doc/index.rst
+++ /dev/null
@@ -1,25 +0,0 @@
-``fslpy``
-=========
-
-
-.. toctree::
-   :hidden:
-   :maxdepth: 2
-
-   fsl
-   fsl.data
-   fsl.utils
-
-   
-This is the ``fslpy`` API documentation.
-
-
-Building the documentation
---------------------------
-
-These pages have been built with the following commands (assuming that we
-are starting in the ``fslpy`` root directory)::
-
-    cd apidoc
-    rm -rf html
-    sphinx-build . html
diff --git a/fsl/data/__init__.py b/fsl/data/__init__.py
index bce706e83..29f4c3435 100644
--- a/fsl/data/__init__.py
+++ b/fsl/data/__init__.py
@@ -6,19 +6,4 @@
 #
 """This module contains various data types and associated I/O routines,
 models, constants, and other data-like things used throughout ``fslpy``.
-
-
- .. autosummary::
-    :nosignatures:
-
-    ~fsl.data.image.Nifti1
-    ~fsl.data.image.Image
-    ~fsl.data.featimage.FEATImage
-    ~fsl.data.melodicimage.MelodicImage
-    ~fsl.data.tensorimage.TensorImage
-    ~fsl.data.model.Model
-    ~fsl.data.featresults
-    ~fsl.data.melodicresults
-    ~fsl.data.atlases
-    ~fsl.data.constants
 """
diff --git a/fsl/utils/__init__.py b/fsl/utils/__init__.py
index 1091be9be..12e2d002c 100644
--- a/fsl/utils/__init__.py
+++ b/fsl/utils/__init__.py
@@ -6,22 +6,4 @@
 #
 """This module contains a collection of small utility modules for doing random
 things.
-
- .. autosummary::
-    :nosignatures:
-
-    ~fsl.utils.settings
-    ~fsl.utils.transform
-    ~fsl.utils.typedict
-    ~fsl.utils.layout
-    ~fsl.utils.colourbarbitmap
-    ~fsl.utils.textbitmap
-    ~fsl.utils.dialog
-    ~fsl.utils.runwindow
-    ~fsl.utils.webpage
-    ~fsl.utils.status
-    ~fsl.utils.memoize
-    ~fsl.utils.path
-    ~fsl.utils.async
-    ~fsl.utils.notifier
 """
-- 
GitLab