source: general/genlib/pcre.xml@ 45ab6c7

trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • 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 "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 &amp;&amp;
115mv -v /usr/lib/libpcre.so.* /lib &amp;&amp;
116ln -sfv ../../lib/$(readlink /usr/lib/libpcre.so) /usr/lib/libpcre.so</userinput></screen>
117
118 </sect2>
119
120 <sect2 role="commands">
121 <title>Command Explanations</title>
122
123 <para>
124 <parameter>--enable-unicode-properties</parameter>: This switch enables
125 Unicode properties support and includes the code for handling UTF-8/16/32
126 character strings in the library. You need this switch if you are going to
127 build <xref linkend="glib2"/> with the
128 <parameter>--with-pcre=system</parameter> switch.
129 </para>
130
131 <para>
132 <parameter>--enable-pcre16</parameter>: This switch enables 16 bit
133 character support.
134 </para>
135
136 <para>
137 <parameter>--enable-pcre32</parameter>: This switch enables 32 bit
138 character support.
139 </para>
140
141 <para>
142 <parameter>--enable-pcregrep-libz</parameter>: This switch adds
143 support to <command>pcregrep</command> to read
144 <filename class="extension">.gz</filename> compressed files.
145 </para>
146
147 <para>
148 <parameter>--enable-pcregrep-libbz2</parameter>: This switch adds
149 support to <command>pcregrep</command> to read
150 <filename class="extension">.bz2</filename> compressed files.
151 </para>
152
153 <para>
154 <parameter>--enable-pcretest-libreadline</parameter>: This switch adds line
155 editing and history features to <command>pcretest</command> program.
156 </para>
157
158 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
159 href="../../xincludes/static-libraries.xml"/>
160
161 <para>
162 <command>mv -v /usr/lib/libpcre.so.* /lib</command>: Moves the
163 <application>PCRE</application> library on the root filesystem
164 so that it is available in case <command>grep</command>
165 gets reinstalled with <application>PCRE</application> support.
166 </para>
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.