Some minor documentation touchups for libregex. Fixes #13800.
auto merge of #14635 : BurntSushi/rust/regex-doco-touchups, r=alexcrichton