/[pcre]/code/trunk/doc/html/pcrebuild.html
ViewVC logotype

Diff of /code/trunk/doc/html/pcrebuild.html

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

revision 653 by ph10, Mon Oct 5 10:59:35 2009 UTC revision 654 by ph10, Tue Aug 2 11:00:40 2011 UTC
# Line 14  man page, in case the conversion went wr Line 14  man page, in case the conversion went wr
14  <br>  <br>
15  <ul>  <ul>
16  <li><a name="TOC1" href="#SEC1">PCRE BUILD-TIME OPTIONS</a>  <li><a name="TOC1" href="#SEC1">PCRE BUILD-TIME OPTIONS</a>
17  <li><a name="TOC2" href="#SEC2">C++ SUPPORT</a>  <li><a name="TOC2" href="#SEC2">BUILDING SHARED AND STATIC LIBRARIES</a>
18  <li><a name="TOC3" href="#SEC3">UTF-8 SUPPORT</a>  <li><a name="TOC3" href="#SEC3">C++ SUPPORT</a>
19  <li><a name="TOC4" href="#SEC4">UNICODE CHARACTER PROPERTY SUPPORT</a>  <li><a name="TOC4" href="#SEC4">UTF-8 SUPPORT</a>
20  <li><a name="TOC5" href="#SEC5">CODE VALUE OF NEWLINE</a>  <li><a name="TOC5" href="#SEC5">UNICODE CHARACTER PROPERTY SUPPORT</a>
21  <li><a name="TOC6" href="#SEC6">WHAT \R MATCHES</a>  <li><a name="TOC6" href="#SEC6">CODE VALUE OF NEWLINE</a>
22  <li><a name="TOC7" href="#SEC7">BUILDING SHARED AND STATIC LIBRARIES</a>  <li><a name="TOC7" href="#SEC7">WHAT \R MATCHES</a>
23  <li><a name="TOC8" href="#SEC8">POSIX MALLOC USAGE</a>  <li><a name="TOC8" href="#SEC8">POSIX MALLOC USAGE</a>
24  <li><a name="TOC9" href="#SEC9">HANDLING VERY LARGE PATTERNS</a>  <li><a name="TOC9" href="#SEC9">HANDLING VERY LARGE PATTERNS</a>
25  <li><a name="TOC10" href="#SEC10">AVOIDING EXCESSIVE STACK USAGE</a>  <li><a name="TOC10" href="#SEC10">AVOIDING EXCESSIVE STACK USAGE</a>
# Line 27  man page, in case the conversion went wr Line 27  man page, in case the conversion went wr
27  <li><a name="TOC12" href="#SEC12">CREATING CHARACTER TABLES AT BUILD TIME</a>  <li><a name="TOC12" href="#SEC12">CREATING CHARACTER TABLES AT BUILD TIME</a>
28  <li><a name="TOC13" href="#SEC13">USING EBCDIC CODE</a>  <li><a name="TOC13" href="#SEC13">USING EBCDIC CODE</a>
29  <li><a name="TOC14" href="#SEC14">PCREGREP OPTIONS FOR COMPRESSED FILE SUPPORT</a>  <li><a name="TOC14" href="#SEC14">PCREGREP OPTIONS FOR COMPRESSED FILE SUPPORT</a>
30  <li><a name="TOC15" href="#SEC15">PCRETEST OPTION FOR LIBREADLINE SUPPORT</a>  <li><a name="TOC15" href="#SEC15">PCREGREP BUFFER SIZE</a>
31  <li><a name="TOC16" href="#SEC16">SEE ALSO</a>  <li><a name="TOC16" href="#SEC16">PCRETEST OPTION FOR LIBREADLINE SUPPORT</a>
32  <li><a name="TOC17" href="#SEC17">AUTHOR</a>  <li><a name="TOC17" href="#SEC17">SEE ALSO</a>
33  <li><a name="TOC18" href="#SEC18">REVISION</a>  <li><a name="TOC18" href="#SEC18">AUTHOR</a>
34    <li><a name="TOC19" href="#SEC19">REVISION</a>
35  </ul>  </ul>
36  <br><a name="SEC1" href="#TOC1">PCRE BUILD-TIME OPTIONS</a><br>  <br><a name="SEC1" href="#TOC1">PCRE BUILD-TIME OPTIONS</a><br>
37  <P>  <P>
# Line 61  The following sections include descripti Line 62  The following sections include descripti
62  --enable and --disable always come in pairs, so the complementary option always  --enable and --disable always come in pairs, so the complementary option always
63  exists as well, but as it specifies the default, it is not described.  exists as well, but as it specifies the default, it is not described.
64  </P>  </P>
65  <br><a name="SEC2" href="#TOC1">C++ SUPPORT</a><br>  <br><a name="SEC2" href="#TOC1">BUILDING SHARED AND STATIC LIBRARIES</a><br>
66    <P>
67    The PCRE building process uses <b>libtool</b> to build both shared and static
68    Unix libraries by default. You can suppress one of these by adding one of
69    <pre>
70      --disable-shared
71      --disable-static
72    </pre>
73    to the <b>configure</b> command, as required.
74    </P>
75    <br><a name="SEC3" href="#TOC1">C++ SUPPORT</a><br>
76  <P>  <P>
77  By default, the <b>configure</b> script will search for a C++ compiler and C++  By default, the <b>configure</b> script will search for a C++ compiler and C++
78  header files. If it finds them, it automatically builds the C++ wrapper library  header files. If it finds them, it automatically builds the C++ wrapper library
# Line 71  for PCRE. You can disable this by adding Line 82  for PCRE. You can disable this by adding
82  </pre>  </pre>
83  to the <b>configure</b> command.  to the <b>configure</b> command.
84  </P>  </P>
85  <br><a name="SEC3" href="#TOC1">UTF-8 SUPPORT</a><br>  <br><a name="SEC4" href="#TOC1">UTF-8 SUPPORT</a><br>
86  <P>  <P>
87  To build PCRE with support for UTF-8 Unicode character strings, add  To build PCRE with support for UTF-8 Unicode character strings, add
88  <pre>  <pre>
# Line 89  not possible to support both EBCDIC and Line 100  not possible to support both EBCDIC and
100  library. Consequently, --enable-utf8 and --enable-ebcdic are mutually  library. Consequently, --enable-utf8 and --enable-ebcdic are mutually
101  exclusive.  exclusive.
102  </P>  </P>
103  <br><a name="SEC4" href="#TOC1">UNICODE CHARACTER PROPERTY SUPPORT</a><br>  <br><a name="SEC5" href="#TOC1">UNICODE CHARACTER PROPERTY SUPPORT</a><br>
104  <P>  <P>
105  UTF-8 support allows PCRE to process character values greater than 255 in the  UTF-8 support allows PCRE to process character values greater than 255 in the
106  strings that it handles. On its own, however, it does not provide any  strings that it handles. On its own, however, it does not provide any
# Line 109  supported. Details are given in the Line 120  supported. Details are given in the
120  <a href="pcrepattern.html"><b>pcrepattern</b></a>  <a href="pcrepattern.html"><b>pcrepattern</b></a>
121  documentation.  documentation.
122  </P>  </P>
123  <br><a name="SEC5" href="#TOC1">CODE VALUE OF NEWLINE</a><br>  <br><a name="SEC6" href="#TOC1">CODE VALUE OF NEWLINE</a><br>
124  <P>  <P>
125  By default, PCRE interprets the linefeed (LF) character as indicating the end  By default, PCRE interprets the linefeed (LF) character as indicating the end
126  of a line. This is the normal newline character on Unix-like systems. You can  of a line. This is the normal newline character on Unix-like systems. You can
# Line 142  Whatever line ending convention is selec Line 153  Whatever line ending convention is selec
153  overridden when the library functions are called. At build time it is  overridden when the library functions are called. At build time it is
154  conventional to use the standard for your operating system.  conventional to use the standard for your operating system.
155  </P>  </P>
156  <br><a name="SEC6" href="#TOC1">WHAT \R MATCHES</a><br>  <br><a name="SEC7" href="#TOC1">WHAT \R MATCHES</a><br>
157  <P>  <P>
158  By default, the sequence \R in a pattern matches any Unicode newline sequence,  By default, the sequence \R in a pattern matches any Unicode newline sequence,
159  whatever has been selected as the line ending sequence. If you specify  whatever has been selected as the line ending sequence. If you specify
# Line 153  the default is changed so that \R matche Line 164  the default is changed so that \R matche
164  selected when PCRE is built can be overridden when the library functions are  selected when PCRE is built can be overridden when the library functions are
165  called.  called.
166  </P>  </P>
 <br><a name="SEC7" href="#TOC1">BUILDING SHARED AND STATIC LIBRARIES</a><br>  
 <P>  
 The PCRE building process uses <b>libtool</b> to build both shared and static  
 Unix libraries by default. You can suppress one of these by adding one of  
 <pre>  
   --disable-shared  
   --disable-static  
 </pre>  
 to the <b>configure</b> command, as required.  
 </P>  
