* 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

Add -b and -X options to python man page.
Patch contributed by Corey Brune.

Patch contributed by Corey Brune.

The exception is the import related questions at the end, which
need to be rewritten anyway.

ISO C90 forbids mixed declarations and code

ISO C90 forbids mixed declarations and code

Reported by Arfrever Frehtes Taifersar Arahesis.

faulthandler._read_null() is not reliable: it does not crash on AIX.

faulthandler._read_null() is not reliable: it does not crash on AIX.

sigwaitinfo() can be interrupted on Linux (raises InterruptedError), but not on
AIX.

sigwaitinfo() can be interrupted on Linux (raises InterruptedError), but not on
AIX.

locale.getlocale(name) in test.regrtest.saved_test_environment

locale.getlocale() parses the locale, which is useless for
saved_test_environment.

Skip LC_ALL becore getlocale(locale.LC_ALL) always fail, and catch also
ValueError.