1 |
ChangeLog for PCRE |
ChangeLog for PCRE |
2 |
------------------ |
------------------ |
3 |
|
|
4 |
Version 7.9 xx-xxx-09 |
Version 8.00 ??-???-?? |
5 |
|
---------------------- |
6 |
|
|
7 |
|
1. The table for translating pcre_compile() error codes into POSIX error codes |
8 |
|
was out-of-date, and there was no check on the pcre_compile() error code |
9 |
|
being within the table. This could lead to an OK return being given in |
10 |
|
error. |
11 |
|
|
12 |
|
2. Changed the call to open a subject file in pcregrep from fopen(pathname, |
13 |
|
"r") to fopen(pathname, "rb"), which fixed a problem with some of the tests |
14 |
|
in a Windows environment. |
15 |
|
|
16 |
|
3. The pcregrep --count option prints the count for each file even when it is |
17 |
|
zero, as does GNU grep. However, pcregrep was also printing all files when |
18 |
|
--files-with-matches was added. Now, when both options are given, it prints |
19 |
|
counts only for those files that have at least one match. (GNU grep just |
20 |
|
prints the file name in this circumstance, but including the count seems |
21 |
|
more useful - otherwise, why use --count?) Also ensured that the |
22 |
|
combination -clh just lists non-zero counts, with no names. |
23 |
|
|
24 |
|
4. The long form of the pcregrep -F option was incorrectly implemented as |
25 |
|
--fixed_strings instead of --fixed-strings. This is an incompatible change, |
26 |
|
but it seems right to fix it, and I didn't think it was worth preserving |
27 |
|
the old behaviour. |
28 |
|
|
29 |
|
5. The command line items --regex=pattern and --regexp=pattern were not |
30 |
|
recognized by pcregrep, which required --regex pattern or --regexp pattern |
31 |
|
(with a space rather than an '='). The man page documented the '=' forms, |
32 |
|
which are compatible with GNU grep; these now work. |
33 |
|
|
34 |
|
6. No libpcreposix.pc file was created for pkg-config; there was just |
35 |
|
libpcre.pc and libpcrecpp.pc. The omission has been rectified. |
36 |
|
|
37 |
|
7. Added #ifndef SUPPORT_UCP into the pcre_ucd.c module, to reduce its size |
38 |
|
when UCP support is not needed, by modifying the Python script that |
39 |
|
generates it from Unicode data files. This should not matter if the module |
40 |
|
is correctly used as a library, but I received one complaint about 50K of |
41 |
|
unwanted data. My guess is that the person linked everything into his |
42 |
|
program rather than using a library. Anyway, it does no harm. |
43 |
|
|
44 |
|
8. A pattern such as /\x{123}{2,2}+/8 was incorrectly compiled; the trigger |
45 |
|
was a minimum greater than 1 for a wide character in a possessive |
46 |
|
repetition. The same bug could also affect patterns like /(\x{ff}{0,2})*/8 |
47 |
|
which had an unlimited repeat of a nested, fixed maximum repeat of a wide |
48 |
|
character. Chaos in the form of incorrect output or a compiling loop could |
49 |
|
result. |
50 |
|
|
51 |
|
9. The restrictions on what a pattern can contain when partial matching is |
52 |
|
requested for pcre_exec() have been removed. All patterns can now be |
53 |
|
partially matched by this function. In addition, if there are at least two |
54 |
|
slots in the offset vector, the offset of the earliest inspected character |
55 |
|
for the match and the offset of the end of the subject are set in them when |
56 |
|
PCRE_ERROR_PARTIAL is returned. |
57 |
|
|
58 |
|
10. Partial matching has been split into two forms: PCRE_PARTIAL_SOFT, which is |
59 |
|
synonymous with PCRE_PARTIAL, for backwards compatibility, and |
60 |
|
PCRE_PARTIAL_HARD, which causes a partial match to supersede a full match, |
61 |
|
and may be more useful for multi-segment matching, especially with |
62 |
|
pcre_exec(). |
63 |
|
|
64 |
|
11. Partial matching with pcre_exec() is now more intuitive. A partial match |
65 |
|
used to be given if ever the end of the subject was reached; now it is |
66 |
|
given only if matching could not proceed because another character was |
67 |
|
needed. This makes a difference in some odd cases such as Z(*FAIL) with the |
68 |
|
string "Z", which now yields "no match" instead of "partial match". In the |
69 |
|
case of pcre_dfa_exec(), "no match" is given if every matching path for the |
70 |
|
final character ended with (*FAIL). |
71 |
|
|
72 |
|
12. Restarting a match using pcre_dfa_exec() after a partial match did not work |
73 |
|
if the pattern had a "must contain" character that was already found in the |
74 |
|
earlier partial match, unless partial matching was again requested. For |
75 |
|
example, with the pattern /dog.(body)?/, the "must contain" character is |
76 |
|
"g". If the first part-match was for the string "dog", restarting with |
77 |
|
"sbody" failed. This bug has been fixed. |
78 |
|
|
79 |
|
13. The string returned by pcre_dfa_exec() after a partial match has been |
80 |
|
changed so that it starts at the first inspected character rather than the |
81 |
|
first character of the match. This makes a difference only if the pattern |
82 |
|
starts with a lookbehind assertion or \b or \B (\K is not supported by |
83 |
|
pcre_dfa_exec()). It's an incompatible change, but it makes the two |
84 |
|
matching functions compatible, and I think it's the right thing to do. |
85 |
|
|
86 |
|
14. Added a pcredemo man page, created automatically from the pcredemo.c file, |
87 |
|
so that the demonstration program is easily available in environments where |
88 |
|
PCRE has not been installed from source. |
89 |
|
|
90 |
|
15. Arranged to add -DPCRE_STATIC to cflags in libpcre.pc, libpcreposix.cp, |
91 |
|
libpcrecpp.pc and pcre-config when PCRE is not compiled as a shared |
92 |
|
library. |
93 |
|
|
94 |
|
16. Added REG_UNGREEDY to the pcreposix interface, at the request of a user. |
95 |
|
It maps to PCRE_UNGREEDY. It is not, of course, POSIX-compatible, but it |
96 |
|
is not the first non-POSIX option to be added. Clearly some people find |
97 |
|
these options useful. |
98 |
|
|
99 |
|
17. If a caller to the POSIX matching function regexec() passes a non-zero |
100 |
|
value for nmatch with a NULL value for pmatch, the value of |
101 |
|
nmatch is forced to zero. |
102 |
|
|
103 |
|
18. RunGrepTest did not have a test for the availability of the -u option of |
104 |
|
the diff command, as RunTest does. It now checks in the same way as |
105 |
|
RunTest, and also checks for the -b option. |
106 |
|
|
107 |
|
19. If an odd number of negated classes containing just a single character |
108 |
|
interposed, within parentheses, between a forward reference to a named |
109 |
|
subpattern and the definition of the subpattern, compilation crashed with |
110 |
|
an internal error, complaining that it could not find the referenced |
111 |
|
subpattern. An example of a crashing pattern is /(?&A)(([^m])(?<A>))/. |
112 |
|
[The bug was that it was starting one character too far in when skipping |
113 |
|
over the character class, thus treating the ] as data rather than |
114 |
|
terminating the class. This meant it could skip too much.] |
115 |
|
|
116 |
|
20. Added PCRE_NOTEMPTY_ATSTART in order to be able to correctly implement the |
117 |
|
/g option in pcretest when the pattern contains \K, which makes it possible |
118 |
|
to have an empty string match not at the start, even when the pattern is |
119 |
|
anchored. Updated pcretest and pcredemo to use this option. |
120 |
|
|
121 |
|
21. If the maximum number of capturing subpatterns in a recursion was greater |
122 |
|
than the maximum at the outer level, the higher number was returned, but |
123 |
|
with unset values at the outer level. The correct (outer level) value is |
124 |
|
now given. |
125 |
|
|
126 |
|
22. If (*ACCEPT) appeared inside capturing parentheses, previous releases of |
127 |
|
PCRE did not set those parentheses (unlike Perl). I have now found a way to |
128 |
|
make it do so. The string so far is captured, making this feature |
129 |
|
compatible with Perl. |
130 |
|
|
131 |
|
|
132 |
|
Version 7.9 11-Apr-09 |
133 |
--------------------- |
--------------------- |
134 |
|
|
135 |
1. When building with support for bzlib/zlib (pcregrep) and/or readline |
1. When building with support for bzlib/zlib (pcregrep) and/or readline |
145 |
but BOOL is not. |
but BOOL is not. |
146 |
|
|
147 |
3. The pcre_config() function was treating the PCRE_MATCH_LIMIT and |
3. The pcre_config() function was treating the PCRE_MATCH_LIMIT and |
148 |
PCRE_MATCH_LIMIT_RETURSION values as ints, when they should be long ints. |
PCRE_MATCH_LIMIT_RECURSION values as ints, when they should be long ints. |
149 |
|
|
150 |
4. The pcregrep documentation said spaces were inserted as well as colons (or |
4. The pcregrep documentation said spaces were inserted as well as colons (or |
151 |
hyphens) following file names and line numbers when outputting matching |
hyphens) following file names and line numbers when outputting matching |
170 |
correctly handled. The rule now is that both the assertion and what follows |
correctly handled. The rule now is that both the assertion and what follows |
171 |
in the first alternative must satisfy the test. |
in the first alternative must satisfy the test. |
172 |
|
|
173 |
9. If auto-callout was enabled in a pattern with a conditional group whose |
9. If auto-callout was enabled in a pattern with a conditional group whose |
174 |
condition was an assertion, PCRE could crash during matching, both with |
condition was an assertion, PCRE could crash during matching, both with |
175 |
pcre_exec() and pcre_dfa_exec(). |
pcre_exec() and pcre_dfa_exec(). |
176 |
|
|
192 |
17. Implemented support for UTF-8 encoding in EBCDIC environments, a patch |
17. Implemented support for UTF-8 encoding in EBCDIC environments, a patch |
193 |
from Martin Jerabek that uses macro names for all relevant character and |
from Martin Jerabek that uses macro names for all relevant character and |
194 |
string constants. |
string constants. |
195 |
|
|
196 |
18. Added to pcre_internal.h two configuration checks: (a) If both EBCDIC and |
18. Added to pcre_internal.h two configuration checks: (a) If both EBCDIC and |
197 |
SUPPORT_UTF8 are set, give an error; (b) If SUPPORT_UCP is set without |
SUPPORT_UTF8 are set, give an error; (b) If SUPPORT_UCP is set without |
198 |
SUPPORT_UTF8, define SUPPORT_UTF8. The "configure" script handles both of |
SUPPORT_UTF8, define SUPPORT_UTF8. The "configure" script handles both of |
199 |
these, but not everybody uses configure. |
these, but not everybody uses configure. |
200 |
|
|
201 |
19. A conditional group that had only one branch was not being correctly |
19. A conditional group that had only one branch was not being correctly |
202 |
recognized as an item that could match an empty string. This meant that an |
recognized as an item that could match an empty string. This meant that an |
203 |
enclosing group might also not be so recognized, causing infinite looping |
enclosing group might also not be so recognized, causing infinite looping |
204 |
(and probably a segfault) for patterns such as ^"((?(?=[a])[^"])|b)*"$ |
(and probably a segfault) for patterns such as ^"((?(?=[a])[^"])|b)*"$ |
205 |
with the subject "ab", where knowledge that the repeated group can match |
with the subject "ab", where knowledge that the repeated group can match |
206 |
nothing is needed in order to break the loop. |
nothing is needed in order to break the loop. |
207 |
|
|
208 |
20. If a pattern that was compiled with callouts was matched using pcre_dfa_ |
20. If a pattern that was compiled with callouts was matched using pcre_dfa_ |
209 |
exec(), but without supplying a callout function, matching went wrong. |
exec(), but without supplying a callout function, matching went wrong. |
210 |
|
|
211 |
21. If PCRE_ERROR_MATCHLIMIT occurred during a recursion, there was a memory |
21. If PCRE_ERROR_MATCHLIMIT occurred during a recursion, there was a memory |
212 |
leak if the size of the offset vector was greater than 30. When the vector |
leak if the size of the offset vector was greater than 30. When the vector |
213 |
is smaller, the saved offsets during recursion go onto a local stack |
is smaller, the saved offsets during recursion go onto a local stack |
214 |
vector, but for larger vectors malloc() is used. It was failing to free |
vector, but for larger vectors malloc() is used. It was failing to free |
215 |
when the recursion yielded PCRE_ERROR_MATCH_LIMIT (or any other "abnormal" |
when the recursion yielded PCRE_ERROR_MATCH_LIMIT (or any other "abnormal" |
216 |
error, in fact). |
error, in fact). |
217 |
|
|
218 |
|
22. There was a missing #ifdef SUPPORT_UTF8 round one of the variables in the |
219 |
|
heapframe that is used only when UTF-8 support is enabled. This caused no |
220 |
|
problem, but was untidy. |
221 |
|
|
222 |
|
23. Steven Van Ingelgem's patch to CMakeLists.txt to change the name |
223 |
|
CMAKE_BINARY_DIR to PROJECT_BINARY_DIR so that it works when PCRE is |
224 |
|
included within another project. |
225 |
|
|
226 |
|
24. Steven Van Ingelgem's patches to add more options to the CMake support, |
227 |
|
slightly modified by me: |
228 |
|
|
229 |
|
(a) PCRE_BUILD_TESTS can be set OFF not to build the tests, including |
230 |
|
not building pcregrep. |
231 |
|
|
232 |
|
(b) PCRE_BUILD_PCREGREP can be see OFF not to build pcregrep, but only |
233 |
|
if PCRE_BUILD_TESTS is also set OFF, because the tests use pcregrep. |
234 |
|
|
235 |
|
25. Forward references, both numeric and by name, in patterns that made use of |
236 |
|
duplicate group numbers, could behave incorrectly or give incorrect errors, |
237 |
|
because when scanning forward to find the reference group, PCRE was not |
238 |
|
taking into account the duplicate group numbers. A pattern such as |
239 |
|
^X(?3)(a)(?|(b)|(q))(Y) is an example. |
240 |
|
|
241 |
|
26. Changed a few more instances of "const unsigned char *" to USPTR, making |
242 |
|
the feature of a custom pointer more persuasive (as requested by a user). |
243 |
|
|
244 |
|
27. Wrapped the definitions of fileno and isatty for Windows, which appear in |
245 |
|
pcretest.c, inside #ifndefs, because it seems they are sometimes already |
246 |
|
pre-defined. |
247 |
|
|
248 |
|
28. Added support for (*UTF8) at the start of a pattern. |
249 |
|
|
250 |
|
29. Arrange for flags added by the "release type" setting in CMake to be shown |
251 |
|
in the configuration summary. |
252 |
|
|
253 |
|
|
254 |
Version 7.8 05-Sep-08 |
Version 7.8 05-Sep-08 |
255 |
--------------------- |
--------------------- |