fix various reported errors by sphinx

Signed-off-by: Fotis Georgatos <fotis@cern.ch>