updated programs\README.md
authorPrzemyslaw Skibinski <inikep@gmail.com>
Wed, 16 Nov 2016 09:53:06 +0000 (10:53 +0100)
committerPrzemyslaw Skibinski <inikep@gmail.com>
Wed, 16 Nov 2016 09:53:06 +0000 (10:53 +0100)
appveyor.yml
lib/dll/example/README.md
programs/README.md

index d1245c8..2885e30 100644 (file)
@@ -102,7 +102,7 @@ test_script:
   - ECHO *** &&
       ECHO Testing %COMPILER% %PLATFORM% %CONFIGURATION% &&
       ECHO ***
-  - if [%COMPILER%]==[unknown] (
+  - if not [%COMPILER%]==[unknown] (
       CD programs &&
       lz4 -h &&
       lz4 -i1b lz4.exe &&
@@ -120,7 +120,6 @@ artifacts:
 deploy:
 - provider: GitHub
   artifact: bin\lz4_x64.zip
-  release: lz4_x64-v$(appveyor_build_version)
   auth_token:
     secure: w6UJaGie0qbZvffr/fqyhO/Vj8rMiQWnv9a8qm3gxfngdHDTMT42wYupqJpIExId
   force_update: true
@@ -128,11 +127,10 @@ deploy:
   on:
     COMPILER: gcc
     PLATFORM: "mingw64"
-    #appveyor_repo_tag: true
+    appveyor_repo_tag: true
 
 - provider: GitHub
   artifact: bin\lz4_x86.zip
-  release: lz4_x86-v$(appveyor_build_version)
   auth_token:
     secure: w6UJaGie0qbZvffr/fqyhO/Vj8rMiQWnv9a8qm3gxfngdHDTMT42wYupqJpIExId
   force_update: true
@@ -140,4 +138,4 @@ deploy:
   on:
     COMPILER: gcc
     PLATFORM: "mingw32"
-    #appveyor_repo_tag: true
+    appveyor_repo_tag: true
index 6f2b402..216c1e9 100644 (file)
@@ -11,6 +11,19 @@ The static and dynamic LZ4 libraries
 - `static\liblz4_static.lib` : The static LZ4 library
 
 
+#### Usage of Command Line Interface
+
+Command Line Interface (CLI) supports gzip-like arguments.
+By default CLI takes an input file and compresses it to an output file:
+```
+Usage: lz4 [arg] [input] [output]
+```
+The full list of commands for CLI can be obtained with `-h` or `-H`.
+The ratio can be improved with commands from `-3` to `-16` but higher levels also have slower compression. 
+CLI supports aggregation of parameters i.e. `-b1`, `-e18`, and `-i1` can be joined into `-b1e18i1`.
+CLI includes in-memory compression benchmark module with compression levels starting from `-b` and ending with `-e` with iteration time of `-i` seconds.
+
+
 #### The example of usage of static and dynamic LZ4 libraries with gcc/MinGW
 
 Use `cd example` and `make` to build `fullbench-dll` and `fullbench-lib`.
index b67408f..2ad0449 100644 (file)
@@ -21,7 +21,7 @@ It makes benchmark more precise as it eliminates I/O overhead.
 
 The benchmark measures ratio, compressed size, compression and decompression speed.
 One can select compression levels starting from `-b` and ending with `-e`.
-The `-i` parameter selects a number of iterations used for each of tested levels.
+The `-i` parameter selects a number of seconds used for each of tested levels.
 
 
 
@@ -39,6 +39,7 @@ Arguments :
  -d     : decompression (default for .lz4 extension)
  -z     : force compression
  -f     : overwrite output without prompting
+--rm    : remove source file(s) after successful de/compression
  -h/-H  : display help/long help and exit
 
 Advanced arguments :
@@ -48,18 +49,20 @@ Advanced arguments :
  -c     : force write to standard output, even if it is the console
  -t     : test compressed file integrity
  -m     : multiple input files (implies automatic output filenames)
+ -r     : operate recursively on directories (sets also -m)
  -l     : compress using Legacy format (Linux kernel compression)
- -B#    : Block size [4-7](default : 7)
+ -B#    : Block size [4-7] (default : 7)
  -BD    : Block dependency (improve compression ratio)
 --no-frame-crc : disable stream checksum (default:enabled)
 --content-size : compressed frame includes original size (default:not present)
 --[no-]sparse  : sparse mode (default:enabled on file, disabled on stdout)
 Benchmark arguments :
-Benchmark arguments :
  -b#    : benchmark file(s), using # compression level (default : 1)
- -e#    : test all compression levels from -bX to # (default: 1)
- -i#    : iteration loops [1-9](default : 3), benchmark mode only
- ```
+ -e#    : test all compression levels from -bX to # (default : 1)
+ -i#    : minimum evaluation time in seconds (default : 3s)
+ -B#    : cut file into independent blocks of size # bytes [32+]
+                      or predefined block size [4-7] (default: 7)
+```
 
 #### License