pcre lexer: Add comment about nested parens in comments.

[silentbicycle]

pcregrep accepts nested parens in comments even though its own documentation quite explicitly says it should not.

This is only a comment change, I confirmed that regenerating the lexer with lx did not change the generated lexer code.

Closes #417.