Fix document pointer documentation

Improve clarity and remove wrong documentation about using `is_valid` to
check if a document still exists.
Fix distchecking with PDF enabled
Don't truncate pdflatex warnings
Enable PDF generation on distcheck
Merge branch 'ntrel/fix-valid-doc-dox'