document regexp scalar functions
add regexp operator ~ docs
improve regex functions docs
Merge pull request #1168 from crate/m/regex-docs

M/regex docs