This provides a way to specify arbitrary doctest options when using
the CLI interface to process test files, just as one can when calling
testmod or testfile programmatically.
* Move the constants used by os.open() to after the description of os.open(),
instead of putting them in their own section.
* Move RTLD_* constants to "Miscellaneous System Information" section, and
mention the sys functions they're used with.
* Mention dir_fd parameter in os.open() text.
* Typo fix ("are a supported by").
* state that python3 source encoding is UTF-8, and give examples
* mention surrogateescape in the 'tips and tricks' section, and
backslashreplace in the "Python's Unicode Support" section.
* Describe Unicode support provided by the re module.
* link to Nick Coghlan's and Ned Batchelder's notes/presentations.
* default filesystem encoding is now UTF-8, not ascii.
* Describe StreamRecoder class.
* update acks section
* remove usage of "I think", "I'm not going to", etc.
* various edits
* remove revision history and original outline
The helper function makes it easier to implement
imoprtlib.abc.InspectLoader.get_source() by making that function
require just the raw bytes for source code and handling all other
details.
UnicodeDecodeError as ImportError. That was over-reaching the point of
raising ImportError in get_source() (which is to signal the source
code was not found when it should have). Conflating the two exceptions
with ImportError could lead to masking errors with the source which
should be known outside of whether there was an error simply getting
the source to begin with.
To make sure there is no issue with code that is both Python 2 and 3
compatible, there are no plans to remove the module any sooner than
Python 4 (unless the community moves to Python 3 solidly before then).
