From 582b500cd996c96054615870fd13d6ab0ea77428 Mon Sep 17 00:00:00 2001 From: Jay Berkenbilt Date: Sat, 10 Oct 2009 15:10:05 +0000 Subject: start integrating windows port git-svn-id: svn+q:///qpdf/trunk@757 71b93d88-0707-0410-a8cf-f5a4172ac649 --- external-libs/pcre/doc/perltest.txt | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 external-libs/pcre/doc/perltest.txt (limited to 'external-libs/pcre/doc/perltest.txt') diff --git a/external-libs/pcre/doc/perltest.txt b/external-libs/pcre/doc/perltest.txt new file mode 100644 index 00000000..9ea9d932 --- /dev/null +++ b/external-libs/pcre/doc/perltest.txt @@ -0,0 +1,34 @@ +The perltest program +-------------------- + +The perltest program tests Perl's regular expressions; it has the same +specification as pcretest, and so can be given identical input, except that +input patterns can be followed only by Perl's lower case modifiers and /+ (as +used by pcretest), which is recognized and handled by the program. + +The data lines are processed as Perl double-quoted strings, so if they contain +" \ $ or @ characters, these have to be escaped. For this reason, all such +characters in testinput1 and testinput3 are escaped so that they can be used +for perltest as well as for pcretest, and the special upper case modifiers such +as /A that pcretest recognizes are not used in these files. The output should +be identical, apart from the initial identifying banner. + +The perltest script can also test UTF-8 features. It works as is for Perl 5.8 +or higher. It recognizes the special modifier /8 that pcretest uses to invoke +UTF-8 functionality. The testinput5 file can be fed to perltest to run UTF-8 +tests. + +For Perl 5.6, perltest won't work unmodified for the UTF-8 tests. You need to +uncomment the "use utf8" lines that it contains. It is best to do this on a +copy of the script, because for non-UTF-8 tests, these lines should remain +commented out. + +The testinput2 and testinput4 files are not suitable for feeding to perltest, +since they do make use of the special upper case modifiers and escapes that +pcretest uses to test some features of PCRE. The first of these files also +contains malformed regular expressions, in order to check that PCRE diagnoses +them correctly. Similarly, testinput6 tests UTF-8 features that do not relate +to Perl. + +Philip Hazel +August 2002 -- cgit v1.2.3-54-g00ecf