document the API signature change for Perl_regexec_flags()

and its related plugin structure pointer

inspired by https://rt.perl.org/Ticket/Display.html?id=121868 which was
also broken by ea3daa5d5f60389b105c00d4f7d05b5c2f2155f2