Patchwork [1,of,4] bundle: clarify help text

login
register
mail settings
Submitter timeless@mozdev.org
Date Dec. 17, 2015, 3:13 p.m.
Message ID <5e0718f63440457ddb31.1450365215@waste.org>
Download mbox | patch
Permalink /patch/12101/
State Accepted
Headers show

Comments

timeless@mozdev.org - Dec. 17, 2015, 3:13 p.m.
# HG changeset patch
# User timeless <timeless@mozdev.org>
# Date 1450364332 0
#      Thu Dec 17 14:58:52 2015 +0000
# Node ID 5e0718f63440457ddb3189f50f3feaaaae297622
# Parent  4eeef1b2d689bad18f473b5e118cca061f6ca560
bundle: clarify help text

The file might not be compressed; the interactions between
-a, --base, and a named or default repository weren't clear.

Patch

diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -1300,13 +1300,14 @@ 
 def bundle(ui, repo, fname, dest=None, **opts):
     """create a changegroup file
 
-    Generate a compressed changegroup file collecting changesets not
-    known to be in another repository.
-
-    If you omit the destination repository, then hg assumes the
-    destination will have all the nodes you specify with --base
-    parameters. To create a bundle containing all changesets, use
-    -a/--all (or --base null).
+    Generate a changegroup file collecting changesets to be added
+    to a repository.
+
+    To create a bundle containing all changesets, use -a/--all
+    (or --base null). Otherwise, hg assumes the destination will have
+    all the nodes you specify with --base parameters. Otherwise, hg
+    will assume the repository has all the nodes in destination, or
+    default-push/default if no destination is specified.
 
     You can change bundle format with the -t/--type option. You can
     specify a compression, a bundle version or both using a dash