From: Roger Shimizu <rogershimizu@gmail.com>
Date: Sun, 19 Jun 2016 16:44:30 +0900
Subject: setup docs folder and make index works

---
 docs/conf.py   |  8 ++++----
 docs/index.rst | 14 ++++++++++++++
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 22fb9c1..535ebd0 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -5,9 +5,9 @@ import sys, os
 extensions = []
 source_suffix = '.rst'
 master_doc = 'index'
-project_name = u'APPNAME'
-project_slug = u'appname'
-company = u'COMPANY'
+project_name = u'libcorkipset'
+project_slug = u'libcorkipset'
+company = u'RedJack, LLC'
 copyright_years = u'2012'
 
 default_role = 'c:func'
@@ -23,7 +23,7 @@ rst_epilog = """
 # documentation sets, uncomment and fill in the following.
 #
 #intersphinx_mapping = {
-#    'libcork': ('http://libcork.readthedocs.org/en/latest/', None),
+#    'libcork': ('https://libcork.readthedocs.org/en/latest/', None),
 #}
 
 # Our CMake build scripts will insert overrides below if the prereq
diff --git a/docs/index.rst b/docs/index.rst
index 7390b16..eadad86 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -7,12 +7,26 @@ This is the documentation for |project_name| |release|, last updated
 |today|.
 
 
+Introduction
+------------
+
+The ipset library provides C data types for storing sets of IP
+addresses, and maps of IP addresses to integers.  It supports both
+IPv4 and IPv6 addresses.  It's implemented using "Binary Decision
+Diagrams" (BDDs, https://en.wikipedia.org/wiki/Binary_decision_diagram),
+which (we hypothesize) makes it space efficient for large sets.
+
+
 Contents
 --------
 
 .. toctree::
    :maxdepth: 2
 
+   commands
+   file-format
+   maps
+   sets
 
 
 Indices and tables