upstream/borgbackup
1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2026-03-29 05:44:17 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

fix "--recompress option is counter intuitive", fixes #5154 (#5155)

Browse source 
docs: clarify --recompress option, fixes #5154
This commit is contained in:
RR 2020-04-27 21:08:47 +02:00 committed by GitHub
parent fae0b9b1ee
commit 0e76dff33e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
src/borg/archiver.py
View file

@ -4104,15 +4104,16 @@ class Archiver:
'"borg help compression" command for details.')
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.')
help='recompress data chunks according to `MODE` and ``--compression``. '
'Possible modes are '
'`if-different`: recompress if current compression is with a different '
'compression algorithm (the level is not considered); '
'`always`: recompress even if current compression is with the same '
'compression algorithm (use this to change the compression level); and '
'`never`: do not recompress (use this option to explicitly prevent '
'recompression). '
'If no MODE is given, `if-different` will be used. '
'Not passing --recompress is equivalent to "--recompress never".')
archive_group.add_argument('--chunker-params', metavar='PARAMS', dest='chunker_params',
type=ChunkerParams, default=CHUNKER_PARAMS,
help='specify the chunker parameters (ALGO, CHUNK_MIN_EXP, CHUNK_MAX_EXP, '