doc updates from http://bugs.python.org/issue21514 re: #102