Add numpy.doc topical documentation framework.

4 files changed, 31 insertions, 0 deletions

diff --git a/numpy/doc/__init__.py b/numpy/doc/__init__.py
new file mode 100644
index 000000000..394f0b548
--- /dev/null
+++ b/numpy/doc/__init__.py
@@ -0,0 +1,2 @@
+from numpy.doc.reference import *
+del reference
diff --git a/numpy/doc/reference/__init__.py b/numpy/doc/reference/__init__.py
new file mode 100644
index 000000000..c64a6fb0a
--- /dev/null
+++ b/numpy/doc/reference/__init__.py
@@ -0,0 +1,11 @@
+import os
+
+ref_dir = os.path.join(os.path.dirname(__file__))
+
+__all__ = [f[:-3] for f in os.listdir(ref_dir) if f.endswith('.py') and
+           not f.startswith('__')]
+
+__doc__ = 'The following topics are available:\n' + \
+          '\n - '.join([''] + __all__)
+
+__all__.extend(['__doc__'])
diff --git a/numpy/doc/reference/broadcasting.py b/numpy/doc/reference/broadcasting.py
new file mode 100644
index 000000000..797d0edba
--- /dev/null
+++ b/numpy/doc/reference/broadcasting.py
@@ -0,0 +1,9 @@
+"""
+
+========================
+Broadcasting over arrays
+========================
+
+Placeholder for broadcasting documentation.
+
+"""
diff --git a/numpy/doc/reference/indexing.py b/numpy/doc/reference/indexing.py
new file mode 100644
index 000000000..bc13611e8
--- /dev/null
+++ b/numpy/doc/reference/indexing.py
@@ -0,0 +1,9 @@
+"""
+
+==============
+Array indexing
+==============
+
+Placeholder for array indexing documentation.
+
+"""