Merge pull request #379 from diethard2/master

solve many documentation build errors
solved several documentation building warnings