Substantially revised documentation for the zipfile module, partially based

on revised text from Jim Ahlstrom <jim@interet.com>.

This closes SourceForge bug #115681.