/[pcre]/code/trunk/NON-UNIX-USE
ViewVC logotype

Diff of /code/trunk/NON-UNIX-USE

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

revision 187 by ph10, Wed Jun 13 15:09:54 2007 UTC revision 188 by ph10, Thu Jul 5 11:49:44 2007 UTC
# Line 38  GENERIC INSTRUCTIONS FOR THE PCRE C LIBR Line 38  GENERIC INSTRUCTIONS FOR THE PCRE C LIBR
38    
39  The following are generic comments about building the PCRE C library "by hand".  The following are generic comments about building the PCRE C library "by hand".
40    
41  (1) Copy or rename the file config.h.generic as config.h, and edit the macro   (1) Copy or rename the file config.h.generic as config.h, and edit the macro
42      settings that it contains to whatever is appropriate for your environment.       settings that it contains to whatever is appropriate for your environment.
43      In particular, if you want to force a specific value for newline, you can       In particular, if you want to force a specific value for newline, you can
44      define the NEWLINE macro.       define the NEWLINE macro.
45    
46      An alternative approach is not to edit config.h, but to use -D on the       An alternative approach is not to edit config.h, but to use -D on the
47      compiler command line to make any changes that you need.       compiler command line to make any changes that you need.
48    
49      NOTE: There have been occasions when the way in which certain parameters in       NOTE: There have been occasions when the way in which certain parameters
50      config.h are used has changed between releases. (In the configure/make       in config.h are used has changed between releases. (In the configure/make
51      world, this is handled automatically.) When upgrading to a new release, you       world, this is handled automatically.) When upgrading to a new release,
52      are strongly advised to review config.h.generic before re-using what you       you are strongly advised to review config.h.generic before re-using what
53      had previously.       you had previously.
54    
55  (2) Copy or rename the file pcre.h.generic as pcre.h.   (2) Copy or rename the file pcre.h.generic as pcre.h.
56    
57  (3) EITHER:   (3) EITHER:
58        Copy or rename file pcre_chartables.c.dist as pcre_chartables.c.         Copy or rename file pcre_chartables.c.dist as pcre_chartables.c.
59    
60      OR:       OR:
61        Compile dftables.c as a stand-alone program, and then run it with the         Compile dftables.c as a stand-alone program, and then run it with the
62        single argument "pcre_chartables.c". This generates a set of standard         single argument "pcre_chartables.c". This generates a set of standard
63        character tables and writes them to that file. The tables are generated         character tables and writes them to that file. The tables are generated
64        using the default C locale for your system. If you want to use a locale         using the default C locale for your system. If you want to use a locale
65        that is specified by LC_xxx environment variables, add the -L option to         that is specified by LC_xxx environment variables, add the -L option to
66        the dftables command. You must use this method if you are building on         the dftables command. You must use this method if you are building on
67        a system that uses EBCDIC code.         a system that uses EBCDIC code.
68    
69      The tables in pcre_chartables.c are defaults. The caller of PCRE can       The tables in pcre_chartables.c are defaults. The caller of PCRE can
70      specify alternative tables at run time.       specify alternative tables at run time.
71    
72  (4) Compile the following source files:   (4) Ensure that you have the following header files:
73    
74        pcre_chartables.c         pcre_internal.h
75        pcre_compile.c         ucp.h
76        pcre_config.c         ucpinternal.h
77        pcre_dfa_exec.c         ucptable.h
78        pcre_exec.c  
79        pcre_fullinfo.c   (5) Also ensure that you have the following file, which is #included as source
80        pcre_get.c       when building a debugging version of PCRE and is also used by pcretest.
81        pcre_globals.c  
82        pcre_info.c         pcre_printint.src
83        pcre_maketables.c  
84        pcre_newline.c   (6) Compile the following source files:
85        pcre_ord2utf8.c  
86        pcre_refcount.c         pcre_chartables.c
87        pcre_study.c         pcre_compile.c
88        pcre_tables.c         pcre_config.c
89        pcre_try_flipped.c         pcre_dfa_exec.c
90        pcre_ucp_searchfuncs.c         pcre_exec.c
91        pcre_valid_utf8.c         pcre_fullinfo.c
92        pcre_version.c         pcre_get.c
93        pcre_xclass.c         pcre_globals.c
94           pcre_info.c
95      Now link them all together into an object library in whichever form your         pcre_maketables.c
96      system keeps such libraries. This is the basic PCRE C library. If your         pcre_newline.c
97      system has static and shared libraries, you may have to do this once for         pcre_ord2utf8.c
98      each type.         pcre_refcount.c
99           pcre_study.c
100  (5) Similarly, compile pcreposix.c and link it (on its own) as the pcreposix         pcre_tables.c
101      library.         pcre_try_flipped.c
102           pcre_ucp_searchfuncs.c
103  (6) Compile the test program pcretest.c. This needs the functions in the         pcre_valid_utf8.c
104      pcre and pcreposix libraries when linking.         pcre_version.c
105           pcre_xclass.c
106  (7) Run pcretest on the testinput files in the testdata directory, and check  
107      that the output matches the corresponding testoutput files. Note that the   (7) Now link all the compiled code into an object library in whichever form
108      supplied files are in Unix format, with just LF characters as line       your system keeps such libraries. This is the basic PCRE C library. If
109      terminators. You may need to edit them to change this if your system uses a       your system has static and shared libraries, you may have to do this once
110      different convention.       for each type.
111    
112     (8) Similarly, compile pcreposix.c and link the result (on its own) as the
113         pcreposix library.
114    
115     (9) Compile the test program pcretest.c. This needs the functions in the
116         pcre and pcreposix libraries when linking. It also needs the
117         pcre_printint.src source file, which it #includes.
118    
119    (10) Run pcretest on the testinput files in the testdata directory, and check
120         that the output matches the corresponding testoutput files. Note that the
121         supplied files are in Unix format, with just LF characters as line
122         terminators. You may need to edit them to change this if your system uses
123         a different convention.
124    
125  (8) If you want to use the pcregrep command, compile and link pcregrep.c; it  (11) If you want to use the pcregrep command, compile and link pcregrep.c; it
126      uses only the basic PCRE library (it does not need the pcreposix library).       uses only the basic PCRE library (it does not need the pcreposix library).
127    
128    
129  THE C++ WRAPPER FUNCTIONS  THE C++ WRAPPER FUNCTIONS
# Line 284  $! Locale could not be set to fr Line 297  $! Locale could not be set to fr
297  $!  $!
298  =========================  =========================
299    
300  Last Updated: 13 June 2007  Last Updated: 05 July 2007
301  ****  ****
Legend:
Removed from v.187  
changed lines
  Added in v.188
webmaster@exim.org
 ViewVC Help
Powered by ViewVC 1.1.12