Annotation of win32/pcre/NEWS, revision 1.9

1.1       misha       1: News about PCRE releases
                      2: ------------------------
                      3: 
1.9     ! moko        4: Note that this library (now called PCRE1) is now being maintained for bug fixes
        !             5: only. New projects are advised to use the new PCRE2 libraries.
        !             6: 
        !             7: 
        !             8: Release 8.43 23-February-2019
        !             9: -----------------------------
        !            10: 
        !            11: This is a bug-fix release.
        !            12: 
        !            13: 
        !            14: Release 8.42 20-March-2018
        !            15: --------------------------
        !            16: 
        !            17: This is a bug-fix release.
        !            18: 
        !            19: 
        !            20: Release 8.41 13-June-2017
        !            21: -------------------------
        !            22: 
        !            23: This is a bug-fix release.
        !            24: 
        !            25: 
        !            26: Release 8.40 11-January-2017
        !            27: ----------------------------
        !            28: 
        !            29: This is a bug-fix release.
        !            30: 
        !            31: 
        !            32: Release 8.39 14-June-2016
        !            33: -------------------------
        !            34: 
        !            35: Some appropriate PCRE2 JIT improvements have been retro-fitted to PCRE1. Apart
        !            36: from that, this is another bug-fix release. Note that this library (now called
        !            37: PCRE1) is now being maintained for bug fixes only. New projects are advised to
        !            38: use the new PCRE2 libraries.
        !            39: 
        !            40: 
        !            41: Release 8.38 23-November-2015
        !            42: -----------------------------
        !            43: 
        !            44: This is bug-fix release. Note that this library (now called PCRE1) is now being
        !            45: maintained for bug fixes only. New projects are advised to use the new PCRE2
        !            46: libraries.
        !            47: 
        !            48: 
1.8       moko       49: Release 8.37 28-April-2015
                     50: --------------------------
                     51: 
                     52: This is bug-fix release. Note that this library (now called PCRE1) is now being
                     53: maintained for bug fixes only. New projects are advised to use the new PCRE2
                     54: libraries.
                     55: 
                     56: 
                     57: Release 8.36 26-September-2014
                     58: ------------------------------
                     59: 
                     60: This is primarily a bug-fix release. However, in addition, the Unicode data
                     61: tables have been updated to Unicode 7.0.0.
                     62: 
                     63: 
                     64: Release 8.35 04-April-2014
                     65: --------------------------
                     66: 
                     67: There have been performance improvements for classes containing non-ASCII
                     68: characters and the "auto-possessification" feature has been extended. Other
                     69: minor improvements have been implemented and bugs fixed. There is a new callout
                     70: feature to enable applications to do detailed stack checks at compile time, to
                     71: avoid running out of stack for deeply nested parentheses. The JIT compiler has
                     72: been extended with experimental support for ARM-64, MIPS-64, and PPC-LE.
                     73: 
                     74: 
                     75: Release 8.34 15-December-2013
                     76: -----------------------------
                     77: 
                     78: As well as fixing the inevitable bugs, performance has been improved by
                     79: refactoring and extending the amount of "auto-possessification" that PCRE does.
                     80: Other notable changes:
                     81: 
                     82: .  Implemented PCRE_INFO_MATCH_EMPTY, which yields 1 if the pattern can match
                     83:    an empty string. If it can, pcretest shows this in its information output.
                     84: 
                     85: .  A back reference to a named subpattern when there is more than one of the
                     86:    same name now checks them in the order in which they appear in the pattern.
                     87:    The first one that is set is used for the reference. Previously only the
                     88:    first one was inspected. This change makes PCRE more compatible with Perl.
                     89: 
                     90: .  Unicode character properties were updated from Unicode 6.3.0.
                     91: 
                     92: .  The character VT has been added to the set of characters that match \s and
                     93:    are generally treated as white space, following this same change in Perl
                     94:    5.18. There is now no difference between "Perl space" and "POSIX space".
                     95: 
                     96: .  Perl has changed its handling of \8 and \9. If there is no previously
                     97:    encountered capturing group of those numbers, they are treated as the
                     98:    literal characters 8 and 9 instead of a binary zero followed by the
                     99:    literals. PCRE now does the same.
                    100: 
                    101: .  Following Perl, added \o{} to specify codepoints in octal, making it
                    102:    possible to specify values greater than 0777 and also making them
                    103:    unambiguous.
                    104: 
                    105: .  In UCP mode, \s was not matching two of the characters that Perl matches,
                    106:    namely NEL (U+0085) and MONGOLIAN VOWEL SEPARATOR (U+180E), though they
                    107:    were matched by \h.
                    108: 
                    109: .  Add JIT support for the 64 bit TileGX architecture.
                    110: 
                    111: .  Upgraded the handling of the POSIX classes [:graph:], [:print:], and
                    112:    [:punct:] when PCRE_UCP is set so as to include the same characters as Perl
                    113:    does in Unicode mode.
                    114: 
                    115: .  Perl no longer allows group names to start with digits, so I have made this
                    116:    change also in PCRE.
                    117: 
                    118: .  Added support for [[:<:]] and [[:>:]] as used in the BSD POSIX library to
                    119:    mean "start of word" and "end of word", respectively, as a transition aid.
                    120: 
                    121: 
