There were two somewhat independent sections to my post:

1. Specific suggested edits to a particular section of the manual.  At
least some are straightforward. As of 3.0.1, they have not been made and
I presume that is still true.

Georg, if I grab a copy from svn, edit (respecting .rst markup), and
post here, will you diff, review (and possibly further edit to taste)
and apply? If so, can I start with the current 3.1 version ('branch') or
do you prefer the 2.7 version ('trunk', though I think of it the opposite).

2. A general question re documenting exceptions with specific examples
from the same section.  I presume that is Georg suggested I take to
py-dev, but I waited for an 'appropriate' time when there was a 'hot'
issue being discussed and then forgot.  I will try to remember, soon,
when the current filename controversy cools a bit.