freebsd-skq/sys/contrib/zstd/doc
Conrad Meyer 19fcbaf142 Update to Zstandard 1.3.4
Includes our local patch to conditionalize use of __builtin_clz(ll) on
Clang's __has_builtin() (which is just defined to false when building with
GCC).

The issue is tracked upstream at https://github.com/facebook/zstd/pull/884 .
Otherwise, these are vanilla Zstandard 1.3.4 files.

Reported by:	allanjude, Yann Collet
Sponsored by:	Dell EMC Isilon
2018-03-26 23:54:59 +00:00
..
educational_decoder
images Update to Zstandard 1.3.4 2018-03-26 23:54:59 +00:00
README.md Update to Zstandard 1.3.4 2018-03-26 23:54:59 +00:00
zstd_compression_format.md Update to Zstandard 1.3.4 2018-03-26 23:54:59 +00:00
zstd_manual.html Update to Zstandard 1.3.4 2018-03-26 23:54:59 +00:00

Zstandard Documentation

This directory contains material defining the Zstandard format, as well as detailed instructions to use zstd library.

zstd_manual.html : Documentation of zstd.h API, in html format. Click on this link: http://zstd.net/zstd_manual.html to display documentation of latest release in readable format within a browser.

zstd_compression_format.md : This document defines the Zstandard compression format. Compliant decoders must adhere to this document, and compliant encoders must generate data that follows it.

Should you look for ressources to develop your own port of Zstandard algorithm, you may find the following ressources useful :

educational_decoder : This directory contains an implementation of a Zstandard decoder, compliant with the Zstandard compression format. It can be used, for example, to better understand the format, or as the basis for a separate implementation of Zstandard decoder.

decode_corpus : This tool, stored in /tests directory, is able to generate random valid frames, which is useful if you wish to test your decoder and verify it fully supports the specification.