Contents of /code/trunk/NEWS

News about PCRE releases
------------------------

Release 3.0 01-Feb-00
---------------------

1. A "configure" script is now used to configure PCRE for Unix systems. It
builds a Makefile, a config.h file, and the pcre-config script.

2. PCRE is built as a shared library by default.

3. There is support for POSIX classes such as [:alpha:].

5. There is an experimental recursion feature.

----------------------------------------------------------------------------
          IMPORTANT FOR THOSE UPGRADING FROM VERSIONS BEFORE 2.00

Please note that there has been a change in the API such that a larger
ovector is required at matching time, to provide some additional workspace.
The new man page has details. This change was necessary in order to support
some of the new functionality in Perl 5.005.

          IMPORTANT FOR THOSE UPGRADING FROM VERSION 2.00

Another (I hope this is the last!) change has been made to the API for the
pcre_compile() function. An additional argument has been added to make it
possible to pass over a pointer to character tables built in the current
locale by pcre_maketables(). To use the default tables, this new arguement
should be passed as NULL.

          IMPORTANT FOR THOSE UPGRADING FROM VERSION 2.05

Yet another (and again I hope this really is the last) change has been made
to the API for the pcre_exec() function. An additional argument has been
added to make it possible to start the match other than at the start of the
subject string. This is important if there are lookbehinds. The new man
page has the details, but you just want to convert existing programs, all
you need to do is to stick in a new fifth argument to pcre_exec(), with a
value of zero. For example, change

  pcre_exec(pattern, extra, subject, length, options, ovec, ovecsize)
to
  pcre_exec(pattern, extra, subject, length, 0, options, ovec, ovecsize)

****
1	nigel	41	News about PCRE releases
2			------------------------
3
4	nigel	43	Release 3.0 01-Feb-00
5			---------------------
6	nigel	41
7	nigel	43	1. A "configure" script is now used to configure PCRE for Unix systems. It
8			builds a Makefile, a config.h file, and the pcre-config script.
9
10			2. PCRE is built as a shared library by default.
11
12			3. There is support for POSIX classes such as [:alpha:].
13
14			5. There is an experimental recursion feature.
15
16	nigel	41	----------------------------------------------------------------------------
17			IMPORTANT FOR THOSE UPGRADING FROM VERSIONS BEFORE 2.00
18
19			Please note that there has been a change in the API such that a larger
20			ovector is required at matching time, to provide some additional workspace.
21			The new man page has details. This change was necessary in order to support
22			some of the new functionality in Perl 5.005.
23
24			IMPORTANT FOR THOSE UPGRADING FROM VERSION 2.00
25
26			Another (I hope this is the last!) change has been made to the API for the
27			pcre_compile() function. An additional argument has been added to make it
28			possible to pass over a pointer to character tables built in the current
29			locale by pcre_maketables(). To use the default tables, this new arguement
30			should be passed as NULL.
31
32			IMPORTANT FOR THOSE UPGRADING FROM VERSION 2.05
33
34			Yet another (and again I hope this really is the last) change has been made
35			to the API for the pcre_exec() function. An additional argument has been
36			added to make it possible to start the match other than at the start of the
37			subject string. This is important if there are lookbehinds. The new man
38			page has the details, but you just want to convert existing programs, all
39			you need to do is to stick in a new fifth argument to pcre_exec(), with a
40			value of zero. For example, change
41
42			pcre_exec(pattern, extra, subject, length, options, ovec, ovecsize)
43			to
44			pcre_exec(pattern, extra, subject, length, 0, options, ovec, ovecsize)
45
46			****