/[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 77 by nigel, Sat Feb 24 21:40:45 2007 UTC revision 83 by nigel, Sat Feb 24 21:41:06 2007 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">UTF-8 SUPPORT</a>  <li><a name="TOC2" href="#SEC2">C++ SUPPORT</a>
18  <li><a name="TOC3" href="#SEC3">UNICODE CHARACTER PROPERTY SUPPORT</a>  <li><a name="TOC3" href="#SEC3">UTF-8 SUPPORT</a>
19  <li><a name="TOC4" href="#SEC4">CODE VALUE OF NEWLINE</a>  <li><a name="TOC4" href="#SEC4">UNICODE CHARACTER PROPERTY SUPPORT</a>
20  <li><a name="TOC5" href="#SEC5">BUILDING SHARED AND STATIC LIBRARIES</a>  <li><a name="TOC5" href="#SEC5">CODE VALUE OF NEWLINE</a>
21  <li><a name="TOC6" href="#SEC6">POSIX MALLOC USAGE</a>  <li><a name="TOC6" href="#SEC6">BUILDING SHARED AND STATIC LIBRARIES</a>
22  <li><a name="TOC7" href="#SEC7">LIMITING PCRE RESOURCE USAGE</a>  <li><a name="TOC7" href="#SEC7">POSIX MALLOC USAGE</a>
23  <li><a name="TOC8" href="#SEC8">HANDLING VERY LARGE PATTERNS</a>  <li><a name="TOC8" href="#SEC8">LIMITING PCRE RESOURCE USAGE</a>
24  <li><a name="TOC9" href="#SEC9">AVOIDING EXCESSIVE STACK USAGE</a>  <li><a name="TOC9" href="#SEC9">HANDLING VERY LARGE PATTERNS</a>
25  <li><a name="TOC10" href="#SEC10">USING EBCDIC CODE</a>  <li><a name="TOC10" href="#SEC10">AVOIDING EXCESSIVE STACK USAGE</a>
26    <li><a name="TOC11" href="#SEC11">USING EBCDIC CODE</a>
27  </ul>  </ul>
28  <br><a name="SEC1" href="#TOC1">PCRE BUILD-TIME OPTIONS</a><br>  <br><a name="SEC1" href="#TOC1">PCRE BUILD-TIME OPTIONS</a><br>
29  <P>  <P>
# Line 41  or --disable. These settings specify cha Line 42  or --disable. These settings specify cha
42  --enable and --disable always come in pairs, so the complementary option always  --enable and --disable always come in pairs, so the complementary option always
43  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.
44  </P>  </P>
45  <br><a name="SEC2" href="#TOC1">UTF-8 SUPPORT</a><br>  <br><a name="SEC2" href="#TOC1">C++ SUPPORT</a><br>
46    <P>
47    By default, the <b>configure</b> script will search for a C++ compiler and C++
48    header files. If it finds them, it automatically builds the C++ wrapper library
49    for PCRE. You can disable this by adding
50    <pre>
51      --disable-cpp
52    </pre>
53    to the <b>configure</b> command.
54    </P>
55    <br><a name="SEC3" href="#TOC1">UTF-8 SUPPORT</a><br>
56  <P>  <P>
57  To build PCRE with support for UTF-8 character strings, add  To build PCRE with support for UTF-8 character strings, add
58  <pre>  <pre>
# Line 52  strings as UTF-8. As well as compiling P Line 63  strings as UTF-8. As well as compiling P
63  have to set the PCRE_UTF8 option when you call the <b>pcre_compile()</b>  have to set the PCRE_UTF8 option when you call the <b>pcre_compile()</b>
64  function.  function.
65  </P>  </P>
66  <br><a name="SEC3" href="#TOC1">UNICODE CHARACTER PROPERTY SUPPORT</a><br>  <br><a name="SEC4" href="#TOC1">UNICODE CHARACTER PROPERTY SUPPORT</a><br>
67  <P>  <P>
68  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
69  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 72  such as <i>Lu</i> and <i>Nd</i> are supp Line 83  such as <i>Lu</i> and <i>Nd</i> are supp
83  <a href="pcrepattern.html"><b>pcrepattern</b></a>  <a href="pcrepattern.html"><b>pcrepattern</b></a>
84  documentation.  documentation.
85  </P>  </P>
86  <br><a name="SEC4" href="#TOC1">CODE VALUE OF NEWLINE</a><br>  <br><a name="SEC5" href="#TOC1">CODE VALUE OF NEWLINE</a><br>
87  <P>  <P>
88  By default, PCRE treats character 10 (linefeed) as the newline character. This  By default, PCRE treats character 10 (linefeed) as the newline character. This
89  is the normal newline character on Unix-like systems. You can compile PCRE to  is the normal newline character on Unix-like systems. You can compile PCRE to
# Line 84  to the <b>configure</b> command. For com Line 95  to the <b>configure</b> command. For com
95  --enable-newline-is-lf option, which explicitly specifies linefeed as the  --enable-newline-is-lf option, which explicitly specifies linefeed as the
96  newline character.  newline character.
97  </P>  </P>
98  <br><a name="SEC5" href="#TOC1">BUILDING SHARED AND STATIC LIBRARIES</a><br>  <br><a name="SEC6" href="#TOC1">BUILDING SHARED AND STATIC LIBRARIES</a><br>
99  <P>  <P>
100  The PCRE building process uses <b>libtool</b> to build both shared and static  The PCRE building process uses <b>libtool</b> to build both shared and static
101  Unix libraries by default. You can suppress one of these by adding one of  Unix libraries by default. You can suppress one of these by adding one of
# Line 94  Unix libraries by default. You can suppr Line 105  Unix libraries by default. You can suppr
105  </pre>  </pre>
106  to the <b>configure</b> command, as required.  to the <b>configure</b> command, as required.
107  </P>  </P>
108  <br><a name="SEC6" href="#TOC1">POSIX MALLOC USAGE</a><br>  <br><a name="SEC7" href="#TOC1">POSIX MALLOC USAGE</a><br>
109  <P>  <P>
110  When PCRE is called through the POSIX interface (see the  When PCRE is called through the POSIX interface (see the
111  <a href="pcreposix.html"><b>pcreposix</b></a>  <a href="pcreposix.html"><b>pcreposix</b></a>
# Line 110  such as Line 121  such as
121  </pre>  </pre>
122  to the <b>configure</b> command.  to the <b>configure</b> command.
123  </P>  </P>
124  <br><a name="SEC7" href="#TOC1">LIMITING PCRE RESOURCE USAGE</a><br>  <br><a name="SEC8" href="#TOC1">LIMITING PCRE RESOURCE USAGE</a><br>
125  <P>  <P>
126  Internally, PCRE has a function called <b>match()</b>, which it calls repeatedly  Internally, PCRE has a function called <b>match()</b>, which it calls repeatedly
127  (possibly recursively) when matching a pattern with the <b>pcre_exec()</b>  (possibly recursively) when matching a pattern with the <b>pcre_exec()</b>
# Line 127  setting such as Line 138  setting such as
138  to the <b>configure</b> command. This setting has no effect on the  to the <b>configure</b> command. This setting has no effect on the
139  <b>pcre_dfa_exec()</b> matching function.  <b>pcre_dfa_exec()</b> matching function.
140  </P>  </P>
141  <br><a name="SEC8" href="#TOC1">HANDLING VERY LARGE PATTERNS</a><br>  <br><a name="SEC9" href="#TOC1">HANDLING VERY LARGE PATTERNS</a><br>
142  <P>  <P>
143  Within a compiled pattern, offset values are used to point from one part to  Within a compiled pattern, offset values are used to point from one part to
144  another (for example, from an opening parenthesis to an alternation  another (for example, from an opening parenthesis to an alternation
# Line 148  If you build PCRE with an increased link Line 159  If you build PCRE with an increased link
159  using UTF-8) will fail. Part of the output of these tests is a representation  using UTF-8) will fail. Part of the output of these tests is a representation
160  of the compiled pattern, and this changes with the link size.  of the compiled pattern, and this changes with the link size.
161  </P>  </P>
162  <br><a name="SEC9" href="#TOC1">AVOIDING EXCESSIVE STACK USAGE</a><br>  <br><a name="SEC10" href="#TOC1">AVOIDING EXCESSIVE STACK USAGE</a><br>
163  <P>  <P>
164  When matching with the <b>pcre_exec()</b> function, PCRE implements backtracking  When matching with the <b>pcre_exec()</b> function, PCRE implements backtracking
165  by making recursive calls to an internal function called <b>match()</b>. In  by making recursive calls to an internal function called <b>match()</b>. In
# Line 171  optimized functions that perform better Line 182  optimized functions that perform better
182  way. This option affects only the <b>pcre_exec()</b> function; it is not  way. This option affects only the <b>pcre_exec()</b> function; it is not
183  relevant for the the <b>pcre_dfa_exec()</b> function.  relevant for the the <b>pcre_dfa_exec()</b> function.
184  </P>  </P>
185  <br><a name="SEC10" href="#TOC1">USING EBCDIC CODE</a><br>  <br><a name="SEC11" href="#TOC1">USING EBCDIC CODE</a><br>
186  <P>  <P>
187  PCRE assumes by default that it will run in an environment where the character  PCRE assumes by default that it will run in an environment where the character
188  code is ASCII (or Unicode, which is a superset of ASCII). PCRE can, however, be  code is ASCII (or Unicode, which is a superset of ASCII). PCRE can, however, be
# Line 182  compiled to run in an EBCDIC environment Line 193  compiled to run in an EBCDIC environment
193  to the <b>configure</b> command.  to the <b>configure</b> command.
194  </P>  </P>
195  <P>  <P>
196  Last updated: 28 February 2005  Last updated: 15 August 2005
197  <br>  <br>
198  Copyright &copy; 1997-2005 University of Cambridge.  Copyright &copy; 1997-2005 University of Cambridge.
199  <p>  <p>
Legend:
Removed from v.77  
changed lines
  Added in v.83
  ViewVC Help
Powered by ViewVC 1.1.5