/[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 127 by ph10, Thu Mar 8 16:53:09 2007 UTC revision 128 by ph10, Tue Mar 20 11:46:50 2007 UTC
# Line 23  man page, in case the conversion went wr Line 23  man page, in case the conversion went wr
23  <li><a name="TOC8" href="#SEC8">HANDLING VERY LARGE PATTERNS</a>  <li><a name="TOC8" href="#SEC8">HANDLING VERY LARGE PATTERNS</a>
24  <li><a name="TOC9" href="#SEC9">AVOIDING EXCESSIVE STACK USAGE</a>  <li><a name="TOC9" href="#SEC9">AVOIDING EXCESSIVE STACK USAGE</a>
25  <li><a name="TOC10" href="#SEC10">LIMITING PCRE RESOURCE USAGE</a>  <li><a name="TOC10" href="#SEC10">LIMITING PCRE RESOURCE USAGE</a>
26  <li><a name="TOC11" href="#SEC11">USING EBCDIC CODE</a>  <li><a name="TOC11" href="#SEC11">CREATING CHARACTER TABLES AT BUILD TIME</a>
27  <li><a name="TOC12" href="#SEC12">SEE ALSO</a>  <li><a name="TOC12" href="#SEC12">USING EBCDIC CODE</a>
28  <li><a name="TOC13" href="#SEC13">AUTHOR</a>  <li><a name="TOC13" href="#SEC13">SEE ALSO</a>
29  <li><a name="TOC14" href="#SEC14">REVISION</a>  <li><a name="TOC14" href="#SEC14">AUTHOR</a>
30    <li><a name="TOC15" href="#SEC15">REVISION</a>
31  </ul>  </ul>
32  <br><a name="SEC1" href="#TOC1">PCRE BUILD-TIME OPTIONS</a><br>  <br><a name="SEC1" href="#TOC1">PCRE BUILD-TIME OPTIONS</a><br>
33  <P>  <P>
# Line 39  obtained by running Line 40  obtained by running
40  <pre>  <pre>
41    ./configure --help    ./configure --help
42  </pre>  </pre>
43  The following sections describe certain options whose names begin with --enable  The following sections include descriptions of options whose names begin with
44  or --disable. These settings specify changes to the defaults for the  --enable or --disable. These settings specify changes to the defaults for the
45  <b>configure</b> command. Because of the way that <b>configure</b> works,  <b>configure</b> command. Because of the way that <b>configure</b> works,
46  --enable and --disable always come in pairs, so the complementary option always  --enable and --disable always come in pairs, so the complementary option always
47  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.
# Line 80  to the <b>configure</b> command. This im Line 81  to the <b>configure</b> command. This im
81  not explicitly requested it.  not explicitly requested it.
82  </P>  </P>
83  <P>  <P>
84  Including Unicode property support adds around 90K of tables to the PCRE  Including Unicode property support adds around 30K of tables to the PCRE
85  library, approximately doubling its size. Only the general category properties  library. Only the general category properties such as <i>Lu</i> and <i>Nd</i> are
86  such as <i>Lu</i> and <i>Nd</i> are supported. Details are given in the  supported. Details are given in the
87  <a href="pcrepattern.html"><b>pcrepattern</b></a>  <a href="pcrepattern.html"><b>pcrepattern</b></a>
88  documentation.  documentation.
89  </P>  </P>
# Line 156  to the <b>configure</b> command. The val Line 157  to the <b>configure</b> command. The val
157  longer offsets slows down the operation of PCRE because it has to load  longer offsets slows down the operation of PCRE because it has to load
158  additional bytes when handling them.  additional bytes when handling them.
159  </P>  </P>
 <P>  
 If you build PCRE with an increased link size, test 2 (and test 5 if you are  
 using UTF-8) will fail. Part of the output of these tests is a representation  
 of the compiled pattern, and this changes with the link size.  
 </P>  
160  <br><a name="SEC9" href="#TOC1">AVOIDING EXCESSIVE STACK USAGE</a><br>  <br><a name="SEC9" href="#TOC1">AVOIDING EXCESSIVE STACK USAGE</a><br>
161  <P>  <P>
162  When matching with the <b>pcre_exec()</b> function, PCRE implements backtracking  When matching with the <b>pcre_exec()</b> function, PCRE implements backtracking
# Line 216  constraints. However, you can set a lowe Line 212  constraints. However, you can set a lowe
212  </pre>  </pre>
213  to the <b>configure</b> command. This value can also be overridden at run time.  to the <b>configure</b> command. This value can also be overridden at run time.
214  </P>  </P>
215  <br><a name="SEC11" href="#TOC1">USING EBCDIC CODE</a><br>  <br><a name="SEC11" href="#TOC1">CREATING CHARACTER TABLES AT BUILD TIME</a><br>
216    <P>
217    PCRE uses fixed tables for processing characters whose code values are less
218    than 256. By default, PCRE is built with a set of tables that are distributed
219    in the file <i>pcre_chartables.c.dist</i>. These tables are for ASCII codes
220    only. If you add
221    <pre>
222      --enable-rebuild-chartables
223    </pre>
224    to the <b>configure</b> command, the distributed tables are no longer used.
225    Instead, a program called <b>dftables</b> is compiled and run. This outputs the
226    source for new set of tables, created in the default locale of your C runtime
227    system. (This method of replacing the tables does not work if you are cross
228    compiling, because <b>dftables</b> is run on the local host. If you need to
229    create alternative tables when cross compiling, you will have to do so "by
230    hand".)
231    </P>
232    <br><a name="SEC12" href="#TOC1">USING EBCDIC CODE</a><br>
233  <P>  <P>
234  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
235  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 224  compiled to run in an EBCDIC environment Line 237  compiled to run in an EBCDIC environment
237  <pre>  <pre>
238    --enable-ebcdic    --enable-ebcdic
239  </pre>  </pre>
240  to the <b>configure</b> command.  to the <b>configure</b> command. This setting implies
241    --enable-rebuild-chartables.
242  </P>  </P>
243  <br><a name="SEC12" href="#TOC1">SEE ALSO</a><br>  <br><a name="SEC13" href="#TOC1">SEE ALSO</a><br>
244  <P>  <P>
245  <b>pcreapi</b>(3), <b>pcre_config</b>(3).  <b>pcreapi</b>(3), <b>pcre_config</b>(3).
246  </P>  </P>
247  <br><a name="SEC13" href="#TOC1">AUTHOR</a><br>  <br><a name="SEC14" href="#TOC1">AUTHOR</a><br>
248  <P>  <P>
249  Philip Hazel  Philip Hazel
250  <br>  <br>
# Line 239  University Computing Service Line 253  University Computing Service
253  Cambridge CB2 3QH, England.  Cambridge CB2 3QH, England.
254  <br>  <br>
255  </P>  </P>
256  <br><a name="SEC14" href="#TOC1">REVISION</a><br>  <br><a name="SEC15" href="#TOC1">REVISION</a><br>
257  <P>  <P>
258  Last updated: 06 March 2007  Last updated: 20 March 2007
259  <br>  <br>
260  Copyright &copy; 1997-2007 University of Cambridge.  Copyright &copy; 1997-2007 University of Cambridge.
261  <br>  <br>

Legend:
Removed from v.127  
changed lines
  Added in v.128

  ViewVC Help
Powered by ViewVC 1.1.5