[Patch] Add documents and comments for regex

[Jonathan Wakely]

On 25 July 2013 15:09, Tim Shen wrote:
> Documents and comments, along with a testcase for not-entirely-correct
> basic_regex::position() behavior(when regex_iterator::operator++() is
> called).

This is OK to commit, thanks.