167  <br><a name="SEC8" href="#TOC1">POSIX MALLOC USAGE</a><br>  <br><a name="SEC8" href="#TOC1">POSIX MALLOC USAGE</a><br>
168  <P>  <P>
169  When PCRE is called through the POSIX interface (see the  When PCRE is called through the POSIX interface (see the
# Line 299  to the <b>configure</b> command. These o Line 300  to the <b>configure</b> command. These o
300  relevant libraries are installed on your system. Configuration will fail if  relevant libraries are installed on your system. Configuration will fail if
301  they are not.  they are not.
302  </P>  </P>
303  <br><a name="SEC15" href="#TOC1">PCRETEST OPTION FOR LIBREADLINE SUPPORT</a><br>  <br><a name="SEC15" href="#TOC1">PCREGREP BUFFER SIZE</a><br>
304    <P>
305    <b>pcregrep</b> uses an internal buffer to hold a "window" on the file it is
306    scanning, in order to be able to output "before" and "after" lines when it
307    finds a match. The size of the buffer is controlled by a parameter whose
308    default value is 20K. The buffer itself is three times this size, but because
309    of the way it is used for holding "before" lines, the longest line that is
310    guaranteed to be processable is the parameter size. You can change the default
311    parameter value by adding, for example,
312    <pre>
313      --with-pcregrep-bufsize=50K
314    </pre>
315    to the <b>configure</b> command. The caller of \fPpcregrep\fP can, however,
316    override this value by specifying a run-time option.
317    </P>
318    <br><a name="SEC16" href="#TOC1">PCRETEST OPTION FOR LIBREADLINE SUPPORT</a><br>
319  <P>  <P>
320  If you add  If you add
321  <pre>  <pre>
# Line 330  automatically included, you may need to Line 346  automatically included, you may need to
346  </pre>  </pre>
347  immediately before the <b>configure</b> command.  immediately before the <b>configure</b> command.
348  </P>  </P>
349  <br><a name="SEC16" href="#TOC1">SEE ALSO</a><br>  <br><a name="SEC17" href="#TOC1">SEE ALSO</a><br>
350  <P>  <P>
351  <b>pcreapi</b>(3), <b>pcre_config</b>(3).  <b>pcreapi</b>(3), <b>pcre_config</b>(3).
352  </P>  </P>
353  <br><a name="SEC17" href="#TOC1">AUTHOR</a><br>  <br><a name="SEC18" href="#TOC1">AUTHOR</a><br>
354  <P>  <P>
355  Philip Hazel  Philip Hazel
356  <br>  <br>
# Line 343  University Computing Service Line 359  University Computing Service
359  Cambridge CB2 3QH, England.  Cambridge CB2 3QH, England.
360  <br>  <br>
361  </P>  </P>
362  <br><a name="SEC18" href="#TOC1">REVISION</a><br>  <br><a name="SEC19" href="#TOC1">REVISION</a><br>
363  <P>  <P>
364  Last updated: 29 September 2009  Last updated: 02 August 2011
365  <br>  <br>
366  Copyright &copy; 1997-2009 University of Cambridge.  Copyright &copy; 1997-2011 University of Cambridge.
367  <br>  <br>
368  <p>  <p>
369  Return to the <a href="index.html">PCRE index page</a>.  Return to the <a href="index.html">PCRE index page</a>.

Legend:
Removed from v.653  
changed lines
  Added in v.654

  ViewVC Help
Powered by ViewVC 1.1.5