Fix docs, be strict when building documentation

Fix an error in the API documentation. Add the `-W` flag to `SPHINXOPTS` in
`docs/Makefile`. This option makes sphinx "turn warnings into errors". The
purpose of this change is to make Travis fail if any commit breaks the
documentation.