bzip2.xml 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250
  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. <sect1 id="ch-system-bzip2" role="wrap">
  8. <?dbhtml filename="bzip2.html"?>
  9. <sect1info condition="script">
  10. <productname>bzip2</productname>
  11. <productnumber>&bzip2-version;</productnumber>
  12. <address>&bzip2-url;</address>
  13. </sect1info>
  14. <title>Bzip2-&bzip2-version;</title>
  15. <indexterm zone="ch-system-bzip2">
  16. <primary sortas="a-Bzip2">Bzip2</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The Bzip2 package contains programs for compressing and decompressing
  21. files. Compressing text files with <command>bzip2</command> yields a much
  22. better compression percentage than with the traditional
  23. <command>gzip</command>.</para>
  24. <segmentedlist>
  25. <segtitle>&buildtime;</segtitle>
  26. <segtitle>&diskspace;</segtitle>
  27. <seglistitem>
  28. <seg>&bzip2-ch6-sbu;</seg>
  29. <seg>&bzip2-ch6-du;</seg>
  30. </seglistitem>
  31. </segmentedlist>
  32. </sect2>
  33. <sect2 role="installation">
  34. <title>Installation of Bzip2</title>
  35. <para>Apply a patch that will install the documentation for this package:</para>
  36. <screen><userinput remap="pre">patch -Np1 -i ../&bzip2-docs-patch;</userinput></screen>
  37. <para>The following command ensures installation of symbolic links are relative:</para>
  38. <screen><userinput remap="pre">sed -i 's@\(ln -s -f \)$(PREFIX)/bin/@\1@' Makefile</userinput></screen>
  39. <para>Ensure the man pages are installed into the correct location:</para>
  40. <screen><userinput remap="pre">sed -i "s@(PREFIX)/man@(PREFIX)/share/man@g" Makefile</userinput></screen>
  41. <para>Prepare Bzip2 for compilation with:</para>
  42. <screen><userinput remap="make">make -f Makefile-libbz2_so
  43. make clean</userinput></screen>
  44. <variablelist>
  45. <title>The meaning of the make parameter:</title>
  46. <varlistentry>
  47. <term><parameter>-f Makefile-libbz2_so</parameter></term>
  48. <listitem>
  49. <para>This will cause Bzip2 to be built using a different
  50. <filename>Makefile</filename> file, in this case the
  51. <filename>Makefile-libbz2_so</filename> file, which creates a dynamic
  52. <filename class="libraryfile">libbz2.so</filename> library and links
  53. the Bzip2 utilities against it.</para>
  54. </listitem>
  55. </varlistentry>
  56. </variablelist>
  57. <para>Compile and test the package:</para>
  58. <screen><userinput remap="make">make</userinput></screen>
  59. <para>Install the programs:</para>
  60. <screen><userinput remap="install">make PREFIX=/usr install</userinput></screen>
  61. <para>Install the shared <command>bzip2</command> binary into the
  62. <filename class="directory">/bin</filename> directory, make
  63. some necessary symbolic links, and clean up:</para>
  64. <screen><userinput remap="install">cp -v bzip2-shared /bin/bzip2
  65. cp -av libbz2.so* /lib
  66. ln -sv ../../lib/libbz2.so.1.0 /usr/lib/libbz2.so
  67. rm -v /usr/bin/{bunzip2,bzcat,bzip2}
  68. ln -sv bzip2 /bin/bunzip2
  69. ln -sv bzip2 /bin/bzcat</userinput></screen>
  70. </sect2>
  71. <sect2 id="contents-bzip2" role="content">
  72. <title>Contents of Bzip2</title>
  73. <segmentedlist>
  74. <segtitle>Installed programs</segtitle>
  75. <segtitle>Installed libraries</segtitle>
  76. <segtitle>Installed directory</segtitle>
  77. <seglistitem>
  78. <seg>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp (link to
  79. bzdiff), bzdiff, bzegrep (link to bzgrep), bzfgrep (link to bzgrep),
  80. bzgrep, bzip2, bzip2recover, bzless (link to bzmore), and bzmore</seg>
  81. <seg>libbz2.{a,so}</seg>
  82. <seg>/usr/share/doc/bzip2-&bzip2-version;</seg>
  83. </seglistitem>
  84. </segmentedlist>
  85. <variablelist>
  86. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  87. <?dbfo list-presentation="list"?>
  88. <?dbhtml list-presentation="table"?>
  89. <varlistentry id="bunzip2">
  90. <term><command>bunzip2</command></term>
  91. <listitem>
  92. <para>Decompresses bzipped files</para>
  93. <indexterm zone="ch-system-bzip2 bunzip2">
  94. <primary sortas="b-bunzip2">bunzip2</primary>
  95. </indexterm>
  96. </listitem>
  97. </varlistentry>
  98. <varlistentry id="bzcat">
  99. <term><command>bzcat</command></term>
  100. <listitem>
  101. <para>Decompresses to standard output</para>
  102. <indexterm zone="ch-system-bzip2 bzcat">
  103. <primary sortas="b-bzcat">bzcat</primary>
  104. </indexterm>
  105. </listitem>
  106. </varlistentry>
  107. <varlistentry id="bzcmp">
  108. <term><command>bzcmp</command></term>
  109. <listitem>
  110. <para>Runs <command>cmp</command> on bzipped files</para>
  111. <indexterm zone="ch-system-bzip2 bzcmp">
  112. <primary sortas="b-bzcmp">bzcmp</primary>
  113. </indexterm>
  114. </listitem>
  115. </varlistentry>
  116. <varlistentry id="bzdiff">
  117. <term><command>bzdiff</command></term>
  118. <listitem>
  119. <para>Runs <command>diff</command> on bzipped files</para>
  120. <indexterm zone="ch-system-bzip2 bzdiff">
  121. <primary sortas="b-bzdiff">bzdiff</primary>
  122. </indexterm>
  123. </listitem>
  124. </varlistentry>
  125. <varlistentry id="bzegrep">
  126. <term><command>bzegrep</command></term>
  127. <listitem>
  128. <para>Runs <command>egrep</command> on bzipped files</para>
  129. <indexterm zone="ch-system-bzip2 bzegrep">
  130. <primary sortas="b-bzegrep">bzegrep</primary>
  131. </indexterm>
  132. </listitem>
  133. </varlistentry>
  134. <varlistentry id="bzfgrep">
  135. <term><command>bzfgrep</command></term>
  136. <listitem>
  137. <para>Runs <command>fgrep</command> on bzipped files</para>
  138. <indexterm zone="ch-system-bzip2 bzfgrep">
  139. <primary sortas="b-bzfgrep">bzfgrep</primary>
  140. </indexterm>
  141. </listitem>
  142. </varlistentry>
  143. <varlistentry id="bzgrep">
  144. <term><command>bzgrep</command></term>
  145. <listitem>
  146. <para>Runs <command>grep</command> on bzipped files</para>
  147. <indexterm zone="ch-system-bzip2 bzgrep">
  148. <primary sortas="b-bzgrep">bzgrep</primary>
  149. </indexterm>
  150. </listitem>
  151. </varlistentry>
  152. <varlistentry id="bzip2">
  153. <term><command>bzip2</command></term>
  154. <listitem>
  155. <para>Compresses files using the Burrows-Wheeler block sorting text
  156. compression algorithm with Huffman coding; the compression rate is
  157. better than that achieved by more conventional compressors using
  158. <quote>Lempel-Ziv</quote> algorithms, like <command>gzip</command></para>
  159. <indexterm zone="ch-system-bzip2 bzip2">
  160. <primary sortas="b-bzip2">bzip2</primary>
  161. </indexterm>
  162. </listitem>
  163. </varlistentry>
  164. <varlistentry id="bzip2recover">
  165. <term><command>bzip2recover</command></term>
  166. <listitem>
  167. <para>Tries to recover data from damaged bzipped files</para>
  168. <indexterm zone="ch-system-bzip2 bzip2recover">
  169. <primary sortas="b-bzip2recover">bzip2recover</primary>
  170. </indexterm>
  171. </listitem>
  172. </varlistentry>
  173. <varlistentry id="bzless">
  174. <term><command>bzless</command></term>
  175. <listitem>
  176. <para>Runs <command>less</command> on bzipped files</para>
  177. <indexterm zone="ch-system-bzip2 bzless">
  178. <primary sortas="b-bzless">bzless</primary>
  179. </indexterm>
  180. </listitem>
  181. </varlistentry>
  182. <varlistentry id="bzmore">
  183. <term><command>bzmore</command></term>
  184. <listitem>
  185. <para>Runs <command>more</command> on bzipped files</para>
  186. <indexterm zone="ch-system-bzip2 bzmore">
  187. <primary sortas="b-bzmore">bzmore</primary>
  188. </indexterm>
  189. </listitem>
  190. </varlistentry>
  191. <varlistentry id="libbz2">
  192. <term><filename class="libraryfile">libbz2*</filename></term>
  193. <listitem>
  194. <para>The library implementing lossless, block-sorting data
  195. compression, using the Burrows-Wheeler algorithm</para>
  196. <indexterm zone="ch-system-bzip2 libbz2">
  197. <primary sortas="c-libbz2*">libbz2*</primary>
  198. </indexterm>
  199. </listitem>
  200. </varlistentry>
  201. </variablelist>
  202. </sect2>
  203. </sect1>