Update re2.py documentation

[AlexeySalmin]

1. Add a specific example of re flags replacement (for ease of search)
2. Document the difference in the behavior of \b, example included. \b not working with Unicode characters #344 I can't believe accents inside words are not supported.  #433

[google-cla]

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

[github-actions]

RE2 uses Gerrit instead of GitHub pull requests.
See the Contribute wiki page.