From 9865509105fe6a2528e3f54873e414d20138abf6 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Sat, 30 Jul 2016 21:21:45 +0200 Subject: [PATCH] docs: remove borg list example, be more specific about compression heuristics --- docs/usage.rst | 11 ----------- src/borg/archiver.py | 3 ++- 2 files changed, 2 insertions(+), 12 deletions(-) diff --git a/docs/usage.rst b/docs/usage.rst index 354b950cf..efc5c4197 100644 --- a/docs/usage.rst +++ b/docs/usage.rst @@ -367,17 +367,6 @@ Examples -rw-rw-r-- user user 1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.ext ... - # see what is changed between archives, based on file modification time, size and file path - $ borg list /path/to/repo::archiveA --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list.archiveA - $ borg list /path/to/repo::archiveB --list-format="{mtime:%s}{TAB}{size}{TAB}{path}{LF}" |sort -n > /tmp/list.archiveB - $ diff -y /tmp/list.archiveA /tmp/list.archiveB - 1422781200 0 . 1422781200 0 . - 1422781200 0 code 1422781200 0 code - 1422781200 0 code/myproject 1422781200 0 code/myproject - 1422781200 1416192 code/myproject/file.ext | 1454664653 1416192 code/myproject/file.ext - ... - - .. include:: usage/diff.rst.inc diff --git a/src/borg/archiver.py b/src/borg/archiver.py index aab9ff58e..91b37cbef 100644 --- a/src/borg/archiver.py +++ b/src/borg/archiver.py @@ -1541,7 +1541,8 @@ class Archiver: type=CompressionSpec, default=dict(name='none'), metavar='COMPRESSION', help='select compression algorithm (and level):\n' 'none == no compression (default),\n' - 'auto,C[,L] == built-in heuristic decides between none or C[,L] - with C[,L]\n' + 'auto,C[,L] == built-in heuristic (try with lz4 whether the data is\n' + ' compressible) decides between none or C[,L] - with C[,L]\n' ' being any valid compression algorithm (and optional level),\n' 'lz4 == lz4,\n' 'zlib == zlib (default level 6),\n'