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

clfs-3.0.0-sysvinitsysvinit
Last change on this file since c2102b28 was c2102b28, checked in by Chris Staub <chris@…>, 10 years ago

Improve consistency in package installation lists, mainly removing 'and'

Conflicts:

BOOK/final-system/common/attr.xml

  • Property mode set to 100644
File size: 7.8 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-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
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>
33
34<screen os="s2"><userinput>sed -i -e 's:ln -s -f $(PREFIX)/bin/:ln -s :' Makefile</userinput></screen>
35
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
42    <para os="a">The Bzip2 package does not contain a <command>configure</command>
43    script. Compile it with:</para>
44
45<screen os="b"><userinput>make -f Makefile-libbz2_so
46make clean</userinput></screen>
47
48    <para os="c">The <parameter>-f</parameter> flag will cause Bzip2 to be built
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
54    <para os="d">Recompile the package using a non-shared library and test it:</para>
55
56<screen os="e"><userinput>make</userinput></screen>
57
58    <para os="g">Install the programs:</para>
59
60<screen os="h"><userinput>make PREFIX=/usr install</userinput></screen>
61
62    <para os="i">Install the shared <command>bzip2</command> binary into the
63    <filename class="directory">/bin</filename> directory, make
64    some necessary symbolic links, and clean up:</para>
65
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>
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>
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), bzmore</seg>
86        <seg>libbz2.a, libbz2.so (link to libbz2.so.1.0), libbz2.so.1.0 (link to
87        libbz2.so.&bzip2-version;), 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
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
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.