remove trailing whitespaces
do not produce too deep toc for category lists
provide sections and local TOC for module documentation
fix example formatting
use rst formatting for sphinx part