1.7       misha     122: Release 8.33 28-May-2013
                    123: --------------------------
                    124: 
                    125: A number of bugs are fixed, and some performance improvements have been made.
                    126: There are also some new features, of which these are the most important:
                    127: 
                    128: .  The behaviour of the backtracking verbs has been rationalized and
                    129:    documented in more detail.
                    130: 
                    131: .  JIT now supports callouts and all of the backtracking verbs.
                    132: 
                    133: .  Unicode validation has been updated in the light of Unicode Corrigendum #9,
                    134:    which points out that "non characters" are not "characters that may not
                    135:    appear in Unicode strings" but rather "characters that are reserved for
                    136:    internal use and have only local meaning".
                    137: 
                    138: .  (*LIMIT_MATCH=d) and (*LIMIT_RECURSION=d) have been added so that the
                    139:    creator of a pattern can specify lower (but not higher) limits for the
                    140:    matching process.
                    141: 
                    142: .  The PCRE_NEVER_UTF option is available to prevent pattern-writers from using
                    143:    the (*UTF) feature, as this could be a security issue.
                    144: 
                    145: 
                    146: Release 8.32 30-November-2012
                    147: -----------------------------
                    148: 
                    149: This release fixes a number of bugs, but also has some new features. These are
                    150: the highlights:
                    151: 
                    152: .  There is now support for 32-bit character strings and UTF-32. Like the
                    153:    16-bit support, this is done by compiling a separate 32-bit library.
                    154: 
                    155: .  \X now matches a Unicode extended grapheme cluster.
                    156: 
                    157: .  Case-independent matching of Unicode characters that have more than one
                    158:    "other case" now makes all three (or more) characters equivalent. This
                    159:    applies, for example, to Greek Sigma, which has two lowercase versions.
                    160: 
                    161: .  Unicode character properties are updated to Unicode 6.2.0.
                    162: 
                    163: .  The EBCDIC support, which had decayed, has had a spring clean.
                    164: 
                    165: .  A number of JIT optimizations have been added, which give faster JIT
                    166:    execution speed. In addition, a new direct interface to JIT execution is
                    167:    available. This bypasses some of the sanity checks of pcre_exec() to give a
                    168:    noticeable speed-up.
                    169: 
                    170: .  A number of issues in pcregrep have been fixed, making it more compatible
                    171:    with GNU grep. In particular, --exclude and --include (and variants) apply
                    172:    to all files now, not just those obtained from scanning a directory
                    173:    recursively. In Windows environments, the default action for directories is
                    174:    now "skip" instead of "read" (which provokes an error).
                    175: 
                    176: .  If the --only-matching (-o) option in pcregrep is specified multiple
                    177:    times, each one causes appropriate output. For example, -o1 -o2 outputs the
                    178:    substrings matched by the 1st and 2nd capturing parentheses. A separating
                    179:    string can be specified by --om-separator (default empty).
                    180: 
                    181: .  When PCRE is built via Autotools using a version of gcc that has the
                    182:    "visibility" feature, it is used to hide internal library functions that are
                    183:    not part of the public API.
                    184: 
                    185: 
                    186: Release 8.31 06-July-2012
                    187: -------------------------
                    188: 
                    189: This is mainly a bug-fixing release, with a small number of developments:
                    190: 
                    191: . The JIT compiler now supports partial matching and the (*MARK) and
                    192:   (*COMMIT) verbs.
                    193: 
                    194: . PCRE_INFO_MAXLOOKBEHIND can be used to find the longest lookbehind in a
                    195:   pattern.
                    196: 
                    197: . There should be a performance improvement when using the heap instead of the
                    198:   stack for recursion.
                    199: 
                    200: . pcregrep can now be linked with libedit as an alternative to libreadline.
                    201: 
                    202: . pcregrep now has a --file-list option where the list of files to scan is
                    203:   given as a file.
                    204: 
                    205: . pcregrep now recognizes binary files and there are related options.
                    206: 
                    207: . The Unicode tables have been updated to 6.1.0.
                    208: 
                    209: As always, the full list of changes is in the ChangeLog file.
                    210: 
                    211: 
