Эх сурвалжийг харах

Add zstd compression package to Chapter 6

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11725 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Bruce Dubbs 5 жил өмнө
parent
commit
91c7fab61a

+ 35 - 0
appendices/dependencies.xml

@@ -2763,4 +2763,39 @@
         </seglistitem>
       </segmentedlist>
 
+<!-- Begin Zstd dependency info -->
+  <bridgehead renderas="sect2" id="zstd-dep">Zstd</bridgehead>
+
+      <segmentedlist>
+        <segtitle>&dependencies;</segtitle>
+
+        <seglistitem>
+         <seg>Binutils, Coreutils, GCC, Glibc, Gzip, Make, and Xz</seg>
+        </seglistitem>
+      </segmentedlist>
+
+      <segmentedlist>
+        <segtitle>&testsuites;</segtitle>
+
+        <seglistitem>
+          <seg>None</seg>
+        </seglistitem>
+      </segmentedlist>
+
+      <segmentedlist>
+        <segtitle>&before;</segtitle>
+
+        <seglistitem>
+          <seg>None</seg>
+        </seglistitem>
+      </segmentedlist>
+
+      <segmentedlist>
+        <segtitle>&external;</segtitle>
+
+        <seglistitem>
+          <seg>None</seg>
+        </seglistitem>
+      </segmentedlist>
+
 </appendix>

+ 9 - 0
chapter01/changelog.xml

@@ -42,6 +42,15 @@
     <listitem revision="sysv"> or <listitem revision="systemd"> as
     appropriate for the entry or if needed the entire day's listitem.
        -->
+    <listitem>
+      <para>2020-01-12</para>
+      <itemizedlist>
+        <listitem>
+          <para>[bdubbs] - Added zstd-1.4.4.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
     <listitem>
       <para>2020-01-09</para>
       <itemizedlist>

+ 1 - 1
chapter01/whatsnew.xml

@@ -270,7 +270,7 @@
 
   <itemizedlist>
     <title>Added:</title>
-    <listitem><para></para></listitem>  <!-- satisfy build -->
+    <listitem><para>Zstd-&zstd-version;</para></listitem>  <!-- satisfy build -->
 
   </itemizedlist>
 

+ 9 - 0
chapter03/packages.xml

@@ -764,6 +764,15 @@
       </listitem>
     </varlistentry>
 
+    <varlistentry>
+      <term>Zstd (&zstd-version;) - <token>&zstd-size;</token>:</term>
+      <listitem>
+        <para>Home page: <ulink url="&zstd-home;"/></para>
+        <para>Download: <ulink url="&zstd-url;"/></para>
+        <para>MD5 sum: <literal>&zstd-md5;</literal></para>
+      </listitem>
+    </varlistentry>
+
   </variablelist>
 
   <para>Total size of these packages: about <returnvalue/></para>

+ 1 - 0
chapter06/chapter06.xml

@@ -73,6 +73,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="grub.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="less.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gzip.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="zstd.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="iproute2.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="kbd.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libpipeline.xml"/>

+ 127 - 0
chapter06/zstd.xml

