commands: update help for "bundle"
We now have a dedicated help topic to describe bundle specification
strings. Let's update `hg bundle`'s documentation to reflect its
existence.
While I was hear, I also tweaked some wording which I felt was out
of date and needed tweaking. Specifically, `hg bundle` no longer
just deals with "changegroup" data: it can also generate files
that have non-changegroup data.
--- a/mercurial/commands.py Sat Apr 01 13:42:06 2017 -0700
+++ b/mercurial/commands.py Sat Apr 01 13:43:43 2017 -0700
@@ -1281,12 +1281,11 @@
('a', 'all', None, _('bundle all changesets in the repository')),
('t', 'type', 'bzip2', _('bundle compression type to use'), _('TYPE')),
] + remoteopts,
- _('[-f] [-t TYPE] [-a] [-r REV]... [--base REV]... FILE [DEST]'))
+ _('[-f] [-t BUNDLESPEC] [-a] [-r REV]... [--base REV]... FILE [DEST]'))
def bundle(ui, repo, fname, dest=None, **opts):
- """create a changegroup file
-
- Generate a changegroup file collecting changesets to be added
- to a repository.
+ """create a bundle file
+
+ Generate a bundle file containing data 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
@@ -1294,11 +1293,10 @@
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
- (comp-version). The available compression methods are: none, bzip2,
- and gzip (by default, bundles are compressed using bzip2). The
- available formats are: v1, v2 (default to most suitable).
+ You can change bundle format with the -t/--type option. See
+ :hg:`help bundlespec` for documentation on this format. By default,
+ the most appropriate format is used and compression defaults to
+ bzip2.
The bundle file can then be transferred using conventional means
and applied to another repository with the unbundle or pull
@@ -1323,7 +1321,7 @@
repo, bundletype, strict=False)
except error.UnsupportedBundleSpecification as e:
raise error.Abort(str(e),
- hint=_("see 'hg help bundle' for supported "
+ hint=_("see 'hg help bundlespec' for supported "
"values for --type"))
# Packed bundles are a pseudo bundle format for now.
--- a/tests/test-bundle-type.t Sat Apr 01 13:42:06 2017 -0700
+++ b/tests/test-bundle-type.t Sat Apr 01 13:43:43 2017 -0700
@@ -40,12 +40,12 @@
$ hg -q pull ../b1
$ hg bundle -a -t unknown out.hg
abort: unknown is not a recognized bundle specification
- (see 'hg help bundle' for supported values for --type)
+ (see 'hg help bundlespec' for supported values for --type)
[255]
$ hg bundle -a -t unknown-v2 out.hg
abort: unknown compression is not supported
- (see 'hg help bundle' for supported values for --type)
+ (see 'hg help bundlespec' for supported values for --type)
[255]
$ cd ..
@@ -193,7 +193,7 @@
$ hg -R tzstd bundle -a -t zstd-v1 zstd-v1
abort: compression engine zstd is not supported on v1 bundles
- (see 'hg help bundle' for supported values for --type)
+ (see 'hg help bundlespec' for supported values for --type)
[255]
#else
@@ -222,6 +222,6 @@
$ cd t1
$ hg bundle -a -t garbage ../bgarbage
abort: garbage is not a recognized bundle specification
- (see 'hg help bundle' for supported values for --type)
+ (see 'hg help bundlespec' for supported values for --type)
[255]
$ cd ..
--- a/tests/test-globalopts.t Sat Apr 01 13:42:06 2017 -0700
+++ b/tests/test-globalopts.t Sat Apr 01 13:43:43 2017 -0700
@@ -296,7 +296,7 @@
bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name
branches list repository named branches
- bundle create a changegroup file
+ bundle create a bundle file
cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
@@ -380,7 +380,7 @@
bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name
branches list repository named branches
- bundle create a changegroup file
+ bundle create a bundle file
cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
--- a/tests/test-help.t Sat Apr 01 13:42:06 2017 -0700
+++ b/tests/test-help.t Sat Apr 01 13:43:43 2017 -0700
@@ -58,7 +58,7 @@
bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name
branches list repository named branches
- bundle create a changegroup file
+ bundle create a bundle file
cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
@@ -136,7 +136,7 @@
bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name
branches list repository named branches
- bundle create a changegroup file
+ bundle create a bundle file
cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
@@ -781,7 +781,7 @@
bookmarks create a new bookmark or list existing bookmarks
branch set or show the current branch name
branches list repository named branches
- bundle create a changegroup file
+ bundle create a bundle file
cat output the current or given revision of files
clone make a copy of an existing repository
commit commit the specified files or all outstanding changes
@@ -2246,7 +2246,7 @@
bundle
</a>
</td><td>
- create a changegroup file
+ create a bundle file
</td></tr>
<tr><td>
<a href="/help/cat">
--- a/tests/test-hgweb-json.t Sat Apr 01 13:42:06 2017 -0700
+++ b/tests/test-hgweb-json.t Sat Apr 01 13:43:43 2017 -0700
@@ -1443,7 +1443,7 @@
"topic": "branches"
},
{
- "summary": "create a changegroup file",
+ "summary": "create a bundle file",
"topic": "bundle"
},
{