Split up the intertwined mess of std.regex.

Make a package in std.internal.regex.

The docs and API still stay in one file.

With time and refactoring more internals may be
exposed such as parser, each engine explicitly
and the sample generator (generator.d).