source: general/genlib/pcre.xml@ 82bdecf

10.0 10.1 11.0 11.1 11.2 9.0 9.1 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 82bdecf was 82bdecf, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tag Xorg and it's dependencies.
Some misc text tweaks.

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

  • Property mode set to 100644
File size: 7.3 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 pcre-download-http "https://ftp.pcre.org/pub/pcre/pcre-&pcre-version;.tar.bz2">
8 <!ENTITY pcre-download-ftp "ftp://ftp.pcre.org/pub/pcre/pcre-&pcre-version;.tar.bz2">
9 <!ENTITY pcre-md5sum "636222e79e392c3d95dcc545f24f98c4">
10 <!ENTITY pcre-size "1.5 MB">
11 <!ENTITY pcre-buildsize "19 MB (with tests)">
12 <!ENTITY pcre-time "0.3 SBU (with tests)">
13]>
14
15<sect1 id="pcre" xreflabel="PCRE-&pcre-version;">
16 <?dbhtml filename="pcre.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>PCRE-&pcre-version;</title>
24
25 <indexterm zone="pcre">
26 <primary sortas="a-PCRE">PCRE</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to PCRE</title>
31
32 <para>
33 The <application>PCRE</application> package contains
34 <application>Perl</application> Compatible Regular Expression
35 libraries. These are useful for implementing regular expression
36 pattern matching using the same syntax and semantics as
37 <application>Perl</application> 5.
38 </para>
39
40 &lfs90_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&pcre-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&pcre-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &pcre-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &pcre-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &pcre-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &pcre-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">PCRE Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Optional</bridgehead>
79 <para role="optional">
80 <xref linkend="valgrind"/>
81 </para>
82
83 <para condition="html" role="usernotes">User Notes:
84 <ulink url="&blfs-wiki;/pcre"/>
85 </para>
86 </sect2>
87
88 <sect2 role="installation">
89 <title>Installation of PCRE</title>
90
91 <para>
92 Install <application>PCRE</application> by running
93 the following commands:
94 </para>
95
96<screen><userinput>./configure --prefix=/usr \
97 --docdir=/usr/share/doc/pcre-&pcre-version; \
98 --enable-unicode-properties \
99 --enable-pcre16 \
100 --enable-pcre32 \
101 --enable-pcregrep-libz \
102 --enable-pcregrep-libbz2 \
103 --enable-pcretest-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 &amp;&amp;
116mv -v /usr/lib/libpcre.so.* /lib &amp;&amp;
117ln -sfv ../../lib/$(readlink /usr/lib/libpcre.so) /usr/lib/libpcre.so</userinput></screen>
118
119 </sect2>
120
121 <sect2 role="commands">
122 <title>Command Explanations</title>
123
124 <para>
125 <parameter>--enable-unicode-properties</parameter>: This switch enables
126 Unicode properties support and includes the code for handling UTF-8/16/32
127 character strings in the library. You need this switch if you are going to
128 build <xref linkend="glib2"/> with the
129 <parameter>--with-pcre=system</parameter> switch.
130 </para>
131
132 <para>
133 <parameter>--enable-pcre16</parameter>: This switch enables 16 bit
134 character support.
135 </para>
136
137 <para>
138 <parameter>--enable-pcre32</parameter>: This switch enables 32 bit
139 character support.
140 </para>
141
142 <para>
143 <parameter>--enable-pcregrep-libz</parameter>: This switch adds
144 support to <command>pcregrep</command> to read
145 <filename class="extension">.gz</filename> compressed files.
146 </para>
147
148 <para>
149 <parameter>--enable-pcregrep-libbz2</parameter>: This switch adds
150 support to <command>pcregrep</command> to read
151 <filename class="extension">.bz2</filename> compressed files.
152 </para>
153
154 <para>
155 <parameter>--enable-pcretest-libreadline</parameter>: This switch adds line
156 editing and history features to <command>pcretest</command> program.
157 </para>
158
159 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
160 href="../../xincludes/static-libraries.xml"/>
161
162 <para>
163 <command>mv -v /usr/lib/libpcre.so.* /lib</command>: Moves the
164 <application>PCRE</application> library on the root filesystem
165 so that it is available in case <command>grep</command>
166 gets reinstalled with <application>PCRE</application> support.
167 </para>
168
169 <para>
170 <option>--enable-jit</option>: this option enables Just-in-time
171 compiling, which can greatly speed up pattern matching.
172 </para>
173
174 </sect2>
175
176 <sect2 role="content">
177 <title>Contents</title>
178
179 <segmentedlist>
180 <segtitle>Installed Programs</segtitle>
181 <segtitle>Installed Libraries</segtitle>
182 <segtitle>Installed Directory</segtitle>
183
184 <seglistitem>
185 <seg>
186 pcregrep, pcretest, and pcre-config
187 </seg>
188 <seg>
189 libpcre.so, libpcre16.so, libpcre32.so,
190 libpcrecpp.so and libpcreposix.so
191 </seg>
192 <seg>
193 /usr/share/doc/pcre-&pcre-version;
194 </seg>
195 </seglistitem>
196 </segmentedlist>
197
198 <variablelist>
199 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
200 <?dbfo list-presentation="list"?>
201 <?dbhtml list-presentation="table"?>
202
203 <varlistentry id="pcregrep">
204 <term><command>pcregrep</command></term>
205 <listitem>
206 <para>
207 is a <command>grep</command> that understands
208 <application>Perl</application> compatible regular expressions.
209 </para>
210 <indexterm zone="pcre pcregrep">
211 <primary sortas="b-pcregrep">pcregrep</primary>
212 </indexterm>
213 </listitem>
214 </varlistentry>
215
216 <varlistentry id="pcretest">
217 <term><command>pcretest</command></term>
218 <listitem>
219 <para>
220 can test a <application>Perl</application> compatible
221 regular expression.
222 </para>
223 <indexterm zone="pcre pcretest">
224 <primary sortas="b-pcretest">pcretest</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="pcre-config">
230 <term><command>pcre-config</command></term>
231 <listitem>
232 <para>
233 is used during the compile process of programs linking to
234 the <application>PCRE</application> libraries.
235 </para>
236 <indexterm zone="pcre pcre-config">
237 <primary sortas="b-pcre-config">pcre-config</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 </variablelist>
243
244 </sect2>
245
246</sect1>
Note: See TracBrowser for help on using the repository browser.