Documentation updates

Sphinx documenation updates, including:
- Extensively re-wrote the "alternatives to cmd2" section as it was many years out of date
- Reworded a few humorous sections in an attempt to be more professional
- Removed reference to command synonyms/aliases which no longer exist
- Added more detail in a couple places
- Minor rewording and bugfixes throughout

Also added a note to cmd2.py about the expected values for doctest only working for Python 2.7.

1 files changed, 3 insertions, 0 deletions

diff --git a/cmd2.py b/cmd2.py
index 684f45e6..8c05a61e 100755
--- a/cmd2.py
+++ b/cmd2.py
@@ -1,3 +1,4 @@
+#!/usr/bin/env python
 # coding=utf-8
 """Variant on standard library's cmd with extra features.
 
@@ -1956,6 +1957,8 @@ class Cmd2TestCase(unittest.TestCase):
 if __name__ == '__main__':
     doctest.testmod(optionflags=doctest.NORMALIZE_WHITESPACE)
 
+    # NOTE: The doctest expected values work with Python 2.7, but are a bit off for Python 3.x.
+
 '''
 To make your application transcript-testable, replace