hg-bundle - Man Page

create a bundle file

Synopsis

hg bundle [-f] [-t BUNDLESPEC] [-a] [-r REV]... [--base REV]... FILE [DEST]...

Description

Generate a bundle file containing data to be transferred to another 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, where destination is the repositories you provide through DEST option.

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 command. This is useful when direct push and pull are not available or when exporting an entire repository is undesirable.

Applying bundles preserves all changeset contents including permissions, copy/rename information, and revision history.

Returns 0 on success, 1 if no changes found.

Options

--exact

compute the base from the revision specified

-f,  --force

run even when the destination is unrelated

-r,--rev <REV[+]>

a changeset intended to be added to the destination

-b,--branch <BRANCH[+]>

a specific branch you would like to bundle

--base <REV[+]>

a base changeset assumed to be available at the destination

-a,  --all

bundle all changesets in the repository

-t,--type <TYPE>

bundle compression type to use (default: bzip2)

-e,--ssh <CMD>

specify ssh command to use

--remotecmd <CMD>

specify hg command to run on the remote side

--insecure

do not verify server certificate (ignoring web.cacerts config)

[+] marked option can be specified multiple times