Update the docs

CHANGELOG.md

@@ -9,6 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 * Add support for Python 3.9
 
+### Changed
+* Update `b2 sync` usage text for bucket-to-bucket sync
+
 ### Removed
 * Drop Python 2 support :tada: (for old systems you can now use the [binary distribution](https://www.backblaze.com/b2/docs/quick_command_line.html))
 * Remove `--prefix` from `ls` (it didn't really work, use `folderName` argument)

b2/console_tool.py

@@ -517,11 +517,11 @@ class CreateKey(Command):
 
     The capabilities are passed in as a comma-separated list, like "readFiles,writeFiles".
 
-    The 'validDurationSeconds' is the length of time the new application key will exist.
+    The 'duration' is the length of time the new application key will exist.
     When the time expires the key will disappear and will no longer be usable.  If not
     specified, the key will not expire.
 
-    The 'bucketName' is the name of a bucket in the account.  When specified, the key
+    The 'bucket' is the name of a bucket in the account.  When specified, the key
     will only allow access to that bucket.
 
     The 'namePrefix' restricts file access to files whose names start with the prefix.
@@ -899,13 +899,14 @@ class ListKeys(Command):
     Lists the application keys for the current account.
 
     The columns in the output are:
-        - ID of the application key
-        - Name of the application key
-        - Name of the bucket the key is restricted to, or '-' for no restriction
-        - Date of expiration, or '-'
-        - Time of expiration, or '-'
-        - File name prefix, in single quotes
-        - Command-separated list of capabilities
+
+    - ID of the application key
+    - Name of the application key
+    - Name of the bucket the key is restricted to, or '-' for no restriction
+    - Date of expiration, or '-'
+    - Time of expiration, or '-'
+    - File name prefix, in single quotes
+    - Command-separated list of capabilities
 
     None of the values contain whitespace.
 
@@ -1135,6 +1136,16 @@ class Sync(Command):
     Copies multiple files from source to destination.  Optionally
     deletes or hides destination files that the source does not have.
 
+    The synchronizer can copy files:
+
+    - From a B2 bucket to a local destination.
+    - From a local source to a B2 bucket.
+    - From one B2 bucket to another.
+    - Between different folders in the same B2 bucket.
+      It will sync only the latest versions of files.
+
+    Use "b2://<bucketName>/<prefix>" for B2 paths, e.g. "b2://my-bucket-name/a/path/prefix/".
+
     Progress is displayed on the console unless '--noProgress' is
     specified.  A list of actions taken is always printed.
 
@@ -1216,10 +1227,6 @@ class Sync(Command):
     not be synced. Specifying --verbose and --dryRun can be useful to
     determine comparison value differences.
 
-    One of the paths must be a local file path, and the other must be
-    a B2 bucket path. Use "b2://<bucketName>/<prefix>" for B2 paths, e.g.
-    "b2://my-bucket-name/a/path/prefix/".
-
     When a destination file is present that is not in the source, the
     default is to leave it there.  Specifying --delete means to delete
     destination files that are not in the source.
@@ -1238,6 +1245,8 @@ class Sync(Command):
 
     To make the destination exactly match the source, use:
     {NAME} sync --delete --replaceNewer ... ...
+    NOTE: It might not be exact match if the source contains hidden files.
+    If the source file is hidden, the file on the destination won't be deleted even with --delete.
 
     WARNING: Using '--delete' deletes files!  We recommend not using it.
     If you use --keepDays instead, you will have some time to recover your