From c88528512f146a5e9a144c4f35b940d8d45041a1 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Thu, 21 Sep 2017 04:26:52 +0200 Subject: [PATCH 1/3] fix docs: --compression lz4 is the default now, fixes #3034 --- docs/usage/create.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/usage/create.rst b/docs/usage/create.rst index 8e4a2e036..4586b30f5 100644 --- a/docs/usage/create.rst +++ b/docs/usage/create.rst @@ -41,11 +41,11 @@ Examples # Backup a raw device (must not be active/in use/mounted at that time) $ dd if=/dev/sdx bs=10M | borg create /path/to/repo::my-sdx - - # No compression (default) - $ borg create /path/to/repo::arch ~ + # No compression + $ borg create --compression none /path/to/repo::arch ~ - # Super fast, low compression - $ borg create --compression lz4 /path/to/repo::arch ~ + # Super fast, low compression (default) + $ borg create /path/to/repo::arch ~ # Less fast, higher compression (N = 0..9) $ borg create --compression zlib,N /path/to/repo::arch ~ From 0ec6c920b9e70a8bcbc6340be9b867d833fb912a Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Thu, 21 Sep 2017 04:28:35 +0200 Subject: [PATCH 2/3] docs: add compressor names to be more clear --- docs/usage/create.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/usage/create.rst b/docs/usage/create.rst index 4586b30f5..6f707c985 100644 --- a/docs/usage/create.rst +++ b/docs/usage/create.rst @@ -41,16 +41,16 @@ Examples # Backup a raw device (must not be active/in use/mounted at that time) $ dd if=/dev/sdx bs=10M | borg create /path/to/repo::my-sdx - - # No compression + # No compression (none) $ borg create --compression none /path/to/repo::arch ~ - # Super fast, low compression (default) + # Super fast, low compression (lz4, default) $ borg create /path/to/repo::arch ~ - # Less fast, higher compression (N = 0..9) + # Less fast, higher compression (zlib, N = 0..9) $ borg create --compression zlib,N /path/to/repo::arch ~ - # Even slower, even higher compression (N = 0..9) + # Even slower, even higher compression (lzma, N = 0..9) $ borg create --compression lzma,N /path/to/repo::arch ~ # Use short hostname, user name and current time in archive name From 3f16d91fd3ff4f83d46978ce858750f1091f45fa Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Thu, 21 Sep 2017 14:00:50 +0200 Subject: [PATCH 3/3] docs: add auto compression example to borg create examples --- docs/usage/create.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/usage/create.rst b/docs/usage/create.rst index 6f707c985..ec49f5fa8 100644 --- a/docs/usage/create.rst +++ b/docs/usage/create.rst @@ -53,6 +53,9 @@ Examples # Even slower, even higher compression (lzma, N = 0..9) $ borg create --compression lzma,N /path/to/repo::arch ~ + # Only compress compressible data with lzma,N (N = 0..9) + $ borg create --compression auto,lzma,N /path/to/repo::arch ~ + # Use short hostname, user name and current time in archive name $ borg create /path/to/repo::{hostname}-{user}-{now} ~ # Similar, use the same datetime format as borg 1.1 will have as default