documentation. Mostly add some <xref>s, fix a few typos, and
document that zlib is required in the installation docs.