==============================================================================
                  Release of version 2.107 of Regexp::Common
==============================================================================

NOTE:  The jump to version 2.100 is there for no other reason than that
       CPAN.pm is stupid. The entire world considers version numbers to be
       dot separated *INTEGERS*, except CPAN, which considers them to
       be *FLOATS*. In which universe there can be more than one dot
       in a float is of course a mystery.

       CPAN.pm just couldn't deal with the fact one of the files in the
       distribution was of version 1.10, thinking the older 1.9 version
       was newer.

       It would be sooo tempting to start using Roman numerals as version
       numbers.

NOTE:  The jump from version 0.09 to 1.20 does not indicate a significant
       change in the API, or any other significant change. It's just that
       the version number now follows the revision number from CVS.

NAME

    Regexp::Common - Provide commonly requested regular expressions


SYNOPSIS

     use Regexp::Common;

     while (<>) {
            /$RE{num}{real}/                
				and print q{a number\n};
            /$RE{quoted}/                   
				and print q{a ['"`] quoted string\n};
            /$RE{delimited}{-delim=>'/'}/   
				and print q{a /.../ sequence\n};
            /$RE{balanced}{-parens=>'()'}/  
				and print q{balanced parentheses\n};
            /$RE{profanity}/                
				and print q{a #*@%-ing word\n};
     }


DESCRIPTION

    By default, this module exports a single hash (`%RE') that stores or
    generates commonly needed regular expressions. Patterns currently
    provided include:

	* balanced parentheses and brackets
	* delimited text (with escapes)
	* integers and floating-point numbers in any base (up to 36)
	* comments in 44 languages
    	* offensive language
	* lists of any pattern
	* IPv4 addresses
        * URIs.
        * Zip codes.

    Future releases of the module will also provide patterns for the
    following:

        * email addresses 
        * HTML/XML tags
        * mail headers (including multiline ones),
        * more URIs
        * telephone numbers of various countries
        * currency (universal 3 letter format, Latin-1, currency names)
        * dates
        * binary formats (e.g. UUencoded, MIMEd)


INSTALLATION

    It's all pure Perl, so just put the .pm files in their appropriate
    local Perl subdirectory.

    Alternatively, use the common approach:
        - untar the archive
        - run: perl Makefile.PL
        - run: make
        - run: make test
        - run: make install

AUTHOR

    Damian Conway (damian@cs.monash.edu.au)


MAINTAINER

    Abigail (regexp-common@abigail.nl)


COPYRIGHT

       Copyright (c) 1997-2003, Damian Conway. All Rights Reserved.
     This module is free software. It may be used, redistributed
     and/or modified under the terms of the Perl Artistic License
          (see http://www.perl.com/perl/misc/Artistic.html)



==============================================================================

CHANGES IN VERSION 2.107

Revision history for Perl extension Regexp::Common.

2.107 Fri Feb  7 23:20:35 2003
        - telnet URIs; Lua and FPL comments.
        - common code factored out - created t/Common.pm
        - 175984 tests in 32 files.
        - 91 patterns in 11 classes.

2.106 Sun Feb  2 18:42:08 2003
        - Makefile.PL fixes for Windows.

2.105 Sun Feb  2 04:15:54 2003  (In remembrance of the Columbia crew)
        - Australian postal codes.
        - Reorganized t/ directory by adding subdirectories.
        - 88 patterns in 11 classes.
        - 163355 tests in 31 files.

2.104 Fri Jan 24 16:44:19 2003
        - Forgot to add t/test_zip_german.t and t/test_zip_french.t
          to the MANIFEST file.

2.103 Thu Jan 23 03:21:17 2003
        - Added German and French postal codes.
        - Fixed some bugs concerning HTTP URIs.
        - Complete remake of t/test_uri_http, with 15k+ tests. 
          Extended testing exposed the now fixed bugs.
        - 87 patterns in 11 classes.
        - 156778 tests in 30 files.

1.30  Fri Jan 17 14:20:02 2003
        - Fixed a bug concerning HTTP and FTP URIs.
         (reported by Hermann-Marcus Behrens)

1.29  Thu Jan 16 12:07:02 2003
        - New since last release: Squares, Roman numbers, TV URIs,
          Palindromes, Dutch and US zip coded.
        - 131710 tests in 28 files.
          11 pattern classes.

1.20  Tue Aug 27 19:06:13 CEST 2002
        - Balanced patterns can now take multiple sets of arbitrary
          strings as delimiters.
        - Fax URIs.
        - More comment patterns.

0.09  Tue Aug  6 16:44:57 CEST 2002
        - Fixed $RE{URI}{tel}, local phone numbers can have
          future extensions as well.

0.08  Tue Aug  6 15:50:31 CEST 2002
        - Added tel URI regexes.

0.07  Mon Aug  5 14:31:17 CEST 2002
        - Fixed 'Regex::' and 'Rexexp::' typos.
        - Split t/test_uris.t into t/test_ftp_uri.t, t/test_http_uri.t
          and t/test_uris.t.

0.06  Mon Aug  5 00:56:19 CEST 2002
        - URI regexes. Currently only HTTP and FTP. More to come.

0.05  Thu Aug  1 12:01:04 CEST 2002
        - Improved the 'subs' method of MAC addresses.

0.04  Thu Aug  1 01:18:37 CEST 2002
        - Added the set of $RE{net}{MAC} regexes, by request of
          Iain Truskett <spoon@cpan.org>.
        - Required minimum Perl version for regexes for Haskell and
          Dylan comment, as they can be recursive.
        - Petdance suggested regexes for LOGO comments.

0.03  Wed Jul 31 15:21:11 CEST 2002
        - Made the entire setup more modular, giving each set of patterns
          its own .pm file. Loading all goes via Regexp::Common though.
        - use strict; everywhere - it also runs under -W (localized).
        - Added comment regexes for many more languages (26 currently).
        - Fixed some small bugs.

0.02  Tue Jul 23 23:18:15 2002
        - Added $RE{comment}{HTML}

0.01  Thu May 18 14:45:14 2000
	- original version; created by h2xs 1.18


==============================================================================

AVAILABILITY

Regexp::Common has been uploaded to the CPAN
and is also available from:

	http://www.csse.monash.edu.au/~damian/CPAN/Regexp-Common.tar.gz

==============================================================================
