source: general/genlib/pcre2.xml@ 89d0029

10.0 10.1 11.0 11.1 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 89d0029 was 89d0029, checked in by Ken Moffat <ken@…>, 4 years ago

tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@20363 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 6.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY pcre2-download-http "&sourceforge-dl;/pcre/pcre2-&pcre2-version;.tar.bz2">
8 <!ENTITY pcre2-download-ftp "ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre2-&pcre2-version;.tar.bz2">
9 <!ENTITY pcre2-md5sum "e0b91c891a3c49050f7fd15de33d0ba4">
10 <!ENTITY pcre2-size "1.6 MB">
11 <!ENTITY pcre2-buildsize "19 MB (with tests)">
12 <!ENTITY pcre2-time "0.3 SBU (with tests)">
13]>
14
15<sect1 id="pcre2" xreflabel="pcre2-&pcre2-version;">
16 <?dbhtml filename="pcre2.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>PCRE2-&pcre2-version;</title>
24
25 <indexterm zone="pcre2">
26 <primary sortas="a-pcre2">PCRE2</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to PCRE2</title>
31
32 <para>
33 The <application>PCRE2</application> package contains a new generation of
34 the <application>Perl Compatible Regular Expression</application>
35 libraries. These are useful for implementing regular expression pattern
36 matching using the same syntax and semantics as <application>Perl</application>.
37 </para>
38
39 &lfs83_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&pcre2-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&pcre2-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &pcre2-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &pcre2-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &pcre2-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &pcre2-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">PCRE2 Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Optional</bridgehead>
78 <para role="optional">
79 <xref linkend="valgrind"/>
80 </para>
81
82 <para condition="html" role="usernotes">
83 User Notes: <ulink url="&blfs-wiki;/pcre2"/>
84 </para>
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of PCRE2</title>
89
90 <para>
91 Install <application>PCRE2</application> by running the following
92 commands:
93 </para>
94
95<screen><userinput>./configure --prefix=/usr \
96 --docdir=/usr/share/doc/pcre2-&pcre2-version; \
97 --enable-unicode \
98 --enable-jit \
99 --enable-pcre2-16 \
100 --enable-pcre2-32 \
101 --enable-pcre2grep-libz \
102 --enable-pcre2grep-libbz2 \
103 --enable-pcre2test-libreadline \
104 --disable-static &amp;&amp;
105make</userinput></screen>
106
107 <para>
108 To test the results, issue: <command>make check</command>.
109 </para>
110
111 <para>
112 Now, as the <systemitem class="username">root</systemitem> user:
113 </para>
114
115<screen role="root"><userinput>make install</userinput></screen>
116 </sect2>
117
118 <sect2 role="commands">
119 <title>Command Explanations</title>
120
121 <para>
122 <parameter>--enable-unicode</parameter>: This switch enables Unicode
123 support and includes the functions for handling UTF-8/16/32 character
124 strings in the library.
125 </para>
126
127 <para>
128 <parameter>--enable-pcre2-16</parameter>: This switch enables 16 bit
129 character support.
130 </para>
131
132 <para>
133 <parameter>--enable-pcre2-32</parameter>: This switch enables 32 bit
134 character support.
135 </para>
136
137 <para>
138 <parameter>--enable-pcre2grep-libz</parameter>: This switch adds support
139 for reading .gz compressed files to <application>pcre2grep</application>.
140 </para>
141
142 <para>
143 <parameter>--enable-pcre2grep-libbz2</parameter>: This switch adds
144 support for reading .bz2 compressed files to
145 <application>pcre2grep</application>.
146 </para>
147
148 <para>
149 <parameter>--enable-pcre2test-libreadline</parameter>: This switch adds
150 line editing and history features to the
151 <application>pcre2test</application> program.
152 </para>
153
154 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
155 href="../../xincludes/static-libraries.xml"/>
156
157 <para>
158 <option>--enable-jit</option>: this option enables Just-in-time compiling,
159 which can greatly speed up pattern matching.
160 </para>
161
162 </sect2>
163
164 <sect2 role="content">
165 <title>Contents</title>
166
167 <segmentedlist>
168 <segtitle>Installed Programs</segtitle>
169 <segtitle>Installed Libraries</segtitle>
170 <segtitle>Installed Directory</segtitle>
171
172 <seglistitem>
173 <seg>
174 pcre2-config,
175 pcre2grep,
176 and pcre2test.
177 </seg>
178 <seg>
179 libpcre2-8.so,
180 libpcre2-16.so,
181 libpcre2-32.so,
182 and libpcre2-posix.so
183 </seg>
184 <seg>
185 /usr/share/doc/pcre2-&pcre2-version;
186 </seg>
187 </seglistitem>
188 </segmentedlist>
189
190 <variablelist>
191 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
192 <?dbfo list-presentation="list"?>
193 <?dbhtml list-presentation="table"?>
194
195 <varlistentry id="pcre2grep">
196 <term><command>pcre2grep</command></term>
197 <listitem>
198 <para>
199 is a version of <application>grep</application>
200 that understands
201 <application>Perl compatible regular expressions.</application>.
202 </para>
203 <indexterm zone="pcre2 pcre2grep">
204 <primary sortas="b-pcre2grep">pcre2grep</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="pcre2test">
210 <term><command>pcre2test</command></term>
211 <listitem>
212 <para>
213 can test a
214 <application>Perl compatible regular expression.</application>
215 </para>
216 <indexterm zone="pcre2 pcre2test">
217 <primary sortas="b-pcre2test">pcre2</primary>
218 </indexterm>
219 </listitem>
220 </varlistentry>
221
222 <varlistentry id="pcre2-config">
223 <term><command>pcre2-config</command></term>
224 <listitem>
225 <para>
226 outputs compilation information to programs linking against the
227 <application>PCRE2</application> libraries.
228 </para>
229 <indexterm zone="pcre2 pcre2-config">
230 <primary sortas="b-pcre2-config">pcre2-config</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 </variablelist>
236
237 </sect2>
238
239</sect1>
Note: See TracBrowser for help on using the repository browser.