Contents of /code/trunk/NEWS

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

Release 3.5 15-Aug-01
---------------------

1. The configuring system has been upgraded to use later versions of autoconf
and libtool. By default it builds both a shared and a static library if the OS
supports it. You can use --disable-shared or --disable-static on the configure
command if you want only one of them.

2. The pcretest utility is now installed along with pcregrep because it is
useful for users (to test regexs) and by doing this, it automatically gets
relinked by libtool. The documentation has been turned into a man page, so
there are now .1, .txt, and .html versions in /doc.

3. Upgrades to pcregrep:
   (i)   Added long-form option names like gnu grep.
   (ii)  Added --help to list all options with an explanatory phrase.
   (iii) Added -r, --recursive to recurse into sub-directories.
   (iv)  Added -f, --file to read patterns from a file.

4. Added --enable-newline-is-cr and --enable-newline-is-lf to the configure
script, to force use of CR or LF instead of \n in the source. On non-Unix
systems, the value can be set in config.h.

5. The limit of 200 on non-capturing parentheses is a _nesting_ limit, not an
absolute limit. Changed the text of the error message to make this clear, and
likewise updated the man page.

6. The limit of 99 on the number of capturing subpatterns has been removed.
The new limit is 65535, which I hope will not be a "real" limit.


Release 3.3 01-Aug-00
---------------------

There is some support for UTF-8 character strings. This is incomplete and
experimental. The documentation describes what is and what is not implemented.
Otherwise, this is just a bug-fixing release.


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	News about PCRE releases
2	------------------------
3
4	Release 3.5 15-Aug-01
5	---------------------
6
7	1. The configuring system has been upgraded to use later versions of autoconf
8	and libtool. By default it builds both a shared and a static library if the OS
9	supports it. You can use --disable-shared or --disable-static on the configure
10	command if you want only one of them.
11
12	2. The pcretest utility is now installed along with pcregrep because it is
13	useful for users (to test regexs) and by doing this, it automatically gets
14	relinked by libtool. The documentation has been turned into a man page, so
15	there are now .1, .txt, and .html versions in /doc.
16
17	3. Upgrades to pcregrep:
18	(i) Added long-form option names like gnu grep.
19	(ii) Added --help to list all options with an explanatory phrase.
20	(iii) Added -r, --recursive to recurse into sub-directories.
21	(iv) Added -f, --file to read patterns from a file.
22
23	4. Added --enable-newline-is-cr and --enable-newline-is-lf to the configure
24	script, to force use of CR or LF instead of \n in the source. On non-Unix
25	systems, the value can be set in config.h.
26
27	5. The limit of 200 on non-capturing parentheses is a _nesting_ limit, not an
28	absolute limit. Changed the text of the error message to make this clear, and
29	likewise updated the man page.
30
31	6. The limit of 99 on the number of capturing subpatterns has been removed.
32	The new limit is 65535, which I hope will not be a "real" limit.
33
34
35	Release 3.3 01-Aug-00
36	---------------------
37
38	There is some support for UTF-8 character strings. This is incomplete and
39	experimental. The documentation describes what is and what is not implemented.
40	Otherwise, this is just a bug-fixing release.
41
42
43	Release 3.0 01-Feb-00
44	---------------------
45
46	1. A "configure" script is now used to configure PCRE for Unix systems. It
47	builds a Makefile, a config.h file, and the pcre-config script.
48
49	2. PCRE is built as a shared library by default.
50
51	3. There is support for POSIX classes such as [:alpha:].
52
53	5. There is an experimental recursion feature.
54
55	----------------------------------------------------------------------------
56	IMPORTANT FOR THOSE UPGRADING FROM VERSIONS BEFORE 2.00
57
58	Please note that there has been a change in the API such that a larger
59	ovector is required at matching time, to provide some additional workspace.
60	The new man page has details. This change was necessary in order to support
61	some of the new functionality in Perl 5.005.
62
63	IMPORTANT FOR THOSE UPGRADING FROM VERSION 2.00
64
65	Another (I hope this is the last!) change has been made to the API for the
66	pcre_compile() function. An additional argument has been added to make it
67	possible to pass over a pointer to character tables built in the current
68	locale by pcre_maketables(). To use the default tables, this new arguement
69	should be passed as NULL.
70
71	IMPORTANT FOR THOSE UPGRADING FROM VERSION 2.05
72
73	Yet another (and again I hope this really is the last) change has been made
74	to the API for the pcre_exec() function. An additional argument has been
75	added to make it possible to start the match other than at the start of the
76	subject string. This is important if there are lookbehinds. The new man
77	page has the details, but you just want to convert existing programs, all
78	you need to do is to stick in a new fifth argument to pcre_exec(), with a
79	value of zero. For example, change
80
81	pcre_exec(pattern, extra, subject, length, options, ovec, ovecsize)
82	to
83	pcre_exec(pattern, extra, subject, length, 0, options, ovec, ovecsize)
84
85	****