fix documentation warnings p1

Hi,

This PR fixes some of the issues that can be seen while building documentation in tex format.

It doesn't fixes all issues, but at least I've got over 300 pages pdf :)

Best regards,
Michal