README for DelimMatch version 1.06, 20 May 2003 DelimMatch allows you to match delimited substrings in a buffer. The delimiters can be specified with any regular expression and the start and end delimiters need not be the same. If the delimited text is properly nested, entire nested groups are returned. In addition, you may specify quoting and escaping characters that contribute to the recognition of start and end delimiters. For more detail, see the POD documentation in DelimMatch.pm CHANGES 2003/05/20: Released 1.06, fixed a couple of places where "/s" was missing from the regex, preventing multi-line matches from working correctly. 2002/10/02: Released 1.05, with the plan to actually upload this one to CPAN. No real changes from 1.04, just updates to documentation. 1999/04/14: Added returndelim() and strip_delim() methods to control whether or not the match returned includes the start and end delimiters. By default, delimiters are returned. 1997/10/27: Released version 1.03. Tweaked the documentation a little. Finally uploaded to PAUSE. NOTE: NestedMatch-1.03, uploaded on 10/25 WAS AN ERROR. Use this INSTEAD. 1997/07/03: Released version 1.02 Made -w clean 1997/07/02: Released version 1.01 Support for Perl 5.004. The scoping of $1, $2, etc. changed!? POD buglet Allow more arguments to constructor Released version 1.00 This module replaces Text::NestedMatch which was only ever in limited release (never in CPAN). PREREQUISITES DelimMatch is implemented as an object. It has no requirements beyond Perl 5.000. INSTALLATION This module is written entirely in Perl. There's nothing to build, and installation should be as simple as perl Makefile.PL make make test make install To install this module by hand, simply copy DelimMatch.pm to your Perl library directory. Test by running perl test.pl. CONTACTING THE AUTHOR The best way to reach me is by email to You will find additional contact information at http://nwalsh.com/ COPYRIGHT Copyright (C) 1997-2003 Norman Walsh. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. WARRANTY THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.