From 337c86b470d7c00e6c11abdd3e329cdc42525ec0 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Fri, 9 Mar 2018 18:33:15 +0100 Subject: [PATCH] recreate --recompress: add metavar, clarify description (cherry picked from commit c0f56ed0392e81b469832c95ed77c0ea584f37c3) --- src/borg/archiver.py | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/src/borg/archiver.py b/src/borg/archiver.py index 4cca8485e..d84f52a8c 100644 --- a/src/borg/archiver.py +++ b/src/borg/archiver.py @@ -3757,12 +3757,17 @@ class Archiver: type=CompressionSpec, default=CompressionSpec('lz4'), help='select compression algorithm, see the output of the ' '"borg help compression" command for details.') - archive_group.add_argument('--recompress', dest='recompress', nargs='?', default='never', const='if-different', - choices=('never', 'if-different', 'always'), - help='recompress data chunks according to ``--compression`` if `if-different`. ' - 'When `always`, chunks that are already compressed that way are not skipped, ' - 'but compressed again. Only the algorithm is considered for `if-different`, ' - 'not the compression level (if any).') + archive_group.add_argument('--recompress', metavar='MODE', dest='recompress', nargs='?', + default='never', const='if-different', choices=('never', 'if-different', 'always'), + help='recompress data chunks according to ``--compression``. ' + 'MODE `if-different`: ' + 'recompress if current compression is with a different compression algorithm ' + '(the level is not considered). ' + 'MODE `always`: ' + 'recompress even if current compression is with the same compression algorithm ' + '(use this to change the compression level). ' + 'MODE `never` (default): ' + 'do not recompress.') archive_group.add_argument('--chunker-params', metavar='PARAMS', dest='chunker_params', type=ChunkerParams, default=CHUNKER_PARAMS, help='specify the chunker parameters (CHUNK_MIN_EXP, CHUNK_MAX_EXP, '