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

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

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

revision 1054 by ph10, Sat Sep 8 15:59:01 2012 UTC revision 1055 by chpe, Tue Oct 16 15:53:30 2012 UTC
# Line 33  The following sections include descripti Line 33  The following sections include descripti
33  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.
34  .  .
35  .  .
36  .SH "BUILDING 8-BIT and 16-BIT LIBRARIES"  .SH "BUILDING 8-BIT, 16-BIT AND 32-BIT LIBRARIES"
37  .rs  .rs
38  .sp  .sp
39  By default, a library called \fBlibpcre\fP is built, containing functions that  By default, a library called \fBlibpcre\fP is built, containing functions that
# Line 45  strings, by adding Line 45  strings, by adding
45  .sp  .sp
46    --enable-pcre16    --enable-pcre16
47  .sp  .sp
48    to the \fBconfigure\fP command. You can also build a separate
49    library, called \fBlibpcre32\fP, in which strings are contained in vectors of
50    32-bit data units and interpreted either as single-unit characters or UTF-32
51    strings, by adding
52    .sp
53      --enable-pcre32
54    .sp
55  to the \fBconfigure\fP command. If you do not want the 8-bit library, add  to the \fBconfigure\fP command. If you do not want the 8-bit library, add
56  .sp  .sp
57    --disable-pcre8    --disable-pcre8
58  .sp  .sp
59  as well. At least one of the two libraries must be built. Note that the C++ and  as well. At least one of the two libraries must be built. Note that the C++ and
60  POSIX wrappers are for the 8-bit library only, and that \fBpcregrep\fP is an  POSIX wrappers are for the 8-bit library only, and that \fBpcregrep\fP is an
61  8-bit program. None of these are built if you select only the 16-bit library.  8-bit program. None of these are built if you select only the 16-bit or 32-bit
62    libraries.
63  .  .
64  .  .
65  .SH "BUILDING SHARED AND STATIC LIBRARIES"  .SH "BUILDING SHARED AND STATIC LIBRARIES"
# Line 79  strings). You can disable this by adding Line 87  strings). You can disable this by adding
87  to the \fBconfigure\fP command.  to the \fBconfigure\fP command.
88  .  .
89  .  .
90  .SH "UTF-8 and UTF-16 SUPPORT"  .SH "UTF-8, UTF-16 AND UTF-32 SUPPORT"
91  .rs  .rs
92  .sp  .sp
93  To build PCRE with support for UTF Unicode character strings, add  To build PCRE with support for UTF Unicode character strings, add
# Line 87  To build PCRE with support for UTF Unico Line 95  To build PCRE with support for UTF Unico
95    --enable-utf    --enable-utf
96  .sp  .sp
97  to the \fBconfigure\fP command. This setting applies to both libraries, adding  to the \fBconfigure\fP command. This setting applies to both libraries, adding
98  support for UTF-8 to the 8-bit library and support for UTF-16 to the 16-bit  support for UTF-8 to the 8-bit library, support for UTF-16 to the 16-bit
99  library. There are no separate options for enabling UTF-8 and UTF-16  library, and support for UTF-32 to the to the 32-bit library.
100    There are no separate options for enabling UTF-8, UTF-16 and UTF-32
101  independently because that would allow ridiculous settings such as requesting  independently because that would allow ridiculous settings such as requesting
102  UTF-16 support while building only the 8-bit library. It is not possible to  UTF-16 support while building only the 8-bit library. It is not possible to
103  build one library with UTF support and the other without in the same  build one library with UTF support and the other without in the same
104  configuration. (For backwards compatibility, --enable-utf8 is a synonym of  configuration. (For backwards compatibility, --enable-utf8 is a synonym of
105  --enable-utf.)  --enable-utf.)
106  .P  .P
107  Of itself, this setting does not make PCRE treat strings as UTF-8 or UTF-16. As  Of itself, this setting does not make PCRE treat strings as UTF-8, UTF-16 or
108  well as compiling PCRE with this option, you also have have to set the  UTF-32. As well as compiling PCRE with this option, you also have have to set
109  PCRE_UTF8 or PCRE_UTF16 option when you call one of the pattern compiling  the PCRE_UTF8 or PCRE_UTF16 or PCRE_UTF32 option when you call one of the
110  functions.  pattern compiling functions.
111  .P  .P
112  If you set --enable-utf when compiling in an EBCDIC environment, PCRE expects  If you set --enable-utf when compiling in an EBCDIC environment, PCRE expects
113  its input to be either ASCII or UTF-8 (depending on the run-time option). It is  its input to be either ASCII or UTF-8 (depending on the run-time option). It is
# Line 231  three-byte or four-byte offsets by addin Line 240  three-byte or four-byte offsets by addin
240    --with-link-size=3    --with-link-size=3
241  .sp  .sp
242  to the \fBconfigure\fP command. The value given must be 2, 3, or 4. For the  to the \fBconfigure\fP command. The value given must be 2, 3, or 4. For the
243  16-bit library, a value of 3 is rounded up to 4. Using longer offsets slows  16-bit and 32-bit library, a value of 3 is rounded up to 4. Using longer offsets
244  down the operation of PCRE because it has to load additional data when handling  slows down the operation of PCRE because it has to load additional data when
245  them.  handling them.
246  .  .
247  .  .
248  .SH "AVOIDING EXCESSIVE STACK USAGE"  .SH "AVOIDING EXCESSIVE STACK USAGE"
# Line 419  immediately before the \fBconfigure\fP c Line 428  immediately before the \fBconfigure\fP c
428  .SH "SEE ALSO"  .SH "SEE ALSO"
429  .rs  .rs
430  .sp  .sp
431  \fBpcreapi\fP(3), \fBpcre16\fP, \fBpcre_config\fP(3).  \fBpcreapi\fP(3), \fBpcre16\fP, \fBpcre32\fP, \fBpcre_config\fP(3).
432  .  .
433  .  .
434  .SH AUTHOR  .SH AUTHOR

Legend:
Removed from v.1054  
changed lines
  Added in v.1055

  ViewVC Help
Powered by ViewVC 1.1.5