Improve documentation build

Fix some problems found during documentation build:
* Remove reference to obsolete files
* Fix warning about too short title underlining
* Include api reference in index page
* Include man page in index page
* We have no _static files, so don't set the config option for it
* Fix reference for tests.share

Change-Id: I798d1ab65184689d75c559de9bffdf5969b9f013
Merge "Improve documentation build"