archive/zip: tweak API and docs. Fixes #2835. R=golang-dev, n13m3y3r, r, bradfitz CC=golang-dev https://golang.org/cl/5645051