basic sphinx doc added
Adapted example modules to new docstyle
Adapted docstrings

Since we want to use sphinx to create code documentation I changed the
style of relevant docstrings.