summaryrefslogtreecommitdiffstats
path: root/programs
diff options
context:
space:
mode:
authorYann Collet <cyan@fb.com>2019-04-12 18:27:44 (GMT)
committerYann Collet <cyan@fb.com>2019-04-12 18:27:44 (GMT)
commit21ff1a839afcf18e68ee7dbb0ec0d6cccb4c1be0 (patch)
tree4318e6bcebc94455ed166cea1b096b7d9bc93fdb /programs
parent780aac520b69d6369f4e3995624c37e56d75498d (diff)
downloadlz4-21ff1a839afcf18e68ee7dbb0ec0d6cccb4c1be0.zip
lz4-21ff1a839afcf18e68ee7dbb0ec0d6cccb4c1be0.tar.gz
lz4-21ff1a839afcf18e68ee7dbb0ec0d6cccb4c1be0.tar.bz2
updated doc to underline difference between block and frame
as this is a very frequent source of confusion for new users.
Diffstat (limited to 'programs')
-rw-r--r--programs/README.md14
1 files changed, 11 insertions, 3 deletions
diff --git a/programs/README.md b/programs/README.md
index 23c944b..c1995af 100644
--- a/programs/README.md
+++ b/programs/README.md
@@ -1,18 +1,26 @@
Command Line Interface for LZ4 library
============================================
-Command Line Interface (CLI) can be created using the `make` command without any additional parameters.
-There are also multiple targets that create different variations of CLI:
+### Build
+The Command Line Interface (CLI) can be generated
+using the `make` command without any additional parameters.
+
+The `Makefile` script supports all [standard conventions](https://www.gnu.org/prep/standards/html_node/Makefile-Conventions.html),
+including standard targets (`all`, `install`, `clean`, etc.)
+and standard variables (`CC`, `CFLAGS`, `CPPFLAGS`, etc.).
+
+For advanced use cases, there are targets to different variations of the CLI:
- `lz4` : default CLI, with a command line syntax close to gzip
- `lz4c` : Same as `lz4` with additional support legacy lz4 commands (incompatible with gzip)
- `lz4c32` : Same as `lz4c`, but forced to compile in 32-bits mode
+The CLI generates and decodes [LZ4-compressed frames](../doc/lz4_Frame_format.md).
+
#### Aggregation of parameters
CLI supports aggregation of parameters i.e. `-b1`, `-e18`, and `-i1` can be joined into `-b1e18i1`.
-
#### Benchmark in Command Line Interface
CLI includes in-memory compression benchmark module for lz4.
The benchmark is conducted using a given filename.