update documentation

This mainly adds a description of ``--bisect`` mode to the manpage
but also adds a workaround for inline code handling in the PDF manual.