swift234

Turn on ReST error checking in CMake documentation builds

(it was already on in Makefile builds)

Also, fix the ReST errors it found.

Also, monkeypatch pygments so it can see our lexers when we build
documentation.  This keeps all doc builds from producing heaps of
warnings.

Swift SVN r6023