Minor documentation tweaks

Signed-off-by: Zearin <zearin@gonk.net>
FIXED INCONCISTENT tab / 4-space INDENTATION!  WOOHOOOOOO

God that was a nightmare.  Feel much better now.  :P

Signed-off-by: Zearin <zearin@gonk.net>
Tweak parens

Signed-off-by: Zearin <zearin@gonk.net>
Tweak spacing (readability)

Signed-off-by: Zearin <zearin@gonk.net>
Rename PyVows test file to the `*_vows` convention

Signed-off-by: Zearin <zearin@gonk.net>
Don’t use outdated `string` module

Signed-off-by: Zearin <zearin@gonk.net>
Use list instead of tuple for abbreviations

Oops.  *I* changed it to a tuple!  Forgot they had list-only methods called later in the code.

Signed-off-by: Zearin <zearin@gonk.net>
Fix indentation of DOCTYPE and root `<bibtex:file>` element

Signed-off-by: Zearin <zearin@gonk.net>
Code readability tweaks

Signed-off-by: Zearin <zearin@gonk.net>
Commented top-level sections in `bibtex2xml_vows.py`

Signed-off-by: Zearin <zearin@gonk.net>
Code readability tweaks

Signed-off-by: Zearin <zearin@gonk.net>
Documentation and code readability tweaks

Signed-off-by: Zearin <zearin@gonk.net>
Updated example test output

Signed-off-by: Zearin <zearin@gonk.net>
Regenerated test XML output
Move `main()` to top

Always nice to see what your program does at the start of the file. :)
Use raw strings on regexes
Use `str.format()`
Drop `with_statement` import `from __future__`
Refactored several pieces of `bibtexdecoder` into separate functions; extracted regexes all to top of module
Tweaked condition formatting