table of contents
other versions
- wheezy 2.6.0~bzr6526-1
- jessie 2.6.0+bzr6595-6
- testing 2.7.0+bzr6619-7
- unstable 2.7.0+bzr6619-7
- experimental 2.7.0+bzr6622-1
bzr(1) | Bazaar | bzr(1) |
NAME¶
bzr - Bazaar next-generation distributed version controlSYNOPSIS¶
bzr command [ command_options ]DESCRIPTION¶
Bazaar (or bzr) is a distributed version control system that is powerful, friendly, and scalable. Bazaar is a project of Canonical Ltd and part of the GNU Project to develop a free operating system.COMMAND OVERVIEW¶
- bzr add [FILE...]
- Add specified files or directories.
- bzr alias [NAME]
- Set/unset and display aliases.
- bzr annotate FILENAME
- Show the origin of each line in a file.
- bzr bind [LOCATION]
- Convert the current branch into a checkout of the supplied branch.
- bzr branch FROM_LOCATION [TO_LOCATION]
- Create a new branch that is a copy of an existing branch.
- bzr branches [LOCATION]
- List the branches available at the current location.
- bzr break-lock [LOCATION]
- Break a dead lock.
- bzr cat FILENAME
- Write the contents of a file as of a given revision to standard output.
- bzr check [PATH]
- Validate working tree structure, branch consistency and repository history.
- bzr checkout [BRANCH_LOCATION] [TO_LOCATION]
- Create a new checkout of an existing branch.
- bzr clean-tree
- Remove unwanted files from working tree.
- bzr commit [SELECTED...]
- Commit changes into a new revision.
- bzr config [NAME]
- Display, set or remove a configuration option.
- bzr conflicts
- List files with conflicts.
- bzr deleted
- List files deleted in the working tree.
- bzr diff [FILE...]
- Show differences in the working tree, between revisions or branches.
- bzr dpush [LOCATION]
- Push into a different VCS without any custom bzr metadata.
- bzr export DEST [BRANCH_OR_SUBDIR]
- Export current or past revision to a destination directory or archive.
- bzr help [TOPIC]
- Show help on a command or other topic.
- bzr ignore [NAME_PATTERN...]
- Ignore specified files or patterns.
- bzr ignored
- List ignored files and the patterns that matched them.
- bzr info [LOCATION]
- Show information about a working tree, branch or repository.
- bzr init [LOCATION]
- Make a directory into a versioned branch.
- bzr init-repository LOCATION
- Create a shared repository for branches to share storage space.
- bzr join TREE
- Combine a tree into its containing tree.
- bzr launchpad-login [NAME]
- Show or set the Launchpad user ID.
- bzr launchpad-mirror [LOCATION]
- Ask Launchpad to mirror a branch now.
- bzr launchpad-open [LOCATION]
- Open a Launchpad branch page in your web browser.
- bzr log [FILE...]
- Show historical log for a branch or subset of a branch.
- bzr lp-find-proposal
- Find the proposal to merge this revision.
- bzr lp-propose-merge [SUBMIT_BRANCH]
- Propose merging a branch on Launchpad.
- bzr ls [PATH]
- List files in a tree.
- bzr merge [LOCATION]
- Perform a three-way merge.
- bzr missing [OTHER_BRANCH]
- Show unmerged/unpulled revisions between two branches.
- bzr mkdir DIR...
- Create a new versioned directory.
- bzr mv [NAMES...]
- Move or rename a file.
- bzr nick [NICKNAME]
- Print or set the branch nickname.
- bzr pack [BRANCH_OR_REPO]
- Compress the data within a repository.
- bzr plugins
- List the installed plugins.
- bzr pull [LOCATION]
- Turn this branch into a mirror of another branch.
- bzr push [LOCATION]
- Update a mirror of this branch.
- bzr reconcile [BRANCH]
- Reconcile bzr metadata in a branch.
- bzr reconfigure [LOCATION]
- Reconfigure the type of a bzr directory.
- bzr register-branch [PUBLIC_URL]
- Register a branch with launchpad.net.
- bzr remerge [FILE...]
- Redo a merge.
- bzr remove [FILE...]
- Remove files or directories.
- bzr remove-branch [LOCATION]
- Remove a branch.
- bzr remove-tree [LOCATION...]
- Remove the working tree from a given branch/checkout.
- bzr renames [DIR]
- Show list of renamed files.
- bzr resolve [FILE...]
- Mark a conflict as resolved.
- bzr revert [FILE...]
- Set files in the working tree back to the contents of a previous revision.
- bzr revno [LOCATION]
- Show current revision number.
- bzr root [FILENAME]
- Show the tree root directory.
- bzr send [SUBMIT_BRANCH] [PUBLIC_BRANCH]
- Mail or create a merge-directive for submitting changes.
- bzr serve
- Run the bzr server.
- bzr shelve [FILE...]
- Temporarily set aside some changes from the current tree.
- bzr sign-my-commits [LOCATION] [COMMITTER]
- Sign all commits by a given committer.
- bzr split TREE
- Split a subdirectory of a tree into a separate tree.
- bzr status [FILE...]
- Display status summary.
- bzr switch [TO_LOCATION]
- Set the branch of a checkout and update.
- bzr tag [TAG_NAME]
- Create, remove or modify a tag naming a revision.
- bzr tags
- List tags.
- bzr testament [BRANCH]
- Show testament (signing-form) of a revision.
- bzr unbind
- Convert the current checkout into a regular branch.
- bzr uncommit [LOCATION]
- Remove the last committed revision.
- bzr unshelve [SHELF_ID]
- Restore shelved changes.
- bzr update [DIR]
- Update a working tree to a new revision.
- bzr upgrade [URL]
- Upgrade a repository, branch or working tree to a newer format.
- bzr verify-signatures [LOCATION]
- Verify all commit signatures.
- bzr version
- Show version of bzr.
- bzr version-info [LOCATION]
- Show version information about this tree.
- bzr view [FILE...]
- Manage filtered views.
- bzr whoami [NAME]
- Show or set bzr user id.
COMMAND REFERENCE¶
bzr --help¶
Alias for "help", see "bzr help".bzr -?¶
Alias for "help", see "bzr help".bzr -h¶
Alias for "help", see "bzr help".bzr ?¶
Alias for "help", see "bzr help".bzr add [FILE...]¶
Options:--dry-run Show what would be done, but don't
actually do anything.
--file-ids-from ARG Lookup file ids from this tree.
--help, -h Show help message.
--no-recurse, -N Don't recursively add the contents of
directories.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr alias [NAME]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--remove Remove the alias.
--usage Show usage message and options.
--verbose, -v Display more information.
Show the current aliases:
bzr alias
Show the alias specified for 'll':
bzr alias ll
Set an alias for 'll':
bzr alias ll="log --line -r-10..-1"
To remove an alias for 'll':
bzr alias --remove ll
bzr ann¶
Alias for "annotate", see "bzr annotate".bzr annotate FILENAME¶
Options:--all Show annotations on all lines.
--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--long Show commit date in annotations.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--show-ids Show internal object ids.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr bind [LOCATION]¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr blame¶
Alias for "annotate", see "bzr annotate".bzr branch FROM_LOCATION [TO_LOCATION]¶
Options:--bind Bind new branch to from location.
--files-from ARG Get file contents from this tree.
--hardlink Hard-link working tree files where
possible.
--help, -h Show help message.
--no-tree Create a branch without a working-tree.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--stacked Create a stacked branch referring to the
source branch. The new branch will
depend on the availability of the source
branch for all operations.
--standalone Do not use a shared repository, even if
available.
--switch Switch the checkout in the current
directory to the new branch.
--usage Show usage message and options.
--use-existing-dir By default branch will fail if the
target directory exists, but does not
already have a control directory. This
flag will allow branch to proceed.
--verbose, -v Display more information.
bzr branches [LOCATION]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--recursive, -R Recursively scan for branches rather
than just looking in the specified
location.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr break-lock [LOCATION]¶
Options:--config LOCATION is the directory where the
config lock is.
--force Do not ask for confirmation before
breaking the lock.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr break-lock
bzr break-lock bzr+ssh://example.com/bzr/foo
bzr break-lock --conf ~/.bazaar
bzr cat FILENAME¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--filters Apply content filters to display the
convenience form.
--help, -h Show help message.
--name-from-revision The path name in the old tree.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr check [PATH]¶
Options:--branch Check the branch related to the current
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--repo Check the repository related to the
current directory.
--tree Check the working tree related to the
current directory.
--usage Show usage message and options.
--verbose, -v Display more information.
This is just the number of revisions checked. It doesn't
indicate a problem.
This is just the number of versionedfiles checked. It
doesn't indicate a problem.
Texts that are ancestors of other texts, but
are not properly referenced by the revision ancestry. This is a
subtle problem that Bazaar can work around.
This is the total number of unique file contents
seen in the checked revisions. It does not indicate a problem.
This is the total number of repeated texts seen
in the checked revisions. Texts can be repeated when their file
entries are modified, but the file contents are not. It does not
indicate a problem.
Check the tree and branch at 'foo':
bzr check --tree --branch foo
Check only the repository at 'bar':
bzr check --repo bar
Check everything at 'baz':
bzr check baz
bzr checkin¶
Alias for "commit", see "bzr commit".bzr checkout [BRANCH_LOCATION] [TO_LOCATION]¶
Options:--files-from ARG Get file contents from this tree.
--hardlink Hard-link working tree files where
possible.
--help, -h Show help message.
--lightweight Perform a lightweight checkout.
Lightweight checkouts depend on access
to the branch for every operation.
Normal checkouts can perform common
operations like diff and status without
such access, and also support local
commits.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr ci¶
Alias for "commit", see "bzr commit".bzr clean-tree¶
Options:--detritus Delete conflict files, merge and revert
backups, and failed selftest dirs.
--directory ARG, -d Branch to operate on, instead of working
directory.
--dry-run Show files to delete instead of deleting
them.
--force Do not prompt before deleting.
--help, -h Show help message.
--ignored Delete all ignored files.
--quiet, -q Only display errors and warnings.
--unknown Delete files unknown to bzr (default).
--usage Show usage message and options.
--verbose, -v Display more information.
bzr clone¶
Alias for "branch", see "bzr branch".bzr co¶
Alias for "checkout", see "bzr checkout".bzr commit [SELECTED...]¶
Options:--author ARG Set the author's name, if it's different
from the committer.
--commit-time ARG Manually set a commit time using commit
date format, e.g. '2009-10-10 08:00:00
+0100'.
--exclude ARG, -x Do not consider changes made to a given
path.
--file MSGFILE, -F Take commit message from this file.
--fixes ARG Mark a bug as being fixed by this
revision (see "bzr help bugs").
--help, -h Show help message.
--local Perform a local commit in a bound
branch. Local commits are not pushed to
the master branch until a normal commit
is performed.
--lossy When committing to a foreign version
control system do not push data that can
not be natively represented.
--message ARG, -m Description of the new revision.
--quiet, -q Only display errors and warnings.
--show-diff, -p When no message is supplied, show the
diff along with the status summary in
the message editor.
--strict Refuse to commit if there are unknown
files in the working tree.
--unchanged Commit even if nothing has changed.
--usage Show usage message and options.
--verbose, -v Display more information.
If selected files are specified, only changes to those files are
committed. If a directory is specified then the directory and
everything within it is committed.
When excludes are given, they take precedence over selected files.
For example, to commit only changes within foo, but not changes
within foo/bar:
bzr commit foo -x foo/bar
A selective commit after a merge is not yet supported.
If the author of the change is not the same person as the committer,
you can specify the author's name using the --author option. The
name should be in the same format as a committer-id, e.g.
"John Doe <jdoe@example.com>". If there is more than one author of
the change you can specify the option multiple times, once for each
author.
A common mistake is to forget to add a new file or directory before
running the commit command. The --strict option checks for unknown
files and aborts the commit if any are found. More advanced pre-commit
checks can be implemented by defining hooks. See \*(Aq\*(Aqbzr help hooks\*(Aq\*(Aq
for details.
If you accidentially commit the wrong changes or make a spelling
mistake in the commit message say, you can use the uncommit command
to undo it. See \*(Aq\*(Aqbzr help uncommit\*(Aq\*(Aq for details.
Hooks can also be configured to run after a commit. This allows you
to trigger updates to external systems like bug trackers. The --fixes
option can be used to record the association between a revision and
one or more bugs. See \*(Aq\*(Aqbzr help bugs\*(Aq\*(Aq for details.
bzr config [NAME]¶
Options:--all Display all the defined values for the
matching options.
--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--remove Remove the option from the configuration
file.
--scope ARG Reduce the scope to the specified
configuration file.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr conflicts¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--text List paths of files with text conflicts.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr del¶
Alias for "remove", see "bzr remove".bzr deleted¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--show-ids Show internal object ids.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr di¶
Alias for "diff", see "bzr diff".bzr dif¶
Alias for "diff", see "bzr diff".bzr diff [FILE...]¶
Options:--change ARG, -c Select changes introduced by the
specified revision. See also "help
revisionspec".
--diff-options ARG Pass these options to the external diff
program.
--format ARG, -F Diff format to use.
--help, -h Show help message.
--new ARG Branch/tree to compare to.
--old ARG Branch/tree to compare from.
--prefix ARG, -p Set prefixes added to old and new
filenames, as two values separated by a
colon. (eg "old/:new/").
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--using ARG Use this command to compare files.
--verbose, -v Display more information.
1 - changed
2 - unrepresentable changes
3 - error
0 - no change
Shows the difference in the working tree versus the last commit:
bzr diff
Difference between the working tree and revision 1:
bzr diff -r1
Difference between revision 3 and revision 1:
bzr diff -r1..3
Difference between revision 3 and revision 1 for branch xxx:
bzr diff -r1..3 xxx
The changes introduced by revision 2 (equivalent to -r1..2):
bzr diff -c2
To see the changes introduced by revision X:
bzr diff -cX
Note that in the case of a merge, the -c option shows the changes
compared to the left hand parent. To see the changes against
another parent, use:
bzr diff -r<chosen_parent>..X
The changes between the current revision and the previous revision
(equivalent to -c-1 and -r-2..-1)
bzr diff -r-2..
Show just the differences for file NEWS:
bzr diff NEWS
Show the differences in working tree xxx for file NEWS:
bzr diff xxx/NEWS
Show the differences from branch xxx to this working tree:
bzr diff --old xxx
Show the differences between two branches for file NEWS:
bzr diff --old xxx --new yyy NEWS
Same as 'bzr diff' but prefix paths with old/ and new/:
bzr diff --prefix old/:new/
Show the differences using a custom diff program with options:
bzr diff --using /usr/bin/diff --diff-options -wu
bzr dpush [LOCATION]¶
Options:--directory ARG, -d Branch to push from, rather than the one
containing the working directory.
--help, -h Show help message.
--no-rebase Do not rebase after push.
--quiet, -q Only display errors and warnings.
--remember Remember the specified location as a
default.
--strict Refuse to push if there are uncommitted
changes in the working tree, --no-strict
disables the check.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr export DEST [BRANCH_OR_SUBDIR]¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--filters Apply content filters to export the
convenient form.
--format ARG Type of file to export to.
--help, -h Show help message.
--per-file-timestamps Set modification time of files to that
of the last revision in which it was
changed.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--root ARG Name of the root directory inside the
exported file.
--uncommitted Export the working tree contents rather
than that of the last revision.
--usage Show usage message and options.
--verbose, -v Display more information.
================= =========================
Supported formats Autodetected by extension
================= =========================
dir (none)
tar .tar
tbz2 .tar.bz2, .tbz2
tgz .tar.gz, .tgz
zip .zip
================= =========================
bzr get¶
Alias for "branch", see "bzr branch".bzr help [TOPIC]¶
Options:--help, -h Show help message.
--long Show help on all commands.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr ignore [NAME_PATTERN...]¶
Options:--default-rules Display the default ignore rules that
bzr uses.
--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
the shell on Unix.
To ignore patterns that begin with that character, use the "RE:" prefix.
Ignore the top level Makefile:
bzr ignore ./Makefile
Ignore .class files in all directories...:
bzr ignore "*.class"
...but do not ignore "special.class":
bzr ignore "!special.class"
Ignore files whose name begins with the "#" character:
bzr ignore "RE:^#"
Ignore .o files under the lib directory:
bzr ignore "lib/**/*.o"
Ignore .o files under the lib directory:
bzr ignore "RE:lib/.*\.o"
Ignore everything but the "debian" toplevel directory:
bzr ignore "RE:(?!debian/).*"
Ignore everything except the "local" toplevel directory,
but always ignore autosave files ending in ~, even under local/:
bzr ignore "*"
bzr ignore "!./local"
bzr ignore "!!*~"
bzr ignored¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr ls --ignored
bzr info [LOCATION]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
Display information on the format and related locations:
bzr info
Display the above together with extended format information and
basic statistics (like the number of files in the working tree and
number of revisions in the branch and repository):
bzr info -v
Display the above together with number of committers to the branch:
bzr info -vv
bzr init [LOCATION]¶
Options:--append-revisions-only Never change revnos or the existing log.
Append revisions to it only.
--create-prefix Create the path leading up to the branch
if it does not already exist.
--format ARG Specify a format for this branch. See
"help formats".
--2a Format for the bzr 2.0 series. Uses
group-compress storage. Provides rich
roots which are a one-way transition.
--default Format for the bzr 2.0 series. Uses
group-compress storage. Provides rich
roots which are a one-way transition.
--development-colo The 2a format with experimental support
for colocated branches.
--pack-0.92 Pack-based format used in 1.x series.
Introduced in 0.92. Interoperates with
bzr repositories before 0.92 but cannot
be read by bzr < 0.92.
--help, -h Show help message.
--no-tree Create a branch without a working tree.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
cd ~/project
bzr init
bzr add .
bzr status
bzr commit -m "imported project"
bzr init-repo¶
Alias for "init-repository", see "bzr init-repository".bzr init-repository LOCATION¶
Options:--format ARG Specify a format for this repository.
See "bzr help formats" for details.
--2a Format for the bzr 2.0 series. Uses
group-compress storage. Provides rich
roots which are a one-way transition.
--default Format for the bzr 2.0 series. Uses
group-compress storage. Provides rich
roots which are a one-way transition.
--development-colo The 2a format with experimental support
for colocated branches.
--pack-0.92 Pack-based format used in 1.x series.
Introduced in 0.92. Interoperates with
bzr repositories before 0.92 but cannot
be read by bzr < 0.92.
--help, -h Show help message.
--no-trees Branches in the repository will default
to not having a working tree.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
Create a shared repository holding just branches:
bzr init-repo --no-trees repo
bzr init repo/trunk
Make a lightweight checkout elsewhere:
bzr checkout --lightweight repo/trunk trunk-checkout
cd trunk-checkout
(add files here)
bzr join TREE¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr launchpad-login [NAME]¶
Options:--help, -h Show help message.
--no-check Don't check that the user name is valid.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
Show the Launchpad ID of the current user:
bzr launchpad-login
Set the Launchpad ID of the current user to 'bob':
bzr launchpad-login bob
bzr launchpad-mirror [LOCATION]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr launchpad-open [LOCATION]¶
Options:--dry-run Do not actually open the browser. Just
say the URL we would use.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr log [FILE...]¶
Options:--authors ARG What names to list as authors - first,
all or committer.
--change ARG, -c Show just the specified revision. See
also "help revisionspec".
--exclude-common-ancestry Display only the revisions that are not
part of both ancestries (require
-rX..Y).
--forward Show from oldest to newest.
--help, -h Show help message.
--include-merged Show merged revisions like --levels 0
does.
--levels N, -n Number of levels to display - 0 for all,
1 for flat.
--limit N, -l Limit the output to the first N
revisions.
--log-format ARG Use specified log format.
--gnu-changelog Format used by GNU ChangeLog files.
--line Log format with one line per revision.
--long Detailed log format.
--short Moderately short log format.
--match ARG, -m Show revisions whose properties match
this expression.
--match-author ARG Show revisions whose authors match this
expression.
--match-bugs ARG Show revisions whose bugs match this
expression.
--match-committer ARG Show revisions whose committer matches
this expression.
--match-message ARG Show revisions whose message matches
this expression.
--omit-merges Do not report commits with more than one
parent.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--show-diff, -p Show changes made in each revision as a
patch.
--show-ids Show internal object ids.
--signatures Show digital signature validity.
--timezone ARG Display timezone as local, original, or
utc.
--usage Show usage message and options.
--verbose, -v Show files changed in each revision.
bzr log log the current branch
bzr log foo.py log a file in its branch
bzr log http://server/branch log a branch on a server
The log format controls how information about each revision is
displayed. The standard log formats are called \*(Aq\*(Aqlong\*(Aq\*(Aq, \*(Aq\*(Aqshort\*(Aq\*(Aq
and \*(Aq\*(Aqline\*(Aq\*(Aq. The default is long. See \*(Aq\*(Aqbzr help log-formats\*(Aq\*(Aq
for more details on log formats.
The following options can be used to control what information is
displayed:
-l N display a maximum of N revisions
-n N display N levels of revisions (0 for all, 1 for collapsed)
-v display a status summary (delta) for each revision
-p display a diff (patch) for each revision
--show-ids display revision-ids (and file-ids), not just revnos
Note that the default number of levels to display is a function of the
log format. If the -n option is not used, the standard log formats show
just the top level (mainline).
Status summaries are shown using status flags like A, M, etc. To see
the changes explained using words like \*(Aq\*(Aqadded\*(Aq\*(Aq and \*(Aq\*(Aqmodified\*(Aq\*(Aq
instead, use the -vv option.
To display revisions from oldest to newest, use the --forward option.
In most cases, using this option will have little impact on the total
time taken to produce a log, though --forward does not incrementally
display revisions like --reverse does when it can.
The -r option can be used to specify what revision or range of revisions
to filter against. The various forms are shown below:
-rX display revision X
-rX.. display revision X and later
-r..Y display up to and including revision Y
-rX..Y display from X to Y inclusive
See \*(Aq\*(Aqbzr help revisionspec\*(Aq\*(Aq for details on how to specify X and Y.
Some common examples are given below:
-r-1 show just the tip
-r-10.. show the last 10 mainline revisions
-rsubmit:.. show what's new on this branch
-rancestor:path.. show changes since the common ancestor of this
branch and the one at location path
-rdate:yesterday.. show changes since yesterday
When logging a range of revisions using -rX..Y, log starts at
revision Y and searches back in history through the primary
("left-hand") parents until it finds X. When logging just the
top level (using -n1), an error is reported if X is not found
along the way. If multi-level logging is used (-n0), X may be
a nested merge revision and the log will be truncated accordingly.
If parameters are given and the first one is not a branch, the log
will be filtered to show only those revisions that changed the
nominated files or directories.
Filenames are interpreted within their historical context. To log a
deleted file, specify a revision range so that the file existed at
the end or start of the range.
Historical context is also important when interpreting pathnames of
renamed files/directories. Consider the following example:
* revision 1: add tutorial.txt
* revision 2: modify tutorial.txt
* revision 3: rename tutorial.txt to guide.txt; add tutorial.txt
In this case:
* \*(Aq\*(Aqbzr log guide.txt\*(Aq\*(Aq will log the file added in revision 1
* \*(Aq\*(Aqbzr log tutorial.txt\*(Aq\*(Aq will log the new file added in revision 3
* \*(Aq\*(Aqbzr log -r2 -p tutorial.txt\*(Aq\*(Aq will show the changes made to
the original file in revision 2.
* \*(Aq\*(Aqbzr log -r2 -p guide.txt\*(Aq\*(Aq will display an error message as there
was no file called guide.txt in revision 2.
Renames are always followed by log. By design, there is no need to
explicitly ask for this (and no way to stop logging a file back
until it was last renamed).
The --match option can be used for finding revisions that match a
regular expression in a commit message, committer, author or bug.
Specifying the option several times will match any of the supplied
expressions. --match-author, --match-bugs, --match-committer and
--match-message can be used to only match a specific field.
GUI tools and IDEs are often better at exploring history than command
line tools: you may prefer qlog or viz from qbzr or bzr-gtk, the
bzr-explorer shell, or the Loggerhead web interface. See the Plugin
Guide <http://doc.bazaar.canonical.com/plugins/en/> and
<http://wiki.bazaar.canonical.com/IDEIntegration>.
You may find it useful to add the aliases below to \*(Aq\*(Aqbazaar.conf\*(Aq\*(Aq:
[ALIASES]
tip = log -r-1
top = log -l10 --line
show = log -v -p
\*(Aq\*(Aqbzr tip\*(Aq\*(Aq will then show the latest revision while \*(Aq\*(Aqbzr top\*(Aq\*(Aq
will show the last 10 mainline revisions. To see the details of a
particular revision X, \*(Aq\*(Aqbzr show -rX\*(Aq\*(Aq.
If you are interested in looking deeper into a particular merge X,
use \*(Aq\*(Aqbzr log -n0 -rX\*(Aq\*(Aq.
\*(Aq\*(Aqbzr log -v\*(Aq\*(Aq on a branch with lots of history is currently
very slow. A fix for this issue is currently under development.
With or without that fix, it is recommended that a revision range
be given when using the -v option.
bzr has a generic full-text matching plugin, bzr-search, that can be
used to find revisions matching user names, commit messages, etc.
Among other features, this plugin can find all revisions containing
a list of words but not others.
When exploring non-mainline history on large projects with deep
history, the performance of log can be greatly improved by installing
the historycache plugin. This plugin buffers historical information
trading disk space for faster speed.
bzr lp-find-proposal¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr lp-find-proposal -r annotate:README:1
bzr lp-login¶
Alias for "launchpad-login", see "bzr launchpad-login".bzr lp-mirror¶
Alias for "launchpad-mirror", see "bzr launchpad-mirror".bzr lp-open¶
Alias for "launchpad-open", see "bzr launchpad-open".bzr lp-propose¶
Alias for "lp-propose-merge", see "bzr lp-propose-merge".bzr lp-propose-merge [SUBMIT_BRANCH]¶
Options:--approve Mark the proposal as approved
immediately.
--fixes ARG The bug this proposal fixes.
--help, -h Show help message.
--message ARG, -m Commit message.
--quiet, -q Only display errors and warnings.
--review ARG, -R Requested reviewer and optional type.
--staging Propose the merge on staging.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr lp-propose-merge --review jrandom --review review-team=qa
bzr lp-submit¶
Alias for "lp-propose-merge", see "bzr lp-propose-merge".bzr ls [PATH]¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--from-root Print paths relative to the root of the
branch.
--help, -h Show help message.
--ignored, -i Print ignored files.
--kind ARG, -k List entries of a particular kind: file,
directory, symlink.
--null, -0 Use an ASCII NUL (\0) separator rather
than a newline.
--quiet, -q Only display errors and warnings.
--recursive, -R Recurse into subdirectories.
--revision ARG, -r See "help revisionspec" for details.
--show-ids Show internal object ids.
--unknown, -u Print unknown files.
--usage Show usage message and options.
--verbose, -v Display more information.
--versioned, -V Print versioned files.
bzr merge [LOCATION]¶
Options:--change ARG, -c Select changes introduced by the
specified revision. See also "help
revisionspec".
--directory ARG, -d Branch to merge into, rather than the
one containing the working directory.
--force Merge even if the destination tree has
uncommitted changes.
--help, -h Show help message.
--interactive, -i Select changes interactively.
--merge-type ARG Select a particular merge algorithm.
--diff3 Merge using external diff3.
--lca LCA-newness merge.
--merge3 Native diff3-style merge.
--weave Weave-based merge.
--preview Instead of merging, show a diff of the
merge.
--pull If the destination is already completely
merged into the source, pull from the
source rather than merging. When this
happens, you do not need to commit the
result.
--quiet, -q Only display errors and warnings.
--remember Remember the specified location as a
default.
--reprocess Reprocess to reduce spurious conflicts.
--revision ARG, -r See "help revisionspec" for details.
--show-base Show base revision text in conflicts.
--uncommitted Apply uncommitted changes from a working
copy, instead of branch changes.
--usage Show usage message and options.
--verbose, -v Display more information.
To merge all new revisions from bzr.dev:
bzr merge ../bzr.dev
To merge changes up to and including revision 82 from bzr.dev:
bzr merge -r 82 ../bzr.dev
To merge the changes introduced by 82, without previous changes:
bzr merge -r 81..82 ../bzr.dev
To apply a merge directive contained in /tmp/merge:
bzr merge /tmp/merge
To create a merge revision with three parents from two branches
feature1a and feature1b:
bzr merge ../feature1a
bzr merge ../feature1b --force
bzr commit -m 'revision with three parents'
bzr missing [OTHER_BRANCH]¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--include-merged Show all revisions in addition to the
mainline ones.
--log-format ARG Use specified log format.
--gnu-changelog Format used by GNU ChangeLog files.
--line Log format with one line per revision.
--long Detailed log format.
--short Moderately short log format.
--mine-only Display changes in the local branch
only.
--my-revision ARG Filter on local branch revisions
(inclusive). See "help revisionspec" for
details.
--other Same as --theirs-only.
--quiet, -q Only display errors and warnings.
--reverse Reverse the order of revisions.
--revision ARG, -r Filter on other branch revisions
(inclusive). See "help revisionspec" for
details.
--show-ids Show internal object ids.
--theirs-only Display changes in the remote branch
only.
--this Same as --mine-only.
--usage Show usage message and options.
--verbose, -v Display more information.
1 - some missing revisions
0 - no missing revisions
Determine the missing revisions between this and the branch at the
remembered pull location:
bzr missing
Determine the missing revisions between this and another branch:
bzr missing http://server/branch
Determine the missing revisions up to a specific revision on the other
branch:
bzr missing -r ..-10
Determine the missing revisions up to a specific revision on this
branch:
bzr missing --my-revision ..-10
bzr mkdir DIR...¶
Options:--help, -h Show help message.
--parents, -p No error if existing, make parent
directories as needed.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr move¶
Alias for "mv", see "bzr mv".bzr mv [NAMES...]¶
Options:--after Move only the bzr identifier of the
file, because the file has already been
moved.
--auto Automatically guess renames.
--dry-run Avoid making changes when guessing
renames.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr mv OLDNAME NEWNAME
bzr mv SOURCE... DESTINATION
bzr nick [NICKNAME]¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr pack [BRANCH_OR_REPO]¶
Options:--clean-obsolete-packs Delete obsolete packs to save disk
space.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr plugins¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr praise¶
Alias for "annotate", see "bzr annotate".bzr pull [LOCATION]¶
Options:--directory ARG, -d Branch to pull into, rather than the one
containing the working directory.
--help, -h Show help message.
--local Perform a local pull in a bound branch.
Local pulls are not applied to the
master branch.
--overwrite Ignore differences between branches and
overwrite unconditionally.
--overwrite-tags Overwrite tags only.
--quiet, -q Only display errors and warnings.
--remember Remember the specified location as a
default.
--revision ARG, -r See "help revisionspec" for details.
--show-base Show base revision text in conflicts.
--usage Show usage message and options.
--verbose, -v Show logs of pulled revisions.
bzr push [LOCATION]¶
Options:--create-prefix Create the path leading up to the branch
if it does not already exist.
--directory ARG, -d Branch to push from, rather than the one
containing the working directory.
--help, -h Show help message.
--no-tree Don't populate the working tree, even
for protocols that support it.
--overwrite Ignore differences between branches and
overwrite unconditionally.
--overwrite-tags Overwrite tags only.
--quiet, -q Only display errors and warnings.
--remember Remember the specified location as a
default.
--revision ARG, -r See "help revisionspec" for details.
--stacked Create a stacked branch that references
the public location of the parent
branch.
--stacked-on ARG Create a stacked branch that refers to
another branch for the commit history.
Only the work not present in the
referenced branch is included in the
branch created.
--strict Refuse to push if there are uncommitted
changes in the working tree, --no-strict
disables the check.
--usage Show usage message and options.
--use-existing-dir By default push will fail if the target
directory exists, but does not already
have a control directory. This flag
will allow push to proceed.
--verbose, -v Display more information.
bzr reconcile [BRANCH]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr reconfigure [LOCATION]¶
Options:--bind-to ARG Branch to bind checkout to.
--force Perform reconfiguration even if local
changes will be lost.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--repository_trees ARG Whether new branches in the repository
have trees.
--with-no-trees Reconfigure repository to not create
working trees on branches by default.
--with-trees Reconfigure repository to create working
trees on branches by default.
--repository_type ARG Location fo the repository.
--standalone Reconfigure to be a standalone branch
(i.e. stop using shared repository).
--use-shared Reconfigure to use a shared repository.
--stacked-on ARG Reconfigure a branch to be stacked on
another branch.
--tree_type ARG The relation between branch and tree.
--branch Reconfigure to be an unbound branch with
no working tree.
--checkout Reconfigure to be a bound branch with a
working tree.
--lightweight-checkout Reconfigure to be a lightweight checkout
(with no local history).
--tree Reconfigure to be an unbound branch with
a working tree.
--unstacked Reconfigure a branch to be unstacked.
This may require copying substantial
data into it.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr register-branch [PUBLIC_URL]¶
Options:--author ARG Branch author's email address, if not
yourself.
--branch-description ARG Longer description of the purpose or
contents of the branch.
--branch-name ARG Short name for the branch; by default
taken from the last component of the
url.
--branch-title ARG One-sentence description of the branch.
--dry-run Prepare the request but don't actually
send it.
--help, -h Show help message.
--link-bug ARG The bug this branch fixes.
--project ARG Launchpad project short name to
associate with the branch.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
public_url: The publicly visible url for the branch to register.
This must be an http or https url (which Launchpad can read
from to access the branch). Local file urls, SFTP urls, and
bzr+ssh urls will not work.
If no public_url is provided, bzr will use the configured
public_url if there is one for the current branch, and
otherwise error.
bzr register-branch http://foo.com/bzr/fooproject.mine \
--project fooproject
bzr remerge [FILE...]¶
Options:--help, -h Show help message.
--merge-type ARG Select a particular merge algorithm.
--diff3 Merge using external diff3.
--lca LCA-newness merge.
--merge3 Native diff3-style merge.
--weave Weave-based merge.
--quiet, -q Only display errors and warnings.
--reprocess Reprocess to reduce spurious conflicts.
--show-base Show base revision text in conflicts.
--usage Show usage message and options.
--verbose, -v Display more information.
Re-do the merge of all conflicted files, and show the base text in
conflict regions, in addition to the usual THIS and OTHER texts:
bzr remerge --show-base
Re-do the merge of "foobar", using the weave merge algorithm, with
additional processing to reduce the size of conflict regions:
bzr remerge --merge-type weave --reprocess foobar
bzr remove [FILE...]¶
Options:--file-deletion-strategy ARGThe file deletion mode to be used.
--force Delete all the specified files, even if
they can not be recovered and even if
they are non-empty directories.
(deprecated, use no-backup)
--keep Delete from bzr but leave the working
copy.
--no-backup Don't backup changed files.
--safe Backup changed files (default).
--help, -h Show help message.
--new Only remove files that have never been
committed.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr remove-branch [LOCATION]¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--force Remove branch even if it is the active
branch.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
Remove the branch at repo/trunk:
bzr remove-branch repo/trunk
bzr remove-tree [LOCATION...]¶
Options:--force Remove the working tree even if it has
uncommitted or shelved changes.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr rename¶
Alias for "mv", see "bzr mv".bzr renames [DIR]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr resolve [FILE...]¶
Options:--action ARG How to resolve the conflict.
--done Marks the conflict as resolved.
--take-other Resolve the conflict taking the merged
version into account.
--take-this Resolve the conflict preserving the
version in the working tree.
--all Resolve all conflicts in this tree.
--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr resolved¶
Alias for "resolve", see "bzr resolve".bzr revert [FILE...]¶
Options:--forget-merges Remove pending merge marker, without
changing any files.
--help, -h Show help message.
--no-backup Do not save backups of reverted files.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr revno [LOCATION]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--tree Show revno of working tree.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr rm¶
Alias for "remove", see "bzr remove".bzr rmbranch¶
Alias for "remove-branch", see "bzr remove-branch".bzr root [FILENAME]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr send [SUBMIT_BRANCH] [PUBLIC_BRANCH]¶
Options:--body ARG Body for the email.
--format ARG Use the specified output format.
--from ARG, -f Branch to generate the submission from,
rather than the one containing the
working directory.
--help, -h Show help message.
--mail-to ARG Mail the request to this address.
--message ARG, -m Message string.
--no-bundle Do not include a bundle in the merge
directive.
--no-patch Do not include a preview patch in the
merge directive.
--output ARG, -o Write merge directive to this file or
directory; use - for stdout.
--quiet, -q Only display errors and warnings.
--remember Remember submit and public branch.
--revision ARG, -r See "help revisionspec" for details.
--strict Refuse to send if there are uncommitted
changes in the working tree, --no-strict
disables the check.
--usage Show usage message and options.
--verbose, -v Display more information.
directly from the merge directive, without retrieving data from a
branch.
bzr serve¶
Options:--allow-writes By default the server is a readonly
server. Supplying --allow-writes
enables write access to the contents of
the served directory and below. Note
that \*(Aq\*(Aqbzr serve\*(Aq\*(Aq does not perform
authentication, so unless some form of
external authentication is arranged
supplying this option leads to global
uncontrolled write access to your file
system.
--client-timeout ARG Override the default idle client timeout
(5min).
--directory ARG, -d Serve contents of this directory.
--help, -h Show help message.
--inet Serve on stdin/out for use from inetd or
sshd.
--listen ARG Listen for connections on nominated
address.
--port ARG Listen for connections on nominated
port. Passing 0 as the port number will
result in a dynamically allocated port.
The default port depends on the
protocol.
--protocol ARG Protocol to serve.
--bzr The Bazaar smart server protocol over
TCP. (default port: 4155)
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr server¶
Alias for "serve", see "bzr serve".bzr shelve [FILE...]¶
Options:--all Shelve all changes.
--destroy Destroy removed changes instead of
shelving them.
--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--list List shelved changes.
--message ARG, -m Message string.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
--writer ARG Method to use for writing diffs.
--plain Plaintext diff output.
change_editor = PROGRAM @new_path @old_path
bzr sign-my-commits [LOCATION] [COMMITTER]¶
Options:--dry-run Don't actually sign anything, just print
the revisions that would be signed.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr split TREE¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr st¶
Alias for "status", see "bzr status".bzr stat¶
Alias for "status", see "bzr status".bzr status [FILE...]¶
Options:--change ARG, -c Select changes introduced by the
specified revision. See also "help
revisionspec".
--help, -h Show help message.
--no-classify Do not mark object type using indicator.
--no-pending Don't show pending merges.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--short, -S Use short status indicators.
--show-ids Show internal object ids.
--usage Show usage message and options.
--verbose, -v Display more information.
--versioned, -V Only show versioned files.
Versioned in the working copy but not in the previous revision.
Versioned in the previous revision but removed or deleted
in the working copy.
Path of this file changed from the previous revision;
the text may also have changed. This includes files whose
parent directory was renamed.
Text has changed since the previous revision.
File kind has been changed (e.g. from file to directory).
Not versioned and not matching an ignore pattern.
bzr switch [TO_LOCATION]¶
Options:--create-branch, -b Create the target branch from this one
before switching to it.
--directory ARG, -d Branch to operate on, instead of working
directory.
--force Switch even if local commits will be
lost.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr tag [TAG_NAME]¶
Options:--delete Delete this tag rather than placing it.
--directory ARG, -d Branch in which to place the tag.
--force Replace existing tags.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr tags¶
Options:--directory ARG, -d Branch whose tags should be displayed.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--show-ids Show internal object ids.
--sort ARG Sort tags by different criteria.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr testament [BRANCH]¶
Options:--help, -h Show help message.
--long Produce long-format testament.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--strict Produce a strict-format testament.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr unbind¶
Options:--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr uncommit [LOCATION]¶
Options:--dry-run Don't actually make changes.
--force Say yes to all questions.
--help, -h Show help message.
--keep-tags Keep tags that point to removed
revisions.
--local Only remove the commits from the local
branch when in a checkout.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr unshelve [SHELF_ID]¶
Options:--action ARG The action to perform.
--apply Apply changes and remove from the shelf.
--delete-only Delete changes without applying them.
--dry-run Show changes, but do not apply or remove
them.
--keep Apply changes but don't delete them.
--preview Instead of unshelving the changes, show
the diff that would result from
unshelving.
--directory ARG, -d Branch to operate on, instead of working
directory.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr up¶
Alias for "update", see "bzr update".bzr update [DIR]¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--show-base Show base revision text in conflicts.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr upgrade [URL]¶
Options:--clean Remove the backup.bzr directory if
successful.
--dry-run Show what would be done, but don't
actually do anything.
--format ARG Upgrade to a specific format. See "bzr
help formats" for details.
--2a Format for the bzr 2.0 series. Uses
group-compress storage. Provides rich
roots which are a one-way transition.
--default Format for the bzr 2.0 series. Uses
group-compress storage. Provides rich
roots which are a one-way transition.
--development-colo The 2a format with experimental support
for colocated branches.
--pack-0.92 Pack-based format used in 1.x series.
Introduced in 0.92. Interoperates with
bzr repositories before 0.92 but cannot
be read by bzr < 0.92.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr verify-signatures [LOCATION]¶
Options:--acceptable-keys ARG, -k Comma separated list of GPG key patterns
which are acceptable for verification.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr version¶
Options:--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--short Print just the version number.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr version-info [LOCATION]¶
Options:--all Include all possible information.
--check-clean Check if tree is clean.
--format ARG Select the output format.
--custom Version info in Custom template-based
format.
--python Version info in Python format.
--rio Version info in RIO (simple text) format
(default).
--help, -h Show help message.
--include-file-revisions Include the last revision for each file.
--include-history Include the revision-history.
--quiet, -q Only display errors and warnings.
--revision ARG, -r See "help revisionspec" for details.
--template ARG Template for the output.
--usage Show usage message and options.
--verbose, -v Display more information.
bzr version-info --custom \
--template="#define VERSION_INFO \"Project 1.2.3 (r{revno})\"\n"
* {date} - date of the last revision
* {build_date} - current date
* {revno} - revision number
* {revision_id} - revision id
* {branch_nick} - branch nickname
* {clean} - 0 if the source tree contains uncommitted changes,
otherwise 1
bzr view [FILE...]¶
Options:--all Apply list or delete action to all
views.
--delete Delete the view.
--help, -h Show help message.
--name ARG Name of the view to define, list or
delete.
--quiet, -q Only display errors and warnings.
--switch ARG Name of the view to switch to.
--usage Show usage message and options.
--verbose, -v Display more information.
To define the current view:
bzr view file1 dir1 ...
To list the current view:
bzr view
To delete the current view:
bzr view --delete
To disable the current view without deleting it:
bzr view --switch off
To define a named view and switch to it:
bzr view --name view-name file1 dir1 ...
To list a named view:
bzr view --name view-name
To delete a named view:
bzr view --name view-name --delete
To switch to a named view:
bzr view --switch view-name
To list all views defined:
bzr view --all
To delete all views:
bzr view --delete --all
bzr whoami [NAME]¶
Options:--branch Set identity for the current branch
instead of globally.
--directory ARG, -d Branch to operate on, instead of working
directory.
--email Display email address only.
--help, -h Show help message.
--quiet, -q Only display errors and warnings.
--usage Show usage message and options.
--verbose, -v Display more information.
Show the email of the current user:
bzr whoami --email
Set the current user:
bzr whoami "Frank Chu <fchu@example.com>"
ENVIRONMENT¶
- BZRPATH
- Path where bzr is to look for shell plugin external commands.
- BZR_EMAIL
- E-Mail address of the user. Overrides EMAIL.
- E-Mail address of the user.
- BZR_EDITOR
- Editor for editing commit messages. Overrides EDITOR.
- EDITOR
- Editor for editing commit messages.
- BZR_PLUGIN_PATH
- Paths where bzr should look for plugins.
- BZR_DISABLE_PLUGINS
- Plugins that bzr should not load.
- BZR_PLUGINS_AT
- Plugins to load from a directory not in BZR_PLUGIN_PATH.
- BZR_HOME
- Directory holding .bazaar config dir. Overrides HOME.
- BZR_HOME (Win32)
- Directory holding bazaar config dir. Overrides APPDATA and HOME.
- BZR_REMOTE_PATH
- Full name of remote 'bzr' command (for bzr+ssh:// URLs).
- BZR_SSH
- Path to SSH client, or one of paramiko, openssh, sshcorp, plink or lsh.
- BZR_LOG
- Location of .bzr.log (use '/dev/null' to suppress log).
- BZR_LOG (Win32)
- Location of .bzr.log (use 'NUL' to suppress log).
- BZR_COLUMNS
- Override implicit terminal width.
- BZR_CONCURRENCY
- Number of processes that can be run concurrently (selftest)
- BZR_PROGRESS_BAR
- Override the progress display. Values are 'none' or 'text'.
- BZR_PDB
- Control whether to launch a debugger on error.
- BZR_SIGQUIT_PDB
- Control whether SIGQUIT behaves normally or invokes a breakin debugger.
- BZR_TEXTUI_INPUT
- Force console input mode for prompts to line-based (instead of char-based).
FILES¶
- ~/.bazaar/bazaar.conf
- Contains the user's default configuration. The section
[DEFAULT] is used to define general configuration that will be
applied everywhere. The section [ALIASES] can be used to create
command aliases for commonly used options.
SEE ALSO¶
http://bazaar.canonical.com/2012-06-22 | 2.6.0dev2 |