Merge no-underscore-parse-methods [r=niemeyer,jkakar] [f=128060]
Now it's easy to tell what you can touch in Storm: If it begins with
an underscore, you definitely can't touch it in any way. If it doesn't
begin with an underscore, read the documentation to see how it's meant
to be used. If it doesn't have a docstring, file a bug. :-)
This branch renames _parse_get, _parse_set, _from_database, _to_database,
_build_raw_cursor, _raw_execute, _result_factory, _param_mark, _compile,
and _connection_factory so that they no longer have preceding underscores,
because they were all meant to be overridden in subclasses. Documentation
was added on their intended usage.
It also adds a LOT of documentation to store.py, variables.py, and
database.py, and fixes a few existing docstrings to be valid epytext.