]> arthur.barton.de Git - bup.git/blobdiff - Documentation/bup-split.md
Wrap readline oursleves to avoid py3's interference
[bup.git] / Documentation / bup-split.md
index 22d63cbc12a6571aa2ac09a11ddaf54fefb40b9e..73b418d8df95b525e7d47dc9228f7925c026fec3 100644 (file)
@@ -12,13 +12,15 @@ bup split \[-t\] \[-c\] \[-n *name*\] COMMON\_OPTIONS
 
 bup split -b COMMON\_OPTIONS
 
-bup split \<--noop \[--copy\]|--copy\> COMMON\_OPTIONS
+bup split --copy COMMON\_OPTIONS
+
+bup split --noop \[-t|-b\] COMMON\_OPTIONS
 
 COMMON\_OPTIONS
   ~ \[-r *host*:*path*\] \[-v\] \[-q\] \[-d *seconds-since-epoch*\] \[\--bench\]
     \[\--max-pack-size=*bytes*\] \[-#\] \[\--bwlimit=*bytes*\]
     \[\--max-pack-objects=*n*\] \[\--fanout=*count*\]
-    \[\--keep-boundaries\] \[--git-ids | filenames...\]
+    \[\--keep-boundaries\] \[\--git-ids | filenames...\]
 
 # DESCRIPTION
 
@@ -76,9 +78,11 @@ being the most likely choice.
 
 \--noop
 :   read the data and split it into blocks based on the "bupsplit"
-    rolling checksum algorithm, but don't do anything with the blocks.
-    This is mostly useful for benchmarking.  Incompatible with -n, -t,
-    -c, and -b.
+    rolling checksum algorithm, but don't store anything in the repo.
+    Can be combined with -b or -t to compute (but not store) the git
+    blobs or tree ids for the dataset. This is mostly useful for
+    benchmarking and validating the bupsplit algorithm. Incompatible
+    with -n and -c.
 
 \--copy
 :   like `--noop`, but also write the data to stdout.  This can be
@@ -148,7 +152,7 @@ being the most likely choice.
     to the server.  This is good for making your backups
     not suck up all your network bandwidth.  Use a suffix
     like k, M, or G to specify multiples of 1024,
-    1024*1024, 1024*1024*1024 respectively.
+    1024\*1024, 1024\*1024\*1024 respectively.
 
 -*#*, \--compress=*#*
 :   set the compression level to # (a value from 0-9, where