source: BOOK/final-system/common/bzip2.xml@ fa9f06a

clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since fa9f06a was b8bd862, checked in by Chris Staub <chris@…>, 11 years ago

Remove documentation symlinks

  • Property mode set to 100644
File size: 7.8 KB
RevLine 
[3f8be484]1<?xml version="1.0" encoding="ISO-8859-1"?>
[aa18ac0]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[3f8be484]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-bzip2" role="wrap">
9 <?dbhtml filename="bzip2.html"?>
10
11 <title>Bzip2-&bzip2-version;</title>
12
13 <indexterm zone="ch-system-bzip2">
14 <primary sortas="a-Bzip2">Bzip2</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Bzip2 package contains programs for compressing and
21 decompressing files. Compressing text files with <command>bzip2</command>
22 yields a much better compression percentage than with the traditional
23 <command>gzip</command>.</para>
24
25 </sect2>
26
27 <sect2 role="installation">
28 <title>Installation of Bzip2</title>
29
[1f7883fe]30 <para os="s1">By default Bzip2 creates some symlinks that use absolute
31 pathnames. The following sed will cause them to be created with relative
32 paths instead:</para>
[946b71d]33
34<screen os="s2"><userinput>sed -i -e 's:ln -s -f $(PREFIX)/bin/:ln -s :' Makefile</userinput></screen>
35
[b8bd862]36 <para os="s3">Make Bzip2 install its manpages in
37 <filename class="directory">/usr/share/man</filename> instead of
38 <filename class="directory">/usr/man</filename>:</para>
39
40<screen os="s4"><userinput>sed -i 's@X)/man@X)/share/man@g' ./Makefile</userinput></screen>
41
[3f8be484]42 <para os="a">The Bzip2 package does not contain a <command>configure</command>
43 script. Compile it with:</para>
44
[e0e40d3]45<screen os="b"><userinput>make -f Makefile-libbz2_so
[3f8be484]46make clean</userinput></screen>
47
[e0e40d3]48 <para os="c">The <parameter>-f</parameter> flag will cause Bzip2 to be built
[3f8be484]49 using a different <filename>Makefile</filename> file, in this case the
50 <filename>Makefile-libbz2_so</filename> file, which creates a dynamic
51 <filename class="libraryfile">libbz2.so</filename> library and links the
52 Bzip2 utilities against it.</para>
53
[ac3984c]54 <para os="d">Recompile the package using a non-shared library and test it:</para>
[3f8be484]55
[e0e40d3]56<screen os="e"><userinput>make</userinput></screen>
[3f8be484]57
[e0e40d3]58 <para os="g">Install the programs:</para>
[3f8be484]59
[05223c1]60<screen os="h"><userinput>make PREFIX=/usr install</userinput></screen>
[3f8be484]61
[e0e40d3]62 <para os="i">Install the shared <command>bzip2</command> binary into the
[3f8be484]63 <filename class="directory">/bin</filename> directory, make
64 some necessary symbolic links, and clean up:</para>
65
[94e6142]66<screen os="j"><userinput>cp -v bzip2-shared /bin/bzip2
67cp -av libbz2.so* /lib
68ln -sv ../../lib/libbz2.so.1.0 /usr/lib/libbz2.so
69rm -v /usr/bin/{bunzip2,bzcat,bzip2}
70ln -sv bzip2 /bin/bunzip2
71ln -sv bzip2 /bin/bzcat</userinput></screen>
[3f8be484]72
73 </sect2>
74
75 <sect2 id="contents-bzip2" role="content">
76 <title>Contents of Bzip2</title>
77
78 <segmentedlist>
79 <segtitle>Installed programs</segtitle>
80 <segtitle>Installed libraries</segtitle>
81
82 <seglistitem>
[1f7883fe]83 <seg>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp (link to
84 bzdiff), bzdiff, bzegrep (link to bzgrep), bzfgrep (link to bzgrep),
85 bzgrep, bzip2, bzip2recover, bzless (link to bzmore), and bzmore</seg>
[3f8be484]86 <seg>libbz2.a, libbz2.so (link to libbz2.so.1.0), libbz2.so.1.0 (link to
87 libbz2.so.&bzip2-version;), and libbz2.so.&bzip2-version;</seg>
88 </seglistitem>
89 </segmentedlist>
90
91 <variablelist>
92 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
93 <?dbfo list-presentation="list"?>
94 <?dbhtml list-presentation="table"?>
95
96 <varlistentry id="bunzip2">
97 <term><command>bunzip2</command></term>
98 <listitem>
99 <para>Decompresses bzipped files</para>
100 <indexterm zone="ch-system-bzip2 bunzip2">
101 <primary sortas="b-bunzip2">bunzip2</primary>
102 </indexterm>
103 </listitem>
104 </varlistentry>
105
106 <varlistentry id="bzcat">
107 <term><command>bzcat</command></term>
108 <listitem>
109 <para>Decompresses to standard output</para>
110 <indexterm zone="ch-system-bzip2 bzcat">
111 <primary sortas="b-bzcat">bzcat</primary>
112 </indexterm>
113 </listitem>
114 </varlistentry>
115
116 <varlistentry id="bzcmp">
117 <term><command>bzcmp</command></term>
118 <listitem>
119 <para>Runs <command>cmp</command> on bzipped files</para>
120 <indexterm zone="ch-system-bzip2 bzcmp">
121 <primary sortas="b-bzcmp">bzcmp</primary>
122 </indexterm>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry id="bzdiff">
127 <term><command>bzdiff</command></term>
128 <listitem>
129 <para>Runs <command>diff</command> on bzipped files</para>
130 <indexterm zone="ch-system-bzip2 bzdiff">
131 <primary sortas="b-bzdiff">bzdiff</primary>
132 </indexterm>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry id="bzegrep">
137 <term><command>bzegrep</command></term>
138 <listitem>
139 <para>Runs <command>egrep</command> on bzipped files</para>
140 <indexterm zone="ch-system-bzip2 bzegrep">
141 <primary sortas="b-bzegrep">bzegrep</primary>
142 </indexterm>
143 </listitem>
144 </varlistentry>
145
146 <varlistentry id="bzfgrep">
147 <term><command>bzfgrep</command></term>
148 <listitem>
149 <para>Runs <command>fgrep</command> on bzipped files</para>
150 <indexterm zone="ch-system-bzip2 bzfgrep">
151 <primary sortas="b-bzfgrep">bzfgrep</primary>
152 </indexterm>
153 </listitem>
154 </varlistentry>
155
[653cf49]156 <varlistentry id="bzgrep">
157 <term><command>bzgrep</command></term>
158 <listitem>
159 <para>Runs <command>grep</command> on bzipped files</para>
160 <indexterm zone="ch-system-bzip2 bzgrep">
161 <primary sortas="b-bzgrep">bzgrep</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165
[3f8be484]166 <varlistentry id="bzip2">
167 <term><command>bzip2</command></term>
168 <listitem>
169 <para>Compresses files using the Burrows-Wheeler block sorting text
170 compression algorithm with Huffman coding; the compression rate is
171 better than that achieved by more conventional compressors using
172 <quote>Lempel-Ziv</quote> algorithms, like <command>gzip</command></para>
173 <indexterm zone="ch-system-bzip2 bzip2">
174 <primary sortas="b-bzip2">bzip2</primary>
175 </indexterm>
176 </listitem>
177 </varlistentry>
178
179 <varlistentry id="bzip2recover">
180 <term><command>bzip2recover</command></term>
181 <listitem>
182 <para>Tries to recover data from damaged bzipped files</para>
183 <indexterm zone="ch-system-bzip2 bzip2recover">
184 <primary sortas="b-bzip2recover">bzip2recover</primary>
185 </indexterm>
186 </listitem>
187 </varlistentry>
188
189 <varlistentry id="bzless">
190 <term><command>bzless</command></term>
191 <listitem>
192 <para>Runs <command>less</command> on bzipped files</para>
193 <indexterm zone="ch-system-bzip2 bzless">
194 <primary sortas="b-bzless">bzless</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198
199 <varlistentry id="bzmore">
200 <term><command>bzmore</command></term>
201 <listitem>
202 <para>Runs <command>more</command> on bzipped files</para>
203 <indexterm zone="ch-system-bzip2 bzmore">
204 <primary sortas="b-bzmore">bzmore</primary>
205 </indexterm>
206 </listitem>
207 </varlistentry>
208
209 <varlistentry id="libbz2">
210 <term><filename class="libraryfile">libbz2*</filename></term>
211 <listitem>
212 <para>The library implementing lossless, block-sorting data
213 compression, using the Burrows-Wheeler algorithm</para>
214 <indexterm zone="ch-system-bzip2 libbz2">
215 <primary sortas="c-libbz2*">libbz2*</primary>
216 </indexterm>
217 </listitem>
218 </varlistentry>
219
220 </variablelist>
221
222 </sect2>
223
224</sect1>
Note: See TracBrowser for help on using the repository browser.