source: general/genlib/pcre.xml@ 0928035

systemd-13485
Last change on this file since 0928035 was 0928035, checked in by Douglas R. Reno <renodr@…>, 6 years ago

Document a test suite failure in p11-kit
Add a patch for Valgrind to fix the test suite to use the new pthread_barrier implementation in Glibc
Text changes (esp. sg3_utils)
Tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@17015 af4574ff-66df-0310-9fd7-8a98e5e911e0

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