source: general/genlib/pcre.xml@ aab13c9

trunk
Last change on this file since aab13c9 was aab13c9, checked in by Douglas R. Reno <renodr@…>, 3 months ago

pcre: remove instructions for moving libpcre.so to /lib (merged-/usr)

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