@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../general.ent">
+  %general-entities;
+]>
+
+<sect1 id="ch-system-zstd" role="wrap">
+  <?dbhtml filename="zstd.html"?>
+
+  <sect1info condition="script">
+    <productname>zstd</productname>
+    <productnumber>&zstd-version;</productnumber>
+    <address>&zstd-url;</address>
+  </sect1info>
+
+  <title>Zstd-&zstd-version;</title>
+
+  <indexterm zone="ch-system-zstd">
+    <primary sortas="a-zstd">zstd</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title/>
+
+    <para>Zstandard is a real-time compression algorithm, providing high
+    compression ratios. It offers a very wide range of compression / speed
+    trade-offs, while being backed by a very fast decoder.</para>
+
+    <segmentedlist>
+      <segtitle>&buildtime;</segtitle>
+      <segtitle>&diskspace;</segtitle>
+
+      <seglistitem>
+        <seg>&zstd-ch6-sbu;</seg>
+        <seg>&zstd-ch6-du;</seg>
+      </seglistitem>
+    </segmentedlist>
+
+  </sect2>
+
+  <sect2 role="installiation">
+    <title>Installation of Zstd</title>
+
+    <para>Compile the package:</para>
+
+<screen><userinput remap="make">make</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Install the package:</para>
+
+<screen><userinput remap="install">make prefix=/usr install</userinput></screen>
+
+  </sect2>
+
+  <sect2 id="contents-zstd" role="content">
+    <title>Contents of zstd</title>
+
+    <segmentedlist>
+      <segtitle>Installed programs</segtitle>
+      <segtitle>Installed library</segtitle>
+
+      <seglistitem>
+        <seg>zstd, 
+             zstdcat (link to zstd), 
+             zstdgrep, 
+             zstdless, 
+             zstdmt (link to zstd), and
+             unzstd (link to zstd)
+        </seg>
+
+        <seg>libzstd.so</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="zstd">
+        <term><command>zstd</command></term>
+        <listitem>
+          <para>Compresses or decompresses files using the ZSTD format</para>
+          <indexterm zone="ch-system-zstd zstd">
+            <primary sortas="b-zstd">zstd</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="zstdgrep">
+        <term><command>zstdgrep</command></term>
+        <listitem>
+          <para>Runs <command>egrep</command> on ZSTD compressed files</para>
+          <indexterm zone="ch-system-zstd zstdgrep">
+            <primary sortas="b-zstdgrep">zstdgrep</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="zstdless">
+        <term><command>zstdless</command></term>
+        <listitem>
+          <para>Runs <command>less</command> on ZSTD compressed files</para>
+          <indexterm zone="ch-system-zstd zstdless">
+            <primary sortas="b-zstdless">zstdless</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="libzstd">
+        <term><filename class="libraryfile">libzstd</filename></term>
+        <listitem>
+          <para>The library implementing lossless data
+          compression, using the ZSTD algorithm</para>
+          <indexterm zone="ch-system-zstd libzstd">
+            <primary sortas="c-libzstd">libzstd</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>

+ 3 - 3
general.ent

@@ -1,13 +1,13 @@
-<!ENTITY version         "SVN-20200109">
+<!ENTITY version         "SVN-20200112">
 <!ENTITY short-version   "svn">  <!-- Used below in &blfs-book; 
                                       Change to x.y for release but not -rc releases -->
 <!ENTITY generic-version "development"> <!-- Use "development"  or "x.y[-pre{x}]" -->
 
-<!ENTITY versiond        "20200109-systemd">
+<!ENTITY versiond        "20200112-systemd">
 <!ENTITY short-versiond  "systemd">
 <!ENTITY generic-versiond "systemd"> 
 
-<!ENTITY releasedate     "January 9th, 2020">
+<!ENTITY releasedate     "January 12th, 2020">
 
 <!ENTITY copyrightdate   "1999-2020"><!-- jhalfs needs a literal dash, not &ndash; -->
 <!ENTITY milestone       "9.0">

+ 8 - 0
packages.ent

@@ -734,3 +734,11 @@
 <!ENTITY zlib-ch6-du "5.1 MB">
 <!ENTITY zlib-ch6-sbu "less than 0.1 SBU">
 
+<!ENTITY zstd-version "1.4.4">
+<!ENTITY zstd-size "1,903 KB">
+<!ENTITY zstd-url "https://github.com/facebook/zstd/releases/download/v&zstd-version;/zstd-&zstd-version;.tar.gz">
+<!ENTITY zstd-md5 "487f7ee1562dee7c1c8adf85e2a63df9">
+<!ENTITY zstd-home "https://facebook.github.io/zstd/">
+<!ENTITY zstd-ch6-du "17 MB">
+<!ENTITY zstd-ch6-sbu "0.5 SBU">
+

+ 8 - 0
prologue/why.xml

@@ -608,6 +608,14 @@
         used by some programs.</para>
       </listitem>
 
+      <listitem>
+        <para>Zstd</para>
+
+        <para>This package contains compression and decompression routines
+        used by some programs. It provide high compression ratios and a very 
+        wide range of compression / speed trade-offs.</para>
+      </listitem>
+
     </itemizedlist>
 
 </sect1>