source: chapter06/grep.xml@ 921fcd3

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 6.5 6.6 6.7 6.8 7.0 7.1 7.2 7.3 7.4 7.5 7.5-systemd 7.6 7.6-systemd 7.7 7.7-systemd 7.8 7.8-systemd 7.9 7.9-systemd 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since 921fcd3 was 921fcd3, checked in by Matthew Burgess <matthew@…>, 15 years ago

Update Grep testsuite result explanation. Fixes #2418.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@8926 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 4.1 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
8<sect1 id="ch-system-grep" role="wrap">
9 <?dbhtml filename="grep.html"?>
10
11 <sect1info condition="script">
12 <productname>grep</productname>
13 <productnumber>&grep-version;</productnumber>
14 <address>&grep-url;</address>
15 </sect1info>
16
17 <title>Grep-&grep-version;</title>
18
19 <indexterm zone="ch-system-grep">
20 <primary sortas="a-Grep">Grep</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Grep package contains programs for searching through files.</para>
27
28 <segmentedlist>
29 <segtitle>&buildtime;</segtitle>
30 <segtitle>&diskspace;</segtitle>
31
32 <seglistitem>
33 <seg>&grep-ch6-sbu;</seg>
34 <seg>&grep-ch6-du;</seg>
35 </seglistitem>
36 </segmentedlist>
37
38 </sect2>
39
40 <sect2 role="installation">
41 <title>Installation of Grep</title>
42
43 <para>The current Grep package has many bugs, especially in the support of
44 multibyte locales. The following consolidated patch from Debian fixes some of them,
45 improves the number of individual tests which are passed, and much improves the
46 speed in UTF-8 locales:</para>
47
48<screen><userinput remap="pre">patch -Np1 -i ../&grep-debian-patch;</userinput></screen>
49
50 <para>Prepare Grep for compilation:</para>
51
52<screen><userinput remap="configure">./configure --prefix=/usr \
53 --bindir=/bin \
54 --without-included-regex</userinput></screen>
55
56
57 <variablelist>
58 <title>The meaning of the configure switch:</title>
59 <varlistentry>
60 <term><parameter>--without-included-regex</parameter></term>
61 <listitem>
62 <para>The configure check for Glibc's regex library is broken when
63 building against Glibc-&glibc-version;. This switch forces the use
64 of Glibc's regex library.</para>
65 </listitem>
66 </varlistentry>
67 </variablelist>
68
69
70 <para>Compile the package:</para>
71
72<screen><userinput remap="make">make</userinput></screen>
73
74 <para>To test the results, issue:</para>
75
76<screen><userinput remap="test">make check || true</userinput></screen>
77
78 <para>There are known test failures in the <command>fmbtest.sh</command>
79 tests. The &quot;|| true&quot; construct is
80 used to avoid automated build scripts failing due to the test failures.
81 A good run will show 1 failure from 14 tests, although the test failure
82 will detail 2 failed sub-tests.</para>
83
84 <para>Install the package:</para>
85
86<screen><userinput remap="install">make install</userinput></screen>
87
88 </sect2>
89
90 <sect2 id="contents-grep" role="content">
91 <title>Contents of Grep</title>
92
93 <segmentedlist>
94 <segtitle>Installed programs</segtitle>
95
96 <seglistitem>
97 <seg>egrep, fgrep, and grep</seg>
98 </seglistitem>
99 </segmentedlist>
100
101 <variablelist>
102 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
103 <?dbfo list-presentation="list"?>
104 <?dbhtml list-presentation="table"?>
105
106 <varlistentry id="egrep">
107 <term><command>egrep</command></term>
108 <listitem>
109 <para>Prints lines matching an extended regular expression</para>
110 <indexterm zone="ch-system-grep egrep">
111 <primary sortas="b-egrep">egrep</primary>
112 </indexterm>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry id="fgrep">
117 <term><command>fgrep</command></term>
118 <listitem>
119 <para>Prints lines matching a list of fixed strings</para>
120 <indexterm zone="ch-system-grep fgrep">
121 <primary sortas="b-fgrep">fgrep</primary>
122 </indexterm>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry id="grep">
127 <term><command>grep</command></term>
128 <listitem>
129 <para>Prints lines matching a basic regular expression</para>
130 <indexterm zone="ch-system-grep grep">
131 <primary sortas="b-grep">grep</primary>
132 </indexterm>
133 </listitem>
134 </varlistentry>
135
136 </variablelist>
137
138 </sect2>
139
140</sect1>
Note: See TracBrowser for help on using the repository browser.