Merge pull request #627 from opendatacube/cli_tool_doc

Autodocument CLI tools from man pages.

docs/conf.py

@@ -40,7 +40,7 @@
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.viewcode']
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.viewcode', 'sphinx_click']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

docs/usage.rst

@@ -2,13 +2,38 @@
 Usage
 =====
 
+.. contents:: Table of Contents
+
 As a Python Module
 ------------------
 
 To use datacube-ows in a project::
 
     import datacube_ows
 
+To use the `stand-alone styling API <https://datacube-ows.readthedocs.io/en/latest/cfg_style_api.html>`_::
+
+    from datacube_ows.styles.api import *
+
+
+OWS Command Line Tools
+----------------------------
+
+Datacube-OWS provides two command line tools:
+
+* ``datacube-ows-update`` that for creating and maintaining OWS's
+  `database tables and views <https://datacube-ows.readthedocs.io/en/latest/database.html>`_.
+* ``datacube-ows-cfg`` which is used for managing
+  `OWS configuration files <https://datacube-ows.readthedocs.io/en/latest/configuration.html>`_.
+
+.. click:: datacube_ows.update_ranges:main
+    :prog: datacube-ows-update
+    :nested: full
+
+.. click:: datacube_ows.cfg_parser:main
+    :prog: datacube-ows-update
+    :nested: full
+
 As a Web-Service in Docker with Layers deployed
 -----------------------------------------------