Mention possible nil return value in docs; fix typos

The unexpected `nil` return value of Pygments.highlight (see issue #78) should be mentioned in the method's doc.