source: general/genlib/pcre2.xml@ c1b3614

trunk
Last change on this file since c1b3614 was c1b3614, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Package updates
Update to nspr-4.31.
Update to pcre2-10.37.
Update to libinput-1.17.3 (Xorg driver).

  • 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 "https://ftp.pcre.org/pub/pcre/pcre2-&pcre2-version;.tar.bz2">
8 <!ENTITY pcre2-download-ftp "ftp://ftp.pcre.org/pub/pcre/pcre2-&pcre2-version;.tar.bz2">
9 <!ENTITY pcre2-md5sum "85dc7f2233491b4b6ec6115220da99c6">
10 <!ENTITY pcre2-size "1.7 MB">
11 <!ENTITY pcre2-buildsize "18 MB (with tests)">
12 <!ENTITY pcre2-time "0.5 SBU (with tests)">
13]>
14
15<sect1 id="pcre2" xreflabel="pcre2-&pcre2-version;">
16 <?dbhtml filename="pcre2.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>PCRE2-&pcre2-version;</title>
23
24 <indexterm zone="pcre2">
25 <primary sortas="a-pcre2">PCRE2</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to PCRE2</title>
30
31 <para>
32 The <application>PCRE2</application> package contains a new generation of
33 the <application>Perl Compatible Regular Expression</application>
34 libraries. These are useful for implementing regular expression pattern
35 matching using the same syntax and semantics as <application>Perl</application>.
36 </para>
37
38 &lfs101_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&pcre2-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&pcre2-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &pcre2-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &pcre2-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &pcre2-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &pcre2-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">PCRE2 Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Optional</bridgehead>
77 <para role="optional">
78 <xref linkend="valgrind"/> and
79 <ulink url="http://thrysoee.dk/editline/">libedit</ulink>
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 <parameter>--enable-jit</parameter>: this option enables Just-in-time
159 compiling, 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.