Update the re1 package doc.

It now describes the regexp(7) variant that it will implement.
Allow delimiters in charclasses.
Interpret escaped meta delimiters as meta, not lineral.