DOC: Fixed paths to images for case sensitive platforms.
DOC: Fixed warnings from sphinx and corrected two links.
DOC: Included missing file in documentation and corrected syntax.
DOC: Fixed warnings from sphinx in doc strings.
DOC: Fixed typos, syntax and minor errors in documentation.
DOC: Updated examples in doc strings not to import deprecated log module.
Merge pull request #393 from philippwiesemann/master

DOC: Fixed typos, sphinx warnings and minor errors in documentation.