/[pcre]/code/trunk/maint/README
ViewVC logotype

Diff of /code/trunk/maint/README

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 506 by ph10, Mon Mar 1 17:45:08 2010 UTC revision 507 by ph10, Wed Mar 10 16:08:01 2010 UTC
# Line 1  Line 1 
1  MAINTENANCE README FOR PCRE  MAINTENANCE README FOR PCRE
2  ---------------------------  ===========================
3    
4  The files in the "maint" directory of the PCRE source contain data, scripts,  The files in the "maint" directory of the PCRE source contain data, scripts,
5  and programs that are used for the maintenance of PCRE, but which do not form  and programs that are used for the maintenance of PCRE, but which do not form
# Line 14  also contains some notes for maintainers Line 14  also contains some notes for maintainers
14    
15    
16  Files in the maint directory  Files in the maint directory
17  ----------------------------  ============================
18    
19  ----------------- This file is now OBSOLETE and no longer used ----------------  ---------------- This file is now OBSOLETE and no longer used ----------------
20  Builducptable    A Perl script that creates the contents of the ucptable.h file  Builducptable    A Perl script that creates the contents of the ucptable.h file
21                   from two Unicode data files, which themselves are downloaded                   from two Unicode data files, which themselves are downloaded
22                   from the Unicode web site. Run this script in the "maint"                   from the Unicode web site. Run this script in the "maint"
23                   directory.                   directory.
24  ----------------- This file is now OBSOLETE and no longer used ----------------  ---------------- This file is now OBSOLETE and no longer used ----------------
25    
26  GenerateUtt.py   A Python script to generate part of the pcre_tables.c file  GenerateUtt.py   A Python script to generate part of the pcre_tables.c file
27                   that contains Unicode script names in a long string with                   that contains Unicode script names in a long string with
# Line 61  utf8.c           A short, freestanding C Line 61  utf8.c           A short, freestanding C
61    
62    
63  Updating to a new Unicode release  Updating to a new Unicode release
64  ---------------------------------  =================================
65    
66  When there is a new release of Unicode, the files in Unicode.tables must be  When there is a new release of Unicode, the files in Unicode.tables must be
67  refreshed from the web site. If the new version of Unicode adds new character  refreshed from the web site. If the new version of Unicode adds new character
# Line 88  of Unicode script names. Line 88  of Unicode script names.
88    
89    
90  Preparing for a PCRE release  Preparing for a PCRE release
91  ----------------------------  ============================
92    
93  This section contains a checklist of things that I consult before building a  This section contains a checklist of things that I consult before building a
94  distribution for a new release.  distribution for a new release.
# Line 135  distribution for a new release. Line 135  distribution for a new release.
135    Many of these won't need changing, but over the long term things do change.    Many of these won't need changing, but over the long term things do change.
136    
137  . Man pages: Check all man pages for \ not followed by e or f or " because  . Man pages: Check all man pages for \ not followed by e or f or " because
138    that indicates a markup error.    that indicates a markup error. However, there is one exception: pcredemo.3,
139      which is created from the pcredemo.c program. It contains three instances
140      of \\n.
141    
142  . When the release is built, test it on a number of different operating  . When the release is built, test it on a number of different operating
143    systems if possible, and using different compilers as well. For example,    systems if possible, and using different compilers as well. For example,
# Line 145  distribution for a new release. Line 147  distribution for a new release.
147    
148    
149  Making a PCRE release  Making a PCRE release
150  ---------------------  =====================
151    
152  Run PrepareRelease and commit the files that it changes (by removing trailing  Run PrepareRelease and commit the files that it changes (by removing trailing
153  spaces). Then run "make distcheck" to create the tarballs and the zipball.  spaces). Then run "make distcheck" to create the tarballs and the zipball.
# Line 155  Double-check with "svn status", then cre Line 157  Double-check with "svn status", then cre
157             svn://vcs.exim.org/pcre/code/tags/pcre-8.xx             svn://vcs.exim.org/pcre/code/tags/pcre-8.xx
158    
159  Don't forget to update Freshmeat when the new release is out, and to tell  Don't forget to update Freshmeat when the new release is out, and to tell
160  webmaster@pcre.org and the mailing list.  webmaster@pcre.org and the mailing list. Also, update the list of version
161    numbers in Bugzilla (edit products).
162    
163    
164  Future ideas (wish list)  Future ideas (wish list)
165  ------------------------  ========================
166    
167  This section records a list of ideas so that they do not get forgotten. They  This section records a list of ideas so that they do not get forgotten. They
168  vary enormously in their usefulness and potential for implementation. Some are  vary enormously in their usefulness and potential for implementation. Some are
# Line 280  others are relatively new. Line 283  others are relatively new.
283  . Callouts with arguments: (?Cn:ARG) for instance.  . Callouts with arguments: (?Cn:ARG) for instance.
284    
285  . A user is going to supply a patch to generalize the API for user-specific  . A user is going to supply a patch to generalize the API for user-specific
286    memory allocation so that it is more flexible in threaded environments. Thiw    memory allocation so that it is more flexible in threaded environments. This
287    was promised a long time ago, and never appeared...    was promised a long time ago, and never appeared...
288    
289  . Write a function that generates random matching strings for a compiled regex.  . Write a function that generates random matching strings for a compiled regex.
# Line 309  others are relatively new. Line 312  others are relatively new.
312  . PCRE cannot at present distinguish between subpatterns with different names,  . PCRE cannot at present distinguish between subpatterns with different names,
313    but the same number (created by the use of ?|). In order to do so, a way of    but the same number (created by the use of ?|). In order to do so, a way of
314    remembering *which* subpattern numbered n matched is needed. Bugzilla #760.    remembering *which* subpattern numbered n matched is needed. Bugzilla #760.
315    
316    . Instead of having #ifdef HAVE_CONFIG_H in each module, put #include
317      "something" and the the #ifdef appears only in one place, in "something".
318    
319    . Support for (*MARK) and arguments for (*PRUNE) and friends.
320    
321  Philip Hazel  Philip Hazel
322  Email local part: ph10  Email local part: ph10
323  Email domain: cam.ac.uk  Email domain: cam.ac.uk
324  Last updated: 26 September 2009  Last updated: 10 March 2010

Legend:
Removed from v.506  
changed lines
  Added in v.507

  ViewVC Help
Powered by ViewVC 1.1.5