opnsense-src/sys/contrib/zstd/doc/README.md

26 lines
1.3 KiB
Markdown
Raw Normal View History

2017-04-15 15:47:16 -04:00
Zstandard Documentation
=======================
This directory contains material defining the Zstandard format,
2018-10-22 15:50:43 -04:00
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](http://zstd.net/zstd_manual.html)
to display documentation of latest release in readable format within a browser.
2017-04-15 15:47:16 -04:00
__`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.
2019-04-18 20:31:04 -04:00
Should you look for resources to develop your own port of Zstandard algorithm,
you may find the following resources useful :
2018-10-22 15:50:43 -04:00
2017-04-15 15:47:16 -04:00
__`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,
2018-10-22 15:50:43 -04:00
or as the basis for a separate implementation of Zstandard decoder.
2017-04-15 15:47:16 -04:00
2018-10-22 15:50:43 -04:00
[__`decode_corpus`__](https://github.com/facebook/zstd/tree/dev/tests#decodecorpus---tool-to-generate-zstandard-frames-for-decoder-testing) :
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.