Cleaned up documentation a bit.

I added some installation documentation and wrote a bit more on
completion.  Also, now there's a Makefile to make it easier to write
documentation.

Author: Rocky Meza

Makefile

@@ -0,0 +1,13 @@
+PORT?=8008
+
+test:
+	python setup.py test
+
+docs:
+	cd docs && $(MAKE) html
+
+docs-server: docs
+	(sleep 1 && sensible-browser "http://localhost:$(PORT)")
+	cd docs/_build/html/ && python -m SimpleHTTPServer $(PORT)
+
+.PHONY: test docs docs-server

docs/index.rst

@@ -11,19 +11,22 @@ It is inspired by `ifscheme`.
 
 The library also comes with an executable that you can use to manage your WiFi connections.
 
-Contents:
 
-.. toctree::
-   :maxdepth: 2
+Installation
+------------
+
+Wifi is available for installation on PyPI::
 
-   wifi_command
-   scanning
+    $ pip install wifi
 
+This will install the :doc:`the wifi command <wifi_command>`, a Python library for discovering and connecting to wifi networks, and a bash completion file for the wifi command.
 
 
-Indices and tables
-==================
+Documentation
+-------------
+
+.. toctree::
+    :maxdepth: 2
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+    wifi_command
+    scanning

docs/wifi_command.rst

@@ -52,5 +52,6 @@ Connects to the network corresponding to SCHEME. ::
 Completion
 ^^^^^^^^^^
 
-The wifi command also comes with bash completion.
-To use the completion, source the `bash_completion` file that comes with the distribution.
+The wifi command also comes packaged with completion for bash.
+If you want to write completion for your own shell, wifi provides an interface for extracting completion information.
+Please see the ``wifi-completion.bash`` and ``bin/wifi`` files for more information.

setup.py

@@ -29,7 +29,7 @@ def read(fname):
     packages=['wifi'],
     scripts=['bin/wifi'],
     test_suite='tests',
-    platforms="Debian",
+    platforms=["Debian"],
     license='BSD',
     install_requires=install_requires,
     classifiers=[