NAME
    re::engine::Plan9 - Plan 9 regular expression engine

SYNOPSIS
        use re::engine::Plan9;

        if ("bewb" =~ /(.)(.)/) {
            print $1; # b
            print $2; # e
            print $'; # wb
        }

DESCRIPTION
    Replaces perl's regex engine in a given lexical scope with Plan 9
    regular expression provided by libregexp9. libregexp9 and the libfmt and
    libutf it depends on from Plan 9 are shipped with the module.

    The "/s" modifier causes "." to match a newline ("regcompnl") and the
    "/x" modifier allegedly causes all characters to be treated literally
    ("regcomplit"), see regexp9(3). The engine will "croak" if it's given
    other modifier.

    If an invalid pattern is supplied perl will die with an error from
    regerror(3).

CAVEATS
    The Plan 9 engine only supports 32 capture buffers, consequently match
    variables only go up to $31 ($& is number zero).

SEE ALSO
    regexp9(7) - Plan 9 regular expression notation
        <http://swtch.com/plan9port/unix/man/regexp97.html>

    regexp9(3) - regcomp, regexec etc.
        <http://swtch.com/plan9port/unix/man/regexp93.html>

    Unix Software from Plan 9
        <http://swtch.com/plan9port/unix/>

AUTHOR
    var Arnfjr Bjarmason <avar@cpan.org>

LICENSE
    Copyright 2007 var Arnfjr Bjarmason.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

    The included libutf, libfmt and libregexp9 libraries are provided under
    the following license:

        The authors of this software are Rob Pike and Ken Thompson.
                     Copyright (c) 2002 by Lucent Technologies.
        Permission to use, copy, modify, and distribute this software for any
        purpose without fee is hereby granted, provided that this entire notice
        is included in all copies of any software which is or includes a copy
        or modification of this software and in all copies of the supporting
        documentation for such software.
        THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED
        WARRANTY.  IN PARTICULAR, NEITHER THE AUTHORS NOR LUCENT TECHNOLOGIES MAKE ANY
        REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY
        OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.