1.6       misha     212: Release 8.30 04-February-2012
                    213: -----------------------------
                    214: 
                    215: Release 8.30 introduces a major new feature: support for 16-bit character
                    216: strings, compiled as a separate library. There are a few changes to the
                    217: 8-bit library, in addition to some bug fixes.
                    218: 
                    219: . The pcre_info() function, which has been obsolete for over 10 years, has
                    220:   been removed.
                    221: 
                    222: . When a compiled pattern was saved to a file and later reloaded on a host
                    223:   with different endianness, PCRE used automatically to swap the bytes in some
                    224:   of the data fields. With the advent of the 16-bit library, where more of this
                    225:   swapping is needed, it is no longer done automatically. Instead, the bad
                    226:   endianness is detected and a specific error is given. The user can then call
                    227:   a new function called pcre_pattern_to_host_byte_order() (or an equivalent
                    228:   16-bit function) to do the swap.
                    229: 
                    230: . In UTF-8 mode, the values 0xd800 to 0xdfff are not legal Unicode
                    231:   code points and are now faulted. (They are the so-called "surrogates"
                    232:   that are reserved for coding high values in UTF-16.)
                    233: 
                    234: 
                    235: Release 8.21 12-Dec-2011
                    236: ------------------------
                    237: 
                    238: This is almost entirely a bug-fix release. The only new feature is the ability
                    239: to obtain the size of the memory used by the JIT compiler.
                    240: 
                    241: 
                    242: Release 8.20 21-Oct-2011
                    243: ------------------------
                    244: 
                    245: The main change in this release is the inclusion of Zoltan Herczeg's
                    246: just-in-time compiler support, which can be accessed by building PCRE with
                    247: --enable-jit. Large performance benefits can be had in many situations. 8.20
                    248: also fixes an unfortunate bug that was introduced in 8.13 as well as tidying up
                    249: a number of infelicities and differences from Perl.
                    250: 
                    251: 
                    252: Release 8.13 16-Aug-2011
                    253: ------------------------
                    254: 
                    255: This is mainly a bug-fix release. There has been a lot of internal refactoring.
                    256: The Unicode tables have been updated. The only new feature in the library is
                    257: the passing of *MARK information to callouts. Some additions have been made to
                    258: pcretest to make testing easier and more comprehensive. There is a new option
                    259: for pcregrep to adjust its internal buffer size.
                    260: 
                    261: 
1.5       misha     262: Release 8.12 15-Jan-2011
                    263: ------------------------
                    264: 
                    265: This release fixes some bugs in pcregrep, one of which caused the tests to fail
                    266: on 64-bit big-endian systems. There are no changes to the code of the library.
                    267: 
                    268: 
                    269: Release 8.11 10-Dec-2010
                    270: ------------------------
                    271: 
                    272: A number of bugs in the library and in pcregrep have been fixed. As always, see
                    273: ChangeLog for details. The following are the non-bug-fix changes:
                    274: 
                    275: . Added --match-limit and --recursion-limit to pcregrep.
                    276: 
                    277: . Added an optional parentheses number to the -o and --only-matching options
                    278:   of pcregrep.
                    279: 
                    280: . Changed the way PCRE_PARTIAL_HARD affects the matching of $, \z, \Z, \b, and
                    281:   \B.
                    282: 
                    283: . Added PCRE_ERROR_SHORTUTF8 to make it possible to distinguish between a
                    284:   bad UTF-8 sequence and one that is incomplete when using PCRE_PARTIAL_HARD.
                    285: 
                    286: . Recognize (*NO_START_OPT) at the start of a pattern to set the PCRE_NO_
                    287:   START_OPTIMIZE option, which is now allowed at compile time
                    288: 
                    289: 
