Sphinx-Contrib: Introducing the Spec Extension
Doc: The start of documentation
Sub: Adding torspec submodule
Doc: Add Placeholder for the Spec extension docs
Doc: Register Tor's Dirspec as a Spec
Rename 'doc' to 'docs', for no particular reason
Fold in gitignore's Python.gitignore template

This was taken from the repo at:
    https://github.com/github/gitignore.git

at commit:
    5979282c55da38db155427080d7a89dd31c93502
Sphinx-Contrib: Merge 'spec-quote-' into 'spec-'

Instead of requiring linkers to keep track of which type of linking they
are interested in using, allow all linking to be done through a single
role that is smart enough to link the way the request is made.
Sphinx-Contrib: Support Highlighting Sections

Add highlights around a (sub)section title when it directly jumped to
via url fragment, the same way we do with quote-ed highlights.
Sphinx-Contrib: Warn and continue on bad spec links

I know there're plenty of spec links that won't work properly given the
current code. Instead of letting them shut everything down, just warn
and replace it with a link to the desired spec.
Sphinx-Contrib: Make pyflakes happy
Sphinx-Contrib: Make pep8 happy
Sphinx-Contrib: Beginning of Usage Documentation
Sphinx-Contrib: Re-org under 'sphinxcontrib.spec'

Trying to keep things out of the generic 'sphinxcontrib' namespace seems
like a good idea, so huddling everything under 'sphinxcontrib.spec'
should help in that respect.
Sphinx-Contrib: Sketch out Implementation Docs

Though there isn't anything meaningful to read (yet?), sketching out
explicitly where to look seems like something worth doing.
Net: Starting up the API around Nodes

A node here is meant to represent an external running process that is
connection to a locally constructed tor network. In such a network there
are currently two types of nodes, directory nodes and normal nodes.
Net: Introducing a node implementation around tor

This wraps a little-t tor node and provides the basic functionality
necessary to bring up nodes, monitor them (kind of), and bring them down
as requested.
Net: Introducing a 'Network' level

A network being a group of nodes that know about each other and
communicate. It is anticipated that the nodes present in a network may
not be homogenous (ex. some might be tor, other jTor, etc.) so this is
necessarily a high level abstraction.
Sphinx-Contrib: Match Sections by Prefix

By focusing requiring simply an 'in' check for matching section
requests, we allow for for more matches than really is reasonable. For
instance, looking for section '3' we would allow a match of '0.3', which
isn't quite reasonable.

Instead, favor a 'startswith' approach. We're again not guaranteed that
everything will match up perfectly, but we should be closer to where
we want to be, instead of several sections away.
Sphinx-Contrib: Fix Text Matching off-by-one error

The re.Match object's 'lastindex' is indeed it's last index, and not one
more than the last index. Silly me.