# HG changeset patch # User Brian Neal # Date 1372995690 18000 # Node ID 5b335e8af407ebb3850bcd2afd03b663503a1bf0 # Parent 9c994664fdd63cbc96b86b561ec5a2bdb9fdf16c Started roughing in some docs using Sphinx. diff -r 9c994664fdd6 -r 5b335e8af407 .hgignore --- a/.hgignore Thu Jul 04 18:15:31 2013 -0500 +++ b/.hgignore Thu Jul 04 22:41:30 2013 -0500 @@ -1,5 +1,5 @@ syntax: glob *.pyc *.swp -m209/docs/build +docs/_build dist diff -r 9c994664fdd6 -r 5b335e8af407 docs/index.rst --- a/docs/index.rst Thu Jul 04 18:15:31 2013 -0500 +++ b/docs/index.rst Thu Jul 04 22:41:30 2013 -0500 @@ -6,6 +6,71 @@ Welcome to m209's documentation! ================================ +:Author: Brian Neal +:Version: |release| +:Date: |today| +:Home Page: https://bitbucket.org/bgneal/m209/ +:License: MIT License (see LICENSE.txt) +:Documentation: http://m209.readthedocs.org/ +:Support: https://bitbucket.org/bgneal/m209/issues + +Introduction +------------ + +``m209`` is a complete `M-209`_ simulation library and command-line application +written in Python 3. ``m209`` is historically accurate, meaning that it can +exchange messages with an actual M-209 cipher machine. + +It is hoped that this library will be useful to M-209 enthusiasts, historians, +and students interested in cryptography. + +``m209`` strives to be Pythonic, easy to use, and comes with both unit tests +and documentation. ``m209`` is a library for building applications for +encrypting and decrypting M-209 messages. ``m209`` also ships with a simple +command-line application that can encrypt & decrypt messages for scripting and +experimentation. + +Command-line Example +-------------------- + +Library Example +--------------- + +Requirements +------------ + +``m209`` is written in Python_, specifically Python 3.3. It has no other +requirements or dependencies. + +Installation +------------ + +``m209`` is available on the `Python Package Index`_ (PyPI). You can install it +using pip_:: + + $ pip install m209 # install + $ pip install --upgrade m209 # upgrade + +You may also download a tarball or .zip file of the latest code using the "get +source" link on the `m209 Bitbucket page`_. Alternatively if you use +Mercurial_, you can clone the repository with the following command:: + + $ hg clone https://bitbucket.org/bgneal/m209 + +If you did not use pip, you can install with this command:: + + $ python setup.py install + + +Support & Source +---------------- + +All support takes place at the `m209 Bitbucket page`_. Please enter any +feature requests or bugs into the `issue tracker`_. + +Next Steps +---------- + Contents: .. toctree:: @@ -20,3 +85,11 @@ * :ref:`modindex` * :ref:`search` + +.. _M-209: http://en.wikipedia.org/wiki/M-209 +.. _Python: http://www.python.org +.. _Python Package Index: http://pypi.python.org/pypi/m209/ +.. _m209 Bitbucket page: https://bitbucket.org/bgneal/m209 +.. _pip: http://www.pip-installer.org +.. _Mercurial: http://mercurial.selenic.com/ +.. _issue tracker: https://bitbucket.org/bgneal/m209/issues