1.4       misha     290: Release 8.10 25-Jun-2010
                    291: ------------------------
                    292: 
                    293: There are two major additions: support for (*MARK) and friends, and the option
                    294: PCRE_UCP, which changes the behaviour of \b, \d, \s, and \w (and their
                    295: opposites) so that they make use of Unicode properties. There are also a number
                    296: of lesser new features, and several bugs have been fixed. A new option,
                    297: --line-buffered, has been added to pcregrep, for use when it is connected to
                    298: pipes.
                    299: 
                    300: 
                    301: Release 8.02 19-Mar-2010
                    302: ------------------------
                    303: 
                    304: Another bug-fix release.
                    305: 
                    306: 
                    307: Release 8.01 19-Jan-2010
                    308: ------------------------
                    309: 
                    310: This is a bug-fix release. Several bugs in the code itself and some bugs and
                    311: infelicities in the build system have been fixed.
                    312: 
                    313: 
                    314: Release 8.00 19-Oct-09
                    315: ----------------------
                    316: 
                    317: Bugs have been fixed in the library and in pcregrep. There are also some
                    318: enhancements. Restrictions on patterns used for partial matching have been
                    319: removed, extra information is given for partial matches, the partial matching
                    320: process has been improved, and an option to make a partial match override a
                    321: full match is available. The "study" process has been enhanced by finding a
                    322: lower bound matching length. Groups with duplicate numbers may now have
                    323: duplicated names without the use of PCRE_DUPNAMES. However, they may not have
                    324: different names. The documentation has been revised to reflect these changes.
                    325: The version number has been expanded to 3 digits as it is clear that the rate
                    326: of change is not slowing down.
                    327: 
                    328: 
1.3       misha     329: Release 7.9 11-Apr-09
                    330: ---------------------
                    331: 
                    332: Mostly bugfixes and tidies with just a couple of minor functional additions.
                    333: 
1.1       misha     334: 
1.2       misha     335: Release 7.8 05-Sep-08
                    336: ---------------------
                    337: 
                    338: More bug fixes, plus a performance improvement in Unicode character property
                    339: lookup.
                    340: 
                    341: 
