[automerger skipped] DO NOT MERGE - Merge pi-dev@5234907 into stage-aosp-master
am: 170cb8d77f -s ours
am skip reason: subject contains skip directive

Change-Id: I40c3785dc05a51760b1fbe8557300029836c3306
tree: 40285823a35f14791bfe177f751433b7d6f1961e
  1. .clang-format
  2. Android.bp
  3. BUILD.gn
  4. LICENSE
  5. Makefile
  6. OWNERS
  7. PRESUBMIT.cfg
  8. PREUPLOAD.cfg
  9. README.md
  10. README.version
  11. libpuffdiff.pc
  12. libpuffpatch.pc
  13. scripts/
  14. src/
README.md

Puffin

Source code for Puffin: A utility for deterministic DEFLATE recompression.

TODO(ahassani): Describe the directory structure and how-tos.

Glossary

  • Alphabet A value that occurs in the input stream. It can be either a literal:[0..255], and end of block sign [256], a length[257..285], or a distance [0..29].

  • Huffman code A variable length code representing the Huffman encoded of an alphabet. Huffman codes can be created uniquely using Huffman code length array.

  • Huffman code array An array which an array index identifies a Huffman code and the array element in that index represents the corresponding alphabet. Throughout the code, Huffman code arrays are identified by vectors with postfix hcodes_.

  • Huffman reverse code array An array which an array index identifies an alphabet and the array element in that index contains the Huffman code of the alphabet. Throughout the code, The Huffman reverse code arrays are identified by vectors with postfix rcodes_.

  • Huffman code length The number of bits in a Huffman code.

  • Huffman code length array An array of Huffman code lengths with the array index as the alphabet. Throughout the code, Huffman code length arrays are identified by vectors with postfix lens_.