1.1       misha     342: Release 7.7 07-May-08
                    343: ---------------------
                    344: 
                    345: This is once again mainly a bug-fix release, but there are a couple of new
                    346: features.
                    347: 
                    348: 
                    349: Release 7.6 28-Jan-08
                    350: ---------------------
                    351: 
                    352: The main reason for having this release so soon after 7.5 is because it fixes a
                    353: potential buffer overflow problem in pcre_compile() when run in UTF-8 mode. In
                    354: addition, the CMake configuration files have been brought up to date.
                    355: 
                    356: 
                    357: Release 7.5 10-Jan-08
                    358: ---------------------
                    359: 
                    360: This is mainly a bug-fix release. However the ability to link pcregrep with
                    361: libz or libbz2 and the ability to link pcretest with libreadline have been
                    362: added. Also the --line-offsets and --file-offsets options were added to
                    363: pcregrep.
                    364: 
                    365: 
                    366: Release 7.4 21-Sep-07
                    367: ---------------------
                    368: 
                    369: The only change of specification is the addition of options to control whether
                    370: \R matches any Unicode line ending (the default) or just CR, LF, and CRLF.
                    371: Otherwise, the changes are bug fixes and a refactoring to reduce the number of
                    372: relocations needed in a shared library. There have also been some documentation
                    373: updates, in particular, some more information about using CMake to build PCRE
                    374: has been added to the NON-UNIX-USE file.
                    375: 
                    376: 
                    377: Release 7.3 28-Aug-07
                    378: ---------------------
                    379: 
                    380: Most changes are bug fixes. Some that are not:
                    381: 
                    382: 1. There is some support for Perl 5.10's experimental "backtracking control
                    383:    verbs" such as (*PRUNE).
                    384: 
                    385: 2. UTF-8 checking is now as per RFC 3629 instead of RFC 2279; this is more
                    386:    restrictive in the strings it accepts.
                    387: 
                    388: 3. Checking for potential integer overflow has been made more dynamic, and as a
                    389:    consequence there is no longer a hard limit on the size of a subpattern that
                    390:    has a limited repeat count.
                    391: 
                    392: 4. When CRLF is a valid line-ending sequence, pcre_exec() and pcre_dfa_exec()
                    393:    no longer advance by two characters instead of one when an unanchored match
                    394:    fails at CRLF if there are explicit CR or LF matches within the pattern.
                    395:    This gets rid of some anomalous effects that previously occurred.
                    396: 
                    397: 5. Some PCRE-specific settings for varying the newline options at the start of
                    398:    a pattern have been added.
                    399: 
                    400: 
                    401: Release 7.2 19-Jun-07
                    402: ---------------------
                    403: 
                    404: WARNING: saved patterns that were compiled by earlier versions of PCRE must be
                    405: recompiled for use with 7.2 (necessitated by the addition of \K, \h, \H, \v,
                    406: and \V).
                    407: 
                    408: Correction to the notes for 7.1: the note about shared libraries for Windows is
                    409: wrong. Previously, three libraries were built, but each could function
                    410: independently. For example, the pcreposix library also included all the
                    411: functions from the basic pcre library. The change is that the three libraries
                    412: are no longer independent. They are like the Unix libraries. To use the
                    413: pcreposix functions, for example, you need to link with both the pcreposix and
                    414: the basic pcre library.
                    415: 
                    416: Some more features from Perl 5.10 have been added:
                    417: 
                    418:   (?-n) and (?+n) relative references for recursion and subroutines.
                    419: 
                    420:   (?(-n) and (?(+n) relative references as conditions.
                    421: 
                    422:   \k{name} and \g{name} are synonyms for \k<name>.
                    423: 
                    424:   \K to reset the start of the matched string; for example, (foo)\Kbar
                    425:   matches bar preceded by foo, but only sets bar as the matched string.
                    426: 
                    427:   (?| introduces a group where the capturing parentheses in each alternative
                    428:   start from the same number; for example, (?|(abc)|(xyz)) sets capturing
                    429:   parentheses number 1 in both cases.
                    430: 
                    431:   \h, \H, \v, \V match horizontal and vertical whitespace, respectively.
                    432: 
                    433: 
                    434: Release 7.1 24-Apr-07
                    435: ---------------------
                    436: 
                    437: There is only one new feature in this release: a linebreak setting of
                    438: PCRE_NEWLINE_ANYCRLF. It is a cut-down version of PCRE_NEWLINE_ANY, which
                    439: recognizes only CRLF, CR, and LF as linebreaks.
                    440: 
                    441: A few bugs are fixed (see ChangeLog for details), but the major change is a
                    442: complete re-implementation of the build system. This now has full Autotools
                    443: support and so is now "standard" in some sense. It should help with compiling
                    444: PCRE in a wide variety of environments.
                    445: 
                    446: NOTE: when building shared libraries for Windows, three dlls are now built,
                    447: called libpcre, libpcreposix, and libpcrecpp. Previously, everything was
                    448: included in a single dll.
                    449: 
                    450: Another important change is that the dftables auxiliary program is no longer
                    451: compiled and run at "make" time by default. Instead, a default set of character
                    452: tables (assuming ASCII coding) is used. If you want to use dftables to generate
                    453: the character tables as previously, add --enable-rebuild-chartables to the
                    454: "configure" command. You must do this if you are compiling PCRE to run on a
                    455: system that uses EBCDIC code.
                    456: 
                    457: There is a discussion about character tables in the README file. The default is
                    458: not to use dftables so that that there is no problem when cross-compiling.
                    459: 
                    460: 
                    461: Release 7.0 19-Dec-06
                    462: ---------------------
                    463: 
                    464: This release has a new major number because there have been some internal
                    465: upheavals to facilitate the addition of new optimizations and other facilities,
                    466: and to make subsequent maintenance and extension easier. Compilation is likely
                    467: to be a bit slower, but there should be no major effect on runtime performance.
                    468: Previously compiled patterns are NOT upwards compatible with this release. If
                    469: you have saved compiled patterns from a previous release, you will have to
                    470: re-compile them. Important changes that are visible to users are:
                    471: 
                    472: 1. The Unicode property tables have been updated to Unicode 5.0.0, which adds
                    473:    some more scripts.
                    474: 
                    475: 2. The option PCRE_NEWLINE_ANY causes PCRE to recognize any Unicode newline
                    476:    sequence as a newline.
                    477: 
                    478: 3. The \R escape matches a single Unicode newline sequence as a single unit.
                    479: 
                    480: 4. New features that will appear in Perl 5.10 are now in PCRE. These include
                    481:    alternative Perl syntax for named parentheses, and Perl syntax for
                    482:    recursion.
                    483: 
                    484: 5. The C++ wrapper interface has been extended by the addition of a
                    485:    QuoteMeta function and the ability to allow copy construction and
                    486:    assignment.
                    487: 
                    488: For a complete list of changes, see the ChangeLog file.
                    489: 
                    490: 
                    491: Release 6.7 04-Jul-06
                    492: ---------------------
                    493: 
                    494: The main additions to this release are the ability to use the same name for
                    495: multiple sets of parentheses, and support for CRLF line endings in both the
                    496: library and pcregrep (and in pcretest for testing).
                    497: 
                    498: Thanks to Ian Taylor, the stack usage for many kinds of pattern has been
                    499: significantly reduced for certain subject strings.
                    500: 
                    501: 
                    502: Release 6.5 01-Feb-06
                    503: ---------------------
                    504: 
                    505: Important changes in this release:
                    506: 
                    507: 1. A number of new features have been added to pcregrep.
                    508: 
                    509: 2. The Unicode property tables have been updated to Unicode 4.1.0, and the
                    510:    supported properties have been extended with script names such as "Arabic",
                    511:    and the derived properties "Any" and "L&". This has necessitated a change to
                    512:    the interal format of compiled patterns. Any saved compiled patterns that
                    513:    use \p or \P must be recompiled.
                    514: 
                    515: 3. The specification of recursion in patterns has been changed so that all
                    516:    recursive subpatterns are automatically treated as atomic groups. Thus, for
                    517:    example, (?R) is treated as if it were (?>(?R)). This is necessary because
                    518:    otherwise there are situations where recursion does not work.
                    519: 
                    520: See the ChangeLog for a complete list of changes, which include a number of bug
                    521: fixes and tidies.
                    522: 
                    523: 
                    524: Release 6.0 07-Jun-05
                    525: ---------------------
                    526: 
                    527: The release number has been increased to 6.0 because of the addition of several
                    528: major new pieces of functionality.
                    529: 
                    530: A new function, pcre_dfa_exec(), which implements pattern matching using a DFA
                    531: algorithm, has been added. This has a number of advantages for certain cases,
                    532: though it does run more slowly, and lacks the ability to capture substrings. On
                    533: the other hand, it does find all matches, not just the first, and it works
                    534: better for partial matching. The pcrematching man page discusses the
                    535: differences.
                    536: 
                    537: The pcretest program has been enhanced so that it can make use of the new
                    538: pcre_dfa_exec() matching function and the extra features it provides.
                    539: 
                    540: The distribution now includes a C++ wrapper library. This is built
                    541: automatically if a C++ compiler is found. The pcrecpp man page discusses this
                    542: interface.
                    543: 
                    544: The code itself has been re-organized into many more files, one for each
                    545: function, so it no longer requires everything to be linked in when static
                    546: linkage is used. As a consequence, some internal functions have had to have
                    547: their names exposed. These functions all have names starting with _pcre_. They
                    548: are undocumented, and are not intended for use by outside callers.
                    549: 
                    550: The pcregrep program has been enhanced with new functionality such as
                    551: multiline-matching and options for output more matching context. See the
                    552: ChangeLog for a complete list of changes to the library and the utility
                    553: programs.
                    554: 
                    555: 
                    556: Release 5.0 13-Sep-04
                    557: ---------------------
                    558: 
                    559: The licence under which PCRE is released has been changed to the more
                    560: conventional "BSD" licence.
                    561: 
                    562: In the code, some bugs have been fixed, and there are also some major changes
                    563: in this release (which is why I've increased the number to 5.0). Some changes
                    564: are internal rearrangements, and some provide a number of new facilities. The
                    565: new features are:
                    566: 
                    567: 1. There's an "automatic callout" feature that inserts callouts before every
                    568:    item in the regex, and there's a new callout field that gives the position
                    569:    in the pattern - useful for debugging and tracing.
                    570: 
                    571: 2. The extra_data structure can now be used to pass in a set of character
                    572:    tables at exec time. This is useful if compiled regex are saved and re-used
                    573:    at a later time when the tables may not be at the same address. If the
                    574:    default internal tables are used, the pointer saved with the compiled
                    575:    pattern is now set to NULL, which means that you don't need to do anything
                    576:    special unless you are using custom tables.
                    577: 
                    578: 3. It is possible, with some restrictions on the content of the regex, to
                    579:    request "partial" matching. A special return code is given if all of the
                    580:    subject string matched part of the regex. This could be useful for testing
                    581:    an input field as it is being typed.
                    582: 
                    583: 4. There is now some optional support for Unicode character properties, which
                    584:    means that the patterns items such as \p{Lu} and \X can now be used. Only
                    585:    the general category properties are supported. If PCRE is compiled with this
                    586:    support, an additional 90K data structure is include, which increases the
                    587:    size of the library dramatically.
                    588: 
                    589: 5. There is support for saving compiled patterns and re-using them later.
                    590: 
                    591: 6. There is support for running regular expressions that were compiled on a
                    592:    different host with the opposite endianness.
                    593: 
                    594: 7. The pcretest program has been extended to accommodate the new features.
                    595: 
                    596: The main internal rearrangement is that sequences of literal characters are no
                    597: longer handled as strings. Instead, each character is handled on its own. This
                    598: makes some UTF-8 handling easier, and makes the support of partial matching
                    599: possible. Compiled patterns containing long literal strings will be larger as a
                    600: result of this change; I hope that performance will not be much affected.
                    601: 
                    602: 
                    603: Release 4.5 01-Dec-03
                    604: ---------------------
                    605: 
                    606: Again mainly a bug-fix and tidying release, with only a couple of new features:
                    607: 
                    608: 1. It's possible now to compile PCRE so that it does not use recursive
                    609: function calls when matching. Instead it gets memory from the heap. This slows
                    610: things down, but may be necessary on systems with limited stacks.
                    611: 
                    612: 2. UTF-8 string checking has been tightened to reject overlong sequences and to
                    613: check that a starting offset points to the start of a character. Failure of the
                    614: latter returns a new error code: PCRE_ERROR_BADUTF8_OFFSET.
                    615: 
                    616: 3. PCRE can now be compiled for systems that use EBCDIC code.
                    617: 
                    618: 
                    619: Release 4.4 21-Aug-03
                    620: ---------------------
                    621: 
                    622: This is mainly a bug-fix and tidying release. The only new feature is that PCRE
                    623: checks UTF-8 strings for validity by default. There is an option to suppress
                    624: this, just in case anybody wants that teeny extra bit of performance.
                    625: 
                    626: 
                    627: Releases 4.1 - 4.3
                    628: ------------------
                    629: 
                    630: Sorry, I forgot about updating the NEWS file for these releases. Please take a
                    631: look at ChangeLog.
                    632: 
                    633: 
                    634: Release 4.0 17-Feb-03
                    635: ---------------------
                    636: 
                    637: There have been a lot of changes for the 4.0 release, adding additional
                    638: functionality and mending bugs. Below is a list of the highlights of the new
                    639: functionality. For full details of these features, please consult the
                    640: documentation. For a complete list of changes, see the ChangeLog file.
                    641: 
                    642: 1. Support for Perl's \Q...\E escapes.
                    643: 
                    644: 2. "Possessive quantifiers" ?+, *+, ++, and {,}+ which come from Sun's Java
                    645: package. They provide some syntactic sugar for simple cases of "atomic
                    646: grouping".
                    647: 
                    648: 3. Support for the \G assertion. It is true when the current matching position
                    649: is at the start point of the match.
                    650: 
                    651: 4. A new feature that provides some of the functionality that Perl provides
                    652: with (?{...}). The facility is termed a "callout". The way it is done in PCRE
                    653: is for the caller to provide an optional function, by setting pcre_callout to
                    654: its entry point. To get the function called, the regex must include (?C) at
                    655: appropriate points.
                    656: 
                    657: 5. Support for recursive calls to individual subpatterns. This makes it really
                    658: easy to get totally confused.
                    659: 
                    660: 6. Support for named subpatterns. The Python syntax (?P<name>...) is used to
                    661: name a group.
                    662: 
                    663: 7. Several extensions to UTF-8 support; it is now fairly complete. There is an
                    664: option for pcregrep to make it operate in UTF-8 mode.
                    665: 
                    666: 8. The single man page has been split into a number of separate man pages.
                    667: These also give rise to individual HTML pages which are put in a separate
                    668: directory. There is an index.html page that lists them all. Some hyperlinking
                    669: between the pages has been installed.
                    670: 
                    671: 
                    672: Release 3.5 15-Aug-01
                    673: ---------------------
                    674: 
                    675: 1. The configuring system has been upgraded to use later versions of autoconf
                    676: and libtool. By default it builds both a shared and a static library if the OS
                    677: supports it. You can use --disable-shared or --disable-static on the configure
                    678: command if you want only one of them.
                    679: 
                    680: 2. The pcretest utility is now installed along with pcregrep because it is
                    681: useful for users (to test regexs) and by doing this, it automatically gets
                    682: relinked by libtool. The documentation has been turned into a man page, so
                    683: there are now .1, .txt, and .html versions in /doc.
                    684: 
                    685: 3. Upgrades to pcregrep:
                    686:    (i)   Added long-form option names like gnu grep.
                    687:    (ii)  Added --help to list all options with an explanatory phrase.
                    688:    (iii) Added -r, --recursive to recurse into sub-directories.
                    689:    (iv)  Added -f, --file to read patterns from a file.
                    690: 
                    691: 4. Added --enable-newline-is-cr and --enable-newline-is-lf to the configure
                    692: script, to force use of CR or LF instead of \n in the source. On non-Unix
                    693: systems, the value can be set in config.h.
                    694: 
                    695: 5. The limit of 200 on non-capturing parentheses is a _nesting_ limit, not an
                    696: absolute limit. Changed the text of the error message to make this clear, and
                    697: likewise updated the man page.
                    698: 
                    699: 6. The limit of 99 on the number of capturing subpatterns has been removed.
                    700: The new limit is 65535, which I hope will not be a "real" limit.
                    701: 
                    702: 
                    703: Release 3.3 01-Aug-00
                    704: ---------------------
                    705: 
                    706: There is some support for UTF-8 character strings. This is incomplete and
                    707: experimental. The documentation describes what is and what is not implemented.
                    708: Otherwise, this is just a bug-fixing release.
                    709: 
                    710: 
                    711: Release 3.0 01-Feb-00
                    712: ---------------------
                    713: 
                    714: 1. A "configure" script is now used to configure PCRE for Unix systems. It
                    715: builds a Makefile, a config.h file, and the pcre-config script.
                    716: 
                    717: 2. PCRE is built as a shared library by default.
                    718: 
                    719: 3. There is support for POSIX classes such as [:alpha:].
                    720: 
                    721: 5. There is an experimental recursion feature.
                    722: 
                    723: ----------------------------------------------------------------------------
                    724:           IMPORTANT FOR THOSE UPGRADING FROM VERSIONS BEFORE 2.00
                    725: 
                    726: Please note that there has been a change in the API such that a larger
                    727: ovector is required at matching time, to provide some additional workspace.
                    728: The new man page has details. This change was necessary in order to support
                    729: some of the new functionality in Perl 5.005.
                    730: 
                    731:           IMPORTANT FOR THOSE UPGRADING FROM VERSION 2.00
                    732: 
                    733: Another (I hope this is the last!) change has been made to the API for the
                    734: pcre_compile() function. An additional argument has been added to make it
                    735: possible to pass over a pointer to character tables built in the current
1.7       misha     736: locale by pcre_maketables(). To use the default tables, this new argument
1.1       misha     737: should be passed as NULL.
                    738: 
                    739:           IMPORTANT FOR THOSE UPGRADING FROM VERSION 2.05
                    740: 
                    741: Yet another (and again I hope this really is the last) change has been made
                    742: to the API for the pcre_exec() function. An additional argument has been
                    743: added to make it possible to start the match other than at the start of the
                    744: subject string. This is important if there are lookbehinds. The new man
                    745: page has the details, but you just want to convert existing programs, all
                    746: you need to do is to stick in a new fifth argument to pcre_exec(), with a
                    747: value of zero. For example, change
                    748: 
                    749:   pcre_exec(pattern, extra, subject, length, options, ovec, ovecsize)
                    750: to
                    751:   pcre_exec(pattern, extra, subject, length, 0, options, ovec, ovecsize)
                    752: 
                    753: ****

E-mail: