1brz(1) Breezy brz(1)
3
7 brz - Breezy next-generation distributed version control
8
10 brz command [ command_options ]
11 brz help
12 brz help command
13
15 Breezy (or brz) is a distributed version control system that is power‐
16 ful, friendly, and scalable. Breezy is a fork of the Bazaar version
17 control system.
18 Breezy keeps track of changes to software source code (or similar
20 information); lets you explore who changed it, when, and why; merges
21 concurrent changes; and helps people work together in a team.
22
24 brz add [FILE...]
25 Add specified files or directories.
26 brz alias [NAME]
28 Set/unset and display aliases.
29 brz annotate FILENAME
31 Show the origin of each line in a file.
32 brz bind [LOCATION]
34 Convert the current branch into a checkout of the supplied
35 branch.
36 brz bisect SUBCOMMAND [ARGS...]
38 Find an interesting commit using a binary search.
39 brz branch FROM_LOCATION [TO_LOCATION]
41 Create a new branch that is a copy of an existing branch.
42 brz branches [LOCATION]
44 List the branches available at the current location.
45 brz break-lock [LOCATION]
47 Break a dead lock.
48 brz cat FILENAME
50 Write the contents of a file as of a given revision to standard
51 output.
52 brz check [PATH]
54 Validate working tree structure, branch consistency and reposi‐
55 tory history.
56 brz checkout [BRANCH_LOCATION] [TO_LOCATION]
58 Create a new checkout of an existing branch.
59 brz clean-tree
61 Remove unwanted files from working tree.
62 brz commit [SELECTED...]
64 Commit changes into a new revision.
65 brz config [NAME]
67 Display, set or remove a configuration option.
68 brz conflicts
70 List files with conflicts.
71 brz cp [NAMES...]
73 Copy a file.
74 brz deleted
76 List files deleted in the working tree.
77 brz diff [FILE...]
79 Show differences in the working tree, between revisions or
80 branches.
81 brz export DEST [BRANCH_OR_SUBDIR]
83 Export current or past revision to a destination directory or
84 archive.
85 brz grep PATTERN [PATH...]
87 Print lines matching PATTERN for specified files and revisions.
88 brz help [TOPIC]
90 Show help on a command or other topic.
91 brz ignore [NAME_PATTERN...]
93 Ignore specified files or patterns.
94 brz ignored
96 List ignored files and the patterns that matched them.
97 brz import SOURCE [TREE]
99 Import sources from a directory, tarball or zip file
100 brz info [LOCATION]
102 Show information about a working tree, branch or repository.
103 brz init [LOCATION]
105 Make a directory into a versioned branch.
106 brz init-repository LOCATION
108 Create a shared repository for branches to share storage space.
109 brz join TREE
111 Combine a tree into its containing tree.
112 brz launchpad-login [NAME]
114 Show or set the Launchpad user ID.
115 brz launchpad-logout
117 Unset the Launchpad user ID.
118 brz launchpad-open [LOCATION]
120 Open a Launchpad branch page in your web browser.
121 brz link-tree LOCATION
123 Hardlink matching files to another tree.
124 brz log [FILE...]
126 Show historical log for a branch or subset of a branch.
127 brz lp-find-proposal
129 Find the proposal to merge this revision.
130 brz ls [PATH]
132 List files in a tree.
133 brz merge [LOCATION]
135 Perform a three-way merge.
136 brz missing [OTHER_BRANCH]
138 Show unmerged/unpulled revisions between two branches.
139 brz mkdir DIR...
141 Create a new versioned directory.
142 brz mv [NAMES...]
144 Move or rename a file.
145 brz nick [NICKNAME]
147 Print or set the branch nickname.
148 brz pack [BRANCH_OR_REPO]
150 Compress the data within a repository.
151 brz ping LOCATION
153 Pings a Bazaar smart server.
154 brz plugins
156 List the installed plugins.
157 brz pull [LOCATION]
159 Turn this branch into a mirror of another branch.
160 brz push [LOCATION]
162 Update a mirror of this branch.
163 brz reconcile [BRANCH]
165 Reconcile brz metadata in a branch.
166 brz reconfigure [LOCATION]
168 Reconfigure the type of a brz directory.
169 brz remerge [FILE...]
171 Redo a merge.
172 brz remove [FILE...]
174 Remove files or directories.
175 brz remove-branch [LOCATION]
177 Remove a branch.
178 brz remove-tree [LOCATION...]
180 Remove the working tree from a given branch/checkout.
181 brz renames [DIR]
183 Show list of renamed files.
184 brz resolve [FILE...]
186 Mark a conflict as resolved.
187 brz revert [FILE...]
189 Set files in the working tree back to the contents of a previous
190 revision.
191 brz revno [LOCATION]
193 Show current revision number.
194 brz root [FILENAME]
196 Show the tree root directory.
197 brz send [SUBMIT_BRANCH] [PUBLIC_BRANCH]
199 Mail or create a merge-directive for submitting changes.
200 brz serve
202 Run the brz server.
203 brz shelve [FILE...]
205 Temporarily set aside some changes from the current tree.
206 brz sign-my-commits [LOCATION] [COMMITTER]
208 Sign all commits by a given committer.
209 brz split TREE
211 Split a subdirectory of a tree into a separate tree.
212 brz status [FILE...]
214 Display status summary.
215 brz switch [TO_LOCATION]
217 Set the branch of a checkout and update.
218 brz tag [TAG_NAME]
220 Create, remove or modify a tag naming a revision.
221 brz tags
223 List tags.
224 brz testament [BRANCH]
226 Show testament (signing-form) of a revision.
227 brz unbind
229 Convert the current checkout into a regular branch.
230 brz uncommit [LOCATION]
232 Remove the last committed revision.
233 brz unshelve [SHELF_ID]
235 Restore shelved changes.
236 brz update [DIR]
238 Update a working tree to a new revision.
239 brz upgrade [URL]
241 Upgrade a repository, branch or working tree to a newer format.
242 brz verify-signatures [LOCATION]
244 Verify all commit signatures.
245 brz version
247 Show version of brz.
248 brz version-info [LOCATION]
250 Show version information about this tree.
251 brz view [FILE...]
253 Manage filtered views.
254 brz whoami [NAME]
256 Show or set brz user id.
257
259 brz --help
260 Alias for "help", see "brz help".
261 brz -?
263 Alias for "help", see "brz help".
264 brz -h
266 Alias for "help", see "brz help".
267 brz ?
269 Alias for "help", see "brz help".
270 brz add [FILE...]
272 Options:
273 --dry-run Show what would be done, but don't
274 actually do anything.
275 --file-ids-from ARG Lookup file ids from this tree.
276 --help, -h Show help message.
277 --no-recurse, -N Don't recursively add the contents of
278 directories.
279 --quiet, -q Only display errors and warnings.
280 --usage Show usage message and options.
281 --verbose, -v Display more information.
282 See also: ignore, remove
284 Add specified files or directories.
286 In non-recursive mode, all the named items are added, regardless of
288 whether they were previously ignored. A warning is given if any of the
289 named files are already versioned.
290 In recursive mode (the default), files are treated the same way but the
292 behaviour for directories is different. Directories that are already
293 versioned do not give a warning. All directories, whether already ver‐
294 sioned or not, are searched for files or subdirectories that are nei‐
295 ther versioned or ignored, and these are added. This search proceeds
296 recursively into versioned directories. If no names are given '.' is
297 assumed.
298 A warning will be printed when nested trees are encountered, unless
300 they are explicitly ignored.
301 Therefore simply saying 'brz add' will version all files that are cur‐
303 rently unknown.
304 Adding a file whose parent directory is not versioned will implicitly
306 add the parent, and so on up to the root. This means you should never
307 need to explicitly add a directory, they'll just get added when you add
308 a file in the directory.
309 --dry-run will show which files would be added, but not actually add
311 them.
312 --file-ids-from will try to use the file ids from the supplied path.
314 It looks up ids trying to find a matching parent directory with the
315 same filename, and then by pure path. This option is rarely needed but
316 can be useful when adding the same logical file into two branches that
317 will be merged later (without showing the two different adds as a con‐
318 flict). It is also useful when merging another project into a subdirec‐
319 tory of this one.
320 Any files matching patterns in the ignore list will not be added unless
322 they are explicitly mentioned.
323 In recursive mode, files larger than the configuration option add.maxi‐
325 mum_file_size will be skipped. Named items are never skipped due to
326 file size.
327 brz alias [NAME]
330 Options:
331 --help, -h Show help message.
332 --quiet, -q Only display errors and warnings.
333 --remove Remove the alias.
334 --usage Show usage message and options.
335 --verbose, -v Display more information.
336 Set/unset and display aliases.
338 Examples:
340 Show the current aliases:
341 brz alias
343 Show the alias specified for 'll':
345 brz alias ll
347 Set an alias for 'll':
349 brz alias ll="log --line -r-10..-1"
351 To remove an alias for 'll':
353 brz alias --remove ll
355 brz ann
358 Alias for "annotate", see "brz annotate".
359 brz annotate FILENAME
361 Options:
362 --all Show annotations on all lines.
363 --directory ARG, -d Branch to operate on, instead of working
364 directory.
365 --help, -h Show help message.
366 --long Show commit date in annotations.
367 --quiet, -q Only display errors and warnings.
368 --revision ARG, -r See "help revisionspec" for details.
369 --show-ids Show internal object ids.
370 --usage Show usage message and options.
371 --verbose, -v Display more information.
372 Aliases: ann, blame, praise
374 Show the origin of each line in a file.
376 This prints out the given file with an annotation on the left side
378 indicating which revision, author and date introduced the change.
379 If the origin is the same for a run of consecutive lines, it is shown
381 only at the top, unless the --all option is given.
382 brz bind [LOCATION]
385 Options:
386 --directory ARG, -d Branch to operate on, instead of working
387 directory.
388 --help, -h Show help message.
389 --quiet, -q Only display errors and warnings.
390 --usage Show usage message and options.
391 --verbose, -v Display more information.
392 See also: checkouts, unbind
394 Convert the current branch into a checkout of the supplied branch. If
396 no branch is supplied, rebind to the last bound location.
397 Once converted into a checkout, commits must succeed on the master
399 branch before they will be applied to the local branch.
400 Bound branches use the nickname of its master branch unless it is set
402 locally, in which case binding will update the local nickname to be
403 that of the master.
404 brz bisect SUBCOMMAND [ARGS...]
407 Options:
408 --directory ARG, -d Branch to operate on, instead of working
409 directory.
410 --help, -h Show help message.
411 --output ARG, -o Write log to this file.
412 --quiet, -q Only display errors and warnings.
413 --revision ARG, -r See "help revisionspec" for details.
414 --usage Show usage message and options.
415 --verbose, -v Display more information.
416 Find an interesting commit using a binary search.
418 Bisecting, in a nutshell, is a way to find the commit at which some
420 testable change was made, such as the introduction of a bug or feature.
421 By identifying a version which did not have the interesting change and
422 a later version which did, a developer can test for the presence of the
423 change at various points in the history, eventually ending up at the
424 precise commit when the change was first introduced.
425 This command uses subcommands to implement the search, each of which
427 changes the state of the bisection. The subcommands are:
428 brz bisect start
430 Start a bisect, possibly clearing out a previous bisect.
431 brz bisect yes [-r rev]
433 The specified revision (or the current revision, if not given)
434 has the characteristic we're looking for,
435 brz bisect no [-r rev]
437 The specified revision (or the current revision, if not given)
438 does not have the characteristic we're looking for,
439 brz bisect move -r rev
441 Switch to a different revision manually. Use if the bisect
442 algorithm chooses a revision that is not suitable. Try to
443 move as little as possible.
444 brz bisect reset
446 Clear out a bisection in progress.
447 brz bisect log [-o file]
449 Output a log of the current bisection to standard output, or
450 to the specified file.
451 brz bisect replay <logfile>
453 Replay a previously-saved bisect log, forgetting any bisection
454 that might be in progress.
455 brz bisect run <script>
457 Bisect automatically using <script> to determine 'yes' or 'no'.
458 <script> should exit with:
459 0 for yes
460 125 for unknown (like build failed so we could not test)
461 anything else for no
462 brz blame
465 Alias for "annotate", see "brz annotate".
466 brz branch FROM_LOCATION [TO_LOCATION]
468 Options:
469 --bind Bind new branch to from location.
470 --files-from ARG Get file contents from this tree.
471 --hardlink Hard-link working tree files where
472 possible.
473 --help, -h Show help message.
474 --no-tree Create a branch without a working-tree.
475 --quiet, -q Only display errors and warnings.
476 --revision ARG, -r See "help revisionspec" for details.
477 --stacked Create a stacked branch referring to the
478 source branch. The new branch will
479 depend on the availability of the source
480 branch for all operations.
481 --standalone Do not use a shared repository, even if
482 available.
483 --switch Switch the checkout in the current
484 directory to the new branch.
485 --usage Show usage message and options.
486 --use-existing-dir By default branch will fail if the
487 target directory exists, but does not
488 already have a control directory. This
489 flag will allow branch to proceed.
490 --verbose, -v Display more information.
491 See also: checkout
493 Create a new branch that is a copy of an existing branch.
495 If the TO_LOCATION is omitted, the last component of the FROM_LOCATION
497 will be used. In other words, "branch ../foo/bar" will attempt to cre‐
498 ate ./bar. If the FROM_LOCATION has no / or path separator embedded,
499 the TO_LOCATION is derived from the FROM_LOCATION by stripping a lead‐
500 ing scheme or drive identifier, if any. For example, "branch
501 lp:foo-bar" will attempt to create ./foo-bar.
502 To retrieve the branch as of a particular revision, supply the --revi‐
504 sion parameter, as in "branch foo/bar -r 5".
505 brz branches [LOCATION]
508 Options:
509 --help, -h Show help message.
510 --quiet, -q Only display errors and warnings.
511 --recursive, -R Recursively scan for branches rather
512 than just looking in the specified
513 location.
514 --usage Show usage message and options.
515 --verbose, -v Display more information.
516 List the branches available at the current location.
518 This command will print the names of all the branches at the current
520 location.
521 brz break-lock [LOCATION]
524 Options:
525 --config LOCATION is the directory where the
526 config lock is.
527 --force Do not ask for confirmation before
528 breaking the lock.
529 --help, -h Show help message.
530 --quiet, -q Only display errors and warnings.
531 --usage Show usage message and options.
532 --verbose, -v Display more information.
533 Break a dead lock.
535 This command breaks a lock on a repository, branch, working directory
537 or config file.
538 CAUTION: Locks should only be broken when you are sure that the process
540 holding the lock has been stopped.
541 You can get information on what locks are open via the 'brz info [loca‐
543 tion]' command.
544 Examples:
546 brz break-lock
547 brz break-lock brz+ssh://example.com/brz/foo
548 brz break-lock --conf ~/.config/breezy
549 brz cat FILENAME
552 Options:
553 --directory ARG, -d Branch to operate on, instead of working
554 directory.
555 --filters Apply content filters to display the
556 convenience form.
557 --help, -h Show help message.
558 --name-from-revision The path name in the old tree.
559 --quiet, -q Only display errors and warnings.
560 --revision ARG, -r See "help revisionspec" for details.
561 --usage Show usage message and options.
562 --verbose, -v Display more information.
563 See also: ls
565 Write the contents of a file as of a given revision to standard output.
567 If no revision is nominated, the last revision is used.
569 Note: Take care to redirect standard output when using this command on
571 a binary file.
572 brz check [PATH]
575 Options:
576 --branch Check the branch related to the current
577 directory.
578 --help, -h Show help message.
579 --quiet, -q Only display errors and warnings.
580 --repo Check the repository related to the
581 current directory.
582 --tree Check the working tree related to the
583 current directory.
584 --usage Show usage message and options.
585 --verbose, -v Display more information.
586 See also: reconcile
588 Validate working tree structure, branch consistency and repository his‐
590 tory.
591 This command checks various invariants about branch and repository
593 storage to detect data corruption or brz bugs.
594 The working tree and branch checks will only give output if a problem
596 is detected. The output fields of the repository check are:
597 revisions
599 This is just the number of revisions checked. It doesn't
600 indicate a problem.
601 versionedfiles
603 This is just the number of versionedfiles checked. It
604 doesn't indicate a problem.
605 unreferenced ancestors
607 Texts that are ancestors of other texts, but
608 are not properly referenced by the revision ancestry. This is a
609 subtle problem that Breezy can work around.
610 unique file texts
612 This is the total number of unique file contents
613 seen in the checked revisions. It does not indicate a problem.
614 repeated file texts
616 This is the total number of repeated texts seen
617 in the checked revisions. Texts can be repeated when their file
618 entries are modified, but the file contents are not. It does not
619 indicate a problem.
620 If no restrictions are specified, all data that is found at the given
622 location will be checked.
623 Examples:
625 Check the tree and branch at 'foo':
627 brz check --tree --branch foo
629 Check only the repository at 'bar':
631 brz check --repo bar
633 Check everything at 'baz':
635 brz check baz
637 brz checkin
640 Alias for "commit", see "brz commit".
641 brz checkout [BRANCH_LOCATION] [TO_LOCATION]
643 Options:
644 --files-from ARG Get file contents from this tree.
645 --hardlink Hard-link working tree files where
646 possible.
647 --help, -h Show help message.
648 --lightweight Perform a lightweight checkout.
649 Lightweight checkouts depend on access
650 to the branch for every operation.
651 Normal checkouts can perform common
652 operations like diff and status without
653 such access, and also support local
654 commits.
655 --quiet, -q Only display errors and warnings.
656 --revision ARG, -r See "help revisionspec" for details.
657 --usage Show usage message and options.
658 --verbose, -v Display more information.
659 Alias: co
661 See also: branch, checkouts, remove-tree, working-trees
663 Create a new checkout of an existing branch.
665 If BRANCH_LOCATION is omitted, checkout will reconstitute a working
667 tree for the branch found in '.'. This is useful if you have removed
668 the working tree or if it was never created - i.e. if you pushed the
669 branch to its current location using SFTP.
670 If the TO_LOCATION is omitted, the last component of the BRANCH_LOCA‐
672 TION will be used. In other words, "checkout ../foo/bar" will attempt
673 to create./bar. If the BRANCH_LOCATION has no / or path separator
674 embedded, the TO_LOCATION is derived from the BRANCH_LOCATION by strip‐
675 ping a leading scheme or drive identifier, if any. For example, "check‐
676 out lp:foo-bar" will attempt to create ./foo-bar.
677 To retrieve the branch as of a particular revision, supply the --revi‐
679 sion parameter, as in "checkout foo/bar -r 5". Note that this will be
680 immediately out of date [so you cannot commit] but it may be useful
681 (i.e. to examine old code.)
682 brz ci
685 Alias for "commit", see "brz commit".
686 brz clean-tree
688 Options:
689 --detritus Delete conflict files, merge and revert
690 backups, and failed selftest dirs.
691 --directory ARG, -d Branch to operate on, instead of working
692 directory.
693 --dry-run Show files to delete instead of deleting
694 them.
695 --force Do not prompt before deleting.
696 --help, -h Show help message.
697 --ignored Delete all ignored files.
698 --quiet, -q Only display errors and warnings.
699 --unknown Delete files unknown to brz (default).
700 --usage Show usage message and options.
701 --verbose, -v Display more information.
702 Remove unwanted files from working tree.
704 By default, only unknown files, not ignored files, are deleted. Ver‐
706 sioned files are never deleted.
707 Another class is 'detritus', which includes files emitted by brz during
709 normal operations and selftests. (The value of these files decreases
710 with time.)
711 If no options are specified, unknown files are deleted. Otherwise,
713 option flags are respected, and may be combined.
714 To check what clean-tree will do, use --dry-run.
716 brz co
719 Alias for "checkout", see "brz checkout".
720 brz commit [SELECTED...]
722 Options:
723 --author ARG Set the author's name, if it's different
724 from the committer.
725 --bugs ARG Link to a related bug. (see "brz help
726 bugs").
727 --commit-time ARG Manually set a commit time using commit
728 date format, e.g. '2009-10-10 08:00:00
729 +0100'.
730 --exclude ARG, -x Do not consider changes made to a given
731 path.
732 --file MSGFILE, -F Take commit message from this file.
733 --fixes ARG Mark a bug as being fixed by this
734 revision (see "brz help bugs").
735 --help, -h Show help message.
736 --local Perform a local commit in a bound
737 branch. Local commits are not pushed to
738 the master branch until a normal commit
739 is performed.
740 --lossy When committing to a foreign version
741 control system do not push data that can
742 not be natively represented.
743 --message ARG, -m Description of the new revision.
744 --quiet, -q Only display errors and warnings.
745 --show-diff, -p When no message is supplied, show the
746 diff along with the status summary in
747 the message editor.
748 --strict Refuse to commit if there are unknown
749 files in the working tree.
750 --unchanged Commit even if nothing has changed.
751 --usage Show usage message and options.
752 --verbose, -v Display more information.
753 Aliases: ci, checkin
755 See also: add, bugs, hooks, uncommit
757 Commit changes into a new revision.
759 An explanatory message needs to be given for each commit. This is often
761 done by using the --message option (getting the message from the com‐
762 mand line) or by using the --file option (getting the message from a
763 file). If neither of these options is given, an editor is opened for
764 the user to enter the message. To see the changed files in the boiler‐
765 plate text loaded into the editor, use the --show-diff option.
766 By default, the entire tree is committed and the person doing the com‐
768 mit is assumed to be the author. These defaults can be overridden as
769 explained below.
770 Selective commits:
772 If selected files are specified, only changes to those files are
774 committed. If a directory is specified then the directory and
775 everything within it is committed.
776 When excludes are given, they take precedence over selected files.
778 For example, to commit only changes within foo, but not changes
779 within foo/bar:
780 brz commit foo -x foo/bar
782 A selective commit after a merge is not yet supported.
784 Custom authors:
786 If the author of the change is not the same person as the committer,
788 you can specify the author's name using the --author option. The
789 name should be in the same format as a committer-id, e.g.
790 "John Doe <jdoe@example.com>". If there is more than one author of
791 the change you can specify the option multiple times, once for each
792 author.
793 Checks:
795 A common mistake is to forget to add a new file or directory before
797 running the commit command. The --strict option checks for unknown
798 files and aborts the commit if any are found. More advanced pre-com‐
799 mit
800 checks can be implemented by defining hooks. See \*(Aq\*(Aqbrz help
801 hooks\*(Aq\*(Aq
802 for details.
803 Things to note:
805 If you accidentally commit the wrong changes or make a spelling
807 mistake in the commit message say, you can use the uncommit command
808 to undo it. See \*(Aq\*(Aqbrz help uncommit\*(Aq\*(Aq for details.
809 Hooks can also be configured to run after a commit. This allows you
811 to trigger updates to external systems like bug trackers. The --fixes
812 option can be used to record the association between a revision and
813 one or more bugs. See \*(Aq\*(Aqbrz help bugs\*(Aq\*(Aq for details.
814 brz config [NAME]
817 Options:
818 --all Display all the defined values for the
819 matching options.
820 --directory ARG, -d Branch to operate on, instead of working
821 directory.
822 --help, -h Show help message.
823 --quiet, -q Only display errors and warnings.
824 --remove Remove the option from the configuration
825 file.
826 --scope ARG Reduce the scope to the specified
827 configuration file.
828 --usage Show usage message and options.
829 --verbose, -v Display more information.
830 See also: configuration
832 Display, set or remove a configuration option.
834 Display the active value for option NAME.
836 If --all is specified, NAME is interpreted as a regular expression and
838 all matching options are displayed mentioning their scope and without
839 resolving option references in the value). The active value that bzr
840 will take into account is the first one displayed for each option.
841 If NAME is not given, --all .* is implied (all options are displayed
843 for the current scope).
844 Setting a value is achieved by using NAME=value without spaces. The
846 value is set in the most relevant scope and can be checked by display‐
847 ing the option again.
848 Removing a value is achieved by using --remove NAME.
850 brz conflicts
853 Options:
854 --directory ARG, -d Branch to operate on, instead of working
855 directory.
856 --help, -h Show help message.
857 --quiet, -q Only display errors and warnings.
858 --text List paths of files with text conflicts.
859 --usage Show usage message and options.
860 --verbose, -v Display more information.
861 See also: conflict-types, resolve
863 List files with conflicts.
865 Merge will do its best to combine the changes in two branches, but
867 there are some kinds of problems only a human can fix. When it encoun‐
868 ters those, it will mark a conflict. A conflict means that you need to
869 fix something, before you can commit.
870 Conflicts normally are listed as short, human-readable messages. If
872 --text is supplied, the pathnames of files with text conflicts are
873 listed, instead. (This is useful for editing all files with text con‐
874 flicts.)
875 Use brz resolve when you have fixed a problem.
877 brz copy
880 Alias for "cp", see "brz cp".
881 brz cp [NAMES...]
883 Options:
884 --help, -h Show help message.
885 --quiet, -q Only display errors and warnings.
886 --usage Show usage message and options.
887 --verbose, -v Display more information.
888 Alias: copy
890 Copy a file.
892 Usage:
894 brz cp OLDNAME NEWNAME
895 brz cp SOURCE... DESTINATION
897 If the last argument is a versioned directory, all the other names are
899 copied into it. Otherwise, there must be exactly two arguments and the
900 file is copied to a new name.
901 Files cannot be copied between branches. Only files can be copied at
903 the moment.
904 brz del
907 Alias for "remove", see "brz remove".
908 brz deleted
910 Options:
911 --directory ARG, -d Branch to operate on, instead of working
912 directory.
913 --help, -h Show help message.
914 --quiet, -q Only display errors and warnings.
915 --show-ids Show internal object ids.
916 --usage Show usage message and options.
917 --verbose, -v Display more information.
918 See also: ls, status
920 List files deleted in the working tree.
922 brz di
926 Alias for "diff", see "brz diff".
927 brz dif
929 Alias for "diff", see "brz diff".
930 brz diff [FILE...]
932 Options:
933 --change ARG, -c Select changes introduced by the
934 specified revision. See also "help
935 revisionspec".
936 --context ARG How many lines of context to show.
937 --diff-options ARG Pass these options to the external diff
938 program.
939 --format ARG, -F Diff format to use.
940 --help, -h Show help message.
941 --new ARG Branch/tree to compare to.
942 --old ARG Branch/tree to compare from.
943 --prefix ARG, -p Set prefixes added to old and new
944 filenames, as two values separated by a
945 colon. (eg "old/:new/").
946 --quiet, -q Only display errors and warnings.
947 --revision ARG, -r See "help revisionspec" for details.
948 --usage Show usage message and options.
949 --using ARG Use this command to compare files.
950 --verbose, -v Display more information.
951 Aliases: di, dif
953 See also: status
955 Show differences in the working tree, between revisions or branches.
957 If no arguments are given, all changes for the current tree are listed.
959 If files are given, only the changes in those files are listed. Remote
960 and multiple branches can be compared by using the --old and --new
961 options. If not provided, the default for both is derived from the
962 first argument, if any, or the current tree if no arguments are given.
963 "brz diff -p1" is equivalent to "brz diff --prefix old/:new/", and pro‐
965 duces patches suitable for "patch -p1".
966 Note that when using the -r argument with a range of revisions, the
968 differences are computed between the two specified revisions. That is,
969 the command does not show the changes introduced by the first revision
970 in the range. This differs from the interpretation of revision ranges
971 used by "brz log" which includes the first revision in the range.
972 Exit values:
974 1 - changed
975 2 - unrepresentable changes
976 3 - error
977 0 - no change
978 Examples:
980 Shows the difference in the working tree versus the last commit:
981 brz diff
983 Difference between the working tree and revision 1:
985 brz diff -r1
987 Difference between revision 3 and revision 1:
989 brz diff -r1..3
991 Difference between revision 3 and revision 1 for branch xxx:
993 brz diff -r1..3 xxx
995 The changes introduced by revision 2 (equivalent to -r1..2):
997 brz diff -c2
999 To see the changes introduced by revision X:
1001 brz diff -cX
1003 Note that in the case of a merge, the -c option shows the changes
1005 compared to the left hand parent. To see the changes against
1006 another parent, use:
1007 brz diff -r<chosen_parent>..X
1009 The changes between the current revision and the previous revision
1011 (equivalent to -c-1 and -r-2..-1)
1012 brz diff -r-2..
1014 Show just the differences for file NEWS:
1016 brz diff NEWS
1018 Show the differences in working tree xxx for file NEWS:
1020 brz diff xxx/NEWS
1022 Show the differences from branch xxx to this working tree:
1024 brz diff --old xxx
1026 Show the differences between two branches for file NEWS:
1028 brz diff --old xxx --new yyy NEWS
1030 Same as 'brz diff' but prefix paths with old/ and new/:
1032 brz diff --prefix old/:new/
1034 Show the differences using a custom diff program with options:
1036 brz diff --using /usr/bin/diff --diff-options -wu
1038 brz export DEST [BRANCH_OR_SUBDIR]
1041 Options:
1042 --directory ARG, -d Branch to operate on, instead of working
1043 directory.
1044 --filters Apply content filters to export the
1045 convenient form.
1046 --format ARG Type of file to export to.
1047 --help, -h Show help message.
1048 --per-file-timestamps Set modification time of files to that
1049 of the last revision in which it was
1050 changed.
1051 --quiet, -q Only display errors and warnings.
1052 --revision ARG, -r See "help revisionspec" for details.
1053 --root ARG Name of the root directory inside the
1054 exported file.
1055 --uncommitted Export the working tree contents rather
1056 than that of the last revision.
1057 --usage Show usage message and options.
1058 --verbose, -v Display more information.
1059 Export current or past revision to a destination directory or archive.
1061 If no revision is specified this exports the last committed revision.
1063 Format may be an "exporter" name, such as tar, tgz, tbz2. If none is
1065 given, try to find the format with the extension. If no extension is
1066 found exports to a directory (equivalent to --format=dir).
1067 If root is supplied, it will be used as the root directory inside con‐
1069 tainer formats (tar, zip, etc). If it is not supplied it will default
1070 to the exported filename. The root option has no effect for 'dir' for‐
1071 mat.
1072 If branch is omitted then the branch containing the current working
1074 directory will be used.
1075 Note: Export of tree with non-ASCII filenames to zip is not supported.
1077 ================= =========================
1079 Supported formats Autodetected by extension
1080 ================= =========================
1081 dir (none)
1082 tar .tar
1083 tbz2 .tar.bz2, .tbz2
1084 tgz .tar.gz, .tgz
1085 zip .zip
1086 ================= =========================
1087 brz grep PATTERN [PATH...]
1090 Options:
1091 --color WHEN Show match in color. WHEN is never,
1092 always or auto.
1093 --diff, -p Grep for pattern in changeset for each
1094 revision.
1095 --exclude GLOB, -X Skip files whose base name matches GLOB.
1096 --files-with-matches, -l Print only the name of each input file
1097 in which PATTERN is found.
1098 --files-without-match, -L Print only the name of each input file
1099 in which PATTERN is not found.
1100 --fixed-string, -F Interpret PATTERN is a single fixed
1101 string (not regex).
1102 --from-root Search for pattern starting from the
1103 root of the branch. (implies
1104 --recursive)
1105 --help, -h Show help message.
1106 --ignore-case, -i Ignore case distinctions while matching.
1107 --include GLOB, -I Search only files whose base name
1108 matches GLOB.
1109 --levels N Number of levels to display - 0 for all,
1110 1 for collapsed (1 is default).
1111 --line-number, -n Show 1-based line number.
1112 --no-recursive Don't recurse into subdirectories.
1113 (default is --recursive)
1114 --null, -Z Write an ASCII NUL (\0) separator
1115 between output lines rather than a
1116 newline.
1117 --quiet, -q Only display errors and warnings.
1118 --revision ARG, -r See "help revisionspec" for details.
1119 --usage Show usage message and options.
1120 --verbose, -v Display more information.
1121 Print lines matching PATTERN for specified files and revisions.
1123 This command searches the specified files and revisions for a given
1125 pattern. The pattern is specified as a Python regular expressions[1].
1126 If the file name is not specified, the revisions starting with the cur‐
1128 rent directory are searched recursively. If the revision number is not
1129 specified, the working copy is searched. To search the last committed
1130 revision, use the '-r -1' or '-r last:1' option.
1131 Unversioned files are not searched unless explicitly specified on the
1133 command line. Unversioned directores are not searched.
1134 When searching a pattern, the output is shown in the 'filepath:string'
1136 format. If a revision is explicitly searched, the output is shown as
1137 'filepath~N:string', where N is the revision number.
1138 --include and --exclude options can be used to search only (or exclude
1140 from search) files with base name matches the specified Unix style GLOB
1141 pattern. The GLOB pattern an use *, ?, and [...] as wildcards, and \
1142 to quote wildcard or backslash character literally. Note that the glob
1143 pattern is not a regular expression.
1144 [1] http://docs.python.org/library/re.html#regular-expression-syntax
1146 brz help [TOPIC]
1149 Options:
1150 --help, -h Show help message.
1151 --long Show help on all commands.
1152 --quiet, -q Only display errors and warnings.
1153 --usage Show usage message and options.
1154 --verbose, -v Display more information.
1155 Aliases: ?, --help, -?, -h
1157 See also: topics
1159 Show help on a command or other topic.
1161 brz ignore [NAME_PATTERN...]
1165 Options:
1166 --default-rules Display the default ignore rules that
1167 brz uses.
1168 --directory ARG, -d Branch to operate on, instead of working
1169 directory.
1170 --help, -h Show help message.
1171 --quiet, -q Only display errors and warnings.
1172 --usage Show usage message and options.
1173 --verbose, -v Display more information.
1174 See also: ignored, patterns, status
1176 Ignore specified files or patterns.
1178 See \*(Aq\*(Aqbrz help patterns\*(Aq\*(Aq for details on the syntax of
1180 patterns.
1181 If a .bzrignore file does not exist, the ignore command will create one
1183 and add the specified files or patterns to the newly created file. The
1184 ignore command will also automatically add the.bzrignore file to be
1185 versioned. Creating a .bzrignore file without the use of the ignore
1186 command will require an explicit add command.
1187 To remove patterns from the ignore list, edit the .bzrignore file.
1189 After adding, editing or deleting that file either indirectly by using
1190 this command or directly by using an editor, be sure to commit it.
1191 Breezy also supports a global ignore file ~/.config/breezy/ignore. On
1193 Windows the global ignore file can be found in the application data
1194 directory as C:\Documents and Settings\<user>\Application
1195 Data\Breezy\3.0\ignore. Global ignores are not touched by this com‐
1196 mand. The global ignore file can be edited directly using an editor.
1197 Patterns prefixed with '!' are exceptions to ignore patterns and take
1199 precedence over regular ignores. Such exceptions are used to specify
1200 files that should be versioned which would otherwise be ignored.
1201 Patterns prefixed with '!!' act as regular ignore patterns, but have
1203 precedence over the '!' exception patterns.
1204 Notes:
1206 * Ignore patterns containing shell wildcards must be quoted from
1208 the shell on Unix.
1209 * Ignore patterns starting with "#" act as comments in the ignore file.
1211 To ignore patterns that begin with that character, use the "RE:" pre‐
1212 fix.
1213 Examples:
1215 Ignore the top level Makefile:
1216 brz ignore ./Makefile
1218 Ignore .class files in all directories...:
1220 brz ignore "*.class"
1222 ...but do not ignore "special.class":
1224 brz ignore "!special.class"
1226 Ignore files whose name begins with the "#" character:
1228 brz ignore "RE:^#"
1230 Ignore .o files under the lib directory:
1232 brz ignore "lib/**/*.o"
1234 Ignore .o files under the lib directory:
1236 brz ignore "RE:lib/.*\.o"
1238 Ignore everything but the "debian" toplevel directory:
1240 brz ignore "RE:(?!debian/).*"
1242 Ignore everything except the "local" toplevel directory,
1244 but always ignore autosave files ending in ~, even under local/:
1245 brz ignore "*"
1247 brz ignore "!./local"
1248 brz ignore "!!*~"
1249 brz ignored
1252 Options:
1253 --directory ARG, -d Branch to operate on, instead of working
1254 directory.
1255 --help, -h Show help message.
1256 --quiet, -q Only display errors and warnings.
1257 --usage Show usage message and options.
1258 --verbose, -v Display more information.
1259 See also: ignore, ls
1261 List ignored files and the patterns that matched them.
1263 List all the ignored files and the ignore pattern that caused the file
1265 to be ignored.
1266 Alternatively, to list just the files:
1268 brz ls --ignored
1270 brz import SOURCE [TREE]
1273 Options:
1274 --help, -h Show help message.
1275 --quiet, -q Only display errors and warnings.
1276 --usage Show usage message and options.
1277 --verbose, -v Display more information.
1278 Import sources from a directory, tarball or zip file
1280 This command will import a directory, tarball or zip file into a bzr
1282 tree, replacing any versioned files already present. If a directory is
1283 specified, it is used as the target. If the directory does not exist,
1284 or is not versioned, it is created.
1285 Tarballs may be gzip or bzip2 compressed. This is autodetected.
1287 If the tarball or zip has a single root directory, that directory is
1289 stripped when extracting the tarball. This is not done for directo‐
1290 ries.
1291 brz info [LOCATION]
1294 Options:
1295 --help, -h Show help message.
1296 --quiet, -q Only display errors and warnings.
1297 --usage Show usage message and options.
1298 --verbose, -v Display more information.
1299 See also: repositories, revno, working-trees
1301 Show information about a working tree, branch or repository.
1303 This command will show all known locations and formats associated to
1305 the tree, branch or repository.
1306 In verbose mode, statistical information is included with each report.
1308 To see extended statistic information, use a verbosity level of 2 or
1309 higher by specifying the verbose option multiple times, e.g. -vv.
1310 Branches and working trees will also report any missing revisions.
1312 Examples:
1314 Display information on the format and related locations:
1316 brz info
1318 Display the above together with extended format information and
1320 basic statistics (like the number of files in the working tree and
1321 number of revisions in the branch and repository):
1322 brz info -v
1324 Display the above together with number of committers to the branch:
1326 brz info -vv
1328 brz init [LOCATION]
1331 Options:
1332 --append-revisions-only Never change revnos or the existing log.
1333 Append revisions to it only.
1334 --create-prefix Create the path leading up to the branch
1335 if it does not already exist.
1336 --format ARG Specify a format for this branch. See
1337 "help formats" for a full list.
1338 --2a Format for the bzr 2.0 series.
1339 --bzr Format for the bzr 2.0 series.
1340 --default Format for the bzr 2.0 series.
1341 --git GIT repository.
1342 --git-bare Bare GIT repository (no working tree).
1343 --help, -h Show help message.
1344 --no-tree Create a branch without a working tree.
1345 --quiet, -q Only display errors and warnings.
1346 --usage Show usage message and options.
1347 --verbose, -v Display more information.
1348 See also: branch, checkout, init-repository
1350 Make a directory into a versioned branch.
1352 Use this to create an empty branch, or before importing an existing
1354 project.
1355 If there is a repository in a parent directory of the location, then
1357 the history of the branch will be stored in the repository. Otherwise
1358 init creates a standalone branch which carries its own history in the
1359 .bzr directory.
1360 If there is already a branch at the location but it has no working
1362 tree, the tree can be populated with 'brz checkout'.
1363 Recipe for importing a tree of files:
1365 cd ~/project
1367 brz init
1368 brz add .
1369 brz status
1370 brz commit -m "imported project"
1371 brz init-repo
1374 Alias for "init-repository", see "brz init-repository".
1375 brz init-repository LOCATION
1377 Options:
1378 --format ARG Specify a format for this repository.
1379 See "brz help formats" for details.
1380 --2a Format for the bzr 2.0 series.
1381 --bzr Format for the bzr 2.0 series.
1382 --default Format for the bzr 2.0 series.
1383 --git GIT repository.
1384 --git-bare Bare GIT repository (no working tree).
1385 --help, -h Show help message.
1386 --no-trees Branches in the repository will default
1387 to not having a working tree.
1388 --quiet, -q Only display errors and warnings.
1389 --usage Show usage message and options.
1390 --verbose, -v Display more information.
1391 Alias: init-repo
1393 See also: branch, checkout, init, repositories
1395 Create a shared repository for branches to share storage space.
1397 New branches created under the repository directory will store their
1399 revisions in the repository, not in the branch directory. For branches
1400 with shared history, this reduces the amount of storage needed and
1401 speeds up the creation of new branches.
1402 If the --no-trees option is given then the branches in the repository
1404 will not have working trees by default. They will still exist as
1405 directories on disk, but they will not have separate copies of the
1406 files at a certain revision. This can be useful for repositories that
1407 store branches which are interacted with through checkouts or remote
1408 branches, such as on a server.
1409 Examples:
1411 Create a shared repository holding just branches:
1412 brz init-repo --no-trees repo
1414 brz init repo/trunk
1415 Make a lightweight checkout elsewhere:
1417 brz checkout --lightweight repo/trunk trunk-checkout
1419 cd trunk-checkout
1420 (add files here)
1421 brz join TREE
1424 Options:
1425 --help, -h Show help message.
1426 --quiet, -q Only display errors and warnings.
1427 --usage Show usage message and options.
1428 --verbose, -v Display more information.
1429 See also: split
1431 Combine a tree into its containing tree.
1433 This command requires the target tree to be in a rich-root format.
1435 The TREE argument should be an independent tree, inside another tree,
1437 but not part of it. (Such trees can be produced by "brz split", but
1438 also by running "brz branch" with the target inside a tree.)
1439 The result is a combined tree, with the subtree no longer an indepen‐
1441 dent part. This is marked as a merge of the subtree into the contain‐
1442 ing tree, and all history is preserved.
1443 brz launchpad-login [NAME]
1446 Options:
1447 --help, -h Show help message.
1448 --no-check Don't check that the user name is valid.
1449 --quiet, -q Only display errors and warnings.
1450 --usage Show usage message and options.
1451 --verbose, -v Display more information.
1452 Alias: lp-login
1454 Show or set the Launchpad user ID.
1456 When communicating with Launchpad, some commands need to know your
1458 Launchpad user ID. This command can be used to set or show the user ID
1459 that Bazaar will use for such communication.
1460 Examples:
1462 Show the Launchpad ID of the current user:
1463 brz launchpad-login
1465 Set the Launchpad ID of the current user to 'bob':
1467 brz launchpad-login bob
1469 brz launchpad-logout
1472 Options:
1473 --help, -h Show help message.
1474 --quiet, -q Only display errors and warnings.
1475 --usage Show usage message and options.
1476 --verbose, -v Display more information.
1477 Alias: lp-logout
1479 Unset the Launchpad user ID.
1481 When communicating with Launchpad, some commands need to know your
1483 Launchpad user ID. This command will log you out from Launchpad. This
1484 means that communication with Launchpad will happen over HTTPS, and
1485 will not require one of your SSH keys to be available.
1486 brz launchpad-open [LOCATION]
1489 Options:
1490 --dry-run Do not actually open the browser. Just
1491 say the URL we would use.
1492 --help, -h Show help message.
1493 --quiet, -q Only display errors and warnings.
1494 --usage Show usage message and options.
1495 --verbose, -v Display more information.
1496 Alias: lp-open
1498 Open a Launchpad branch page in your web browser.
1500 brz link-tree LOCATION
1503 Options:
1504 --help, -h Show help message.
1505 --quiet, -q Only display errors and warnings.
1506 --usage Show usage message and options.
1507 --verbose, -v Display more information.
1508 Hardlink matching files to another tree.
1510 Only files with identical content and execute bit will be linked.
1512 brz log [FILE...]
1515 Options:
1516 --authors ARG What names to list as authors - first,
1517 all or committer.
1518 --change ARG, -c Show just the specified revision. See
1519 also "help revisionspec".
1520 --exclude-common-ancestry Display only the revisions that are not
1521 part of both ancestries (require
1522 -rX..Y).
1523 --forward Show from oldest to newest.
1524 --help, -h Show help message.
1525 --include-merged Show merged revisions like --levels 0
1526 does.
1527 --levels N, -n Number of levels to display - 0 for all,
1528 1 for flat.
1529 --limit N, -l Limit the output to the first N
1530 revisions.
1531 --log-format ARG Use specified log format.
1532 --gnu-changelog Format used by GNU ChangeLog files.
1533 --line Log format with one line per revision.
1534 --long Detailed log format.
1535 --short Moderately short log format.
1536 --match ARG, -m Show revisions whose properties match
1537 this expression.
1538 --match-author ARG Show revisions whose authors match this
1539 expression.
1540 --match-bugs ARG Show revisions whose bugs match this
1541 expression.
1542 --match-committer ARG Show revisions whose committer matches
1543 this expression.
1544 --match-message ARG Show revisions whose message matches
1545 this expression.
1546 --omit-merges Do not report commits with more than one
1547 parent.
1548 --quiet, -q Only display errors and warnings.
1549 --revision ARG, -r See "help revisionspec" for details.
1550 --show-diff, -p Show changes made in each revision as a
1551 patch.
1552 --show-ids Show internal object ids.
1553 --signatures Show digital signature validity.
1554 --timezone ARG Display timezone as local, original, or
1555 utc.
1556 --usage Show usage message and options.
1557 --verbose, -v Show files changed in each revision.
1558 See also: log-formats, revisionspec
1560 Show historical log for a branch or subset of a branch.
1562 log is brz's default tool for exploring the history of a branch. The
1564 branch to use is taken from the first parameter. If no parameters are
1565 given, the branch containing the working directory is logged. Here are
1566 some simple examples:
1567 brz log log the current branch
1569 brz log foo.py log a file in its branch
1570 brz log http://server/branch log a branch on a server
1571 The filtering, ordering and information shown for each revision can be
1573 controlled as explained below. By default, all revisions are shown
1574 sorted (topologically) so that newer revisions appear before older ones
1575 and descendants always appear before ancestors. If displayed, merged
1576 revisions are shown indented under the revision in which they were
1577 merged.
1578 Output control:
1580 The log format controls how information about each revision is
1582 displayed. The standard log formats are called
1583 \*(Aq\*(Aqlong\*(Aq\*(Aq, \*(Aq\*(Aqshort\*(Aq\*(Aq
1584 and \*(Aq\*(Aqline\*(Aq\*(Aq. The default is long. See \*(Aq\*(Aqbrz
1585 help log-formats\*(Aq\*(Aq
1586 for more details on log formats.
1587 The following options can be used to control what information is
1589 displayed:
1590 -l N display a maximum of N revisions
1592 -n N display N levels of revisions (0 for all, 1 for col‐
1593 lapsed)
1594 -v display a status summary (delta) for each revision
1595 -p display a diff (patch) for each revision
1596 --show-ids display revision-ids (and file-ids), not just revnos
1597 Note that the default number of levels to display is a function of
1599 the
1600 log format. If the -n option is not used, the standard log formats
1601 show
1602 just the top level (mainline).
1603 Status summaries are shown using status flags like A, M, etc. To see
1605 the changes explained using words like \*(Aq\*(Aqadded\*(Aq\*(Aq and
1606 \*(Aq\*(Aqmodified\*(Aq\*(Aq
1607 instead, use the -vv option.
1608 Ordering control:
1610 To display revisions from oldest to newest, use the --forward option.
1612 In most cases, using this option will have little impact on the total
1613 time taken to produce a log, though --forward does not incrementally
1614 display revisions like --reverse does when it can.
1615 Revision filtering:
1617 The -r option can be used to specify what revision or range of revi‐
1619 sions
1620 to filter against. The various forms are shown below:
1621 -rX display revision X
1623 -rX.. display revision X and later
1624 -r..Y display up to and including revision Y
1625 -rX..Y display from X to Y inclusive
1626 See \*(Aq\*(Aqbrz help revisionspec\*(Aq\*(Aq for details on how to
1628 specify X and Y.
1629 Some common examples are given below:
1630 -r-1 show just the tip
1632 -r-10.. show the last 10 mainline revisions
1633 -rsubmit:.. show what's new on this branch
1634 -rancestor:path.. show changes since the common ancestor of this
1635 branch and the one at location path
1636 -rdate:yesterday.. show changes since yesterday
1637 When logging a range of revisions using -rX..Y, log starts at
1639 revision Y and searches back in history through the primary
1640 ("left-hand") parents until it finds X. When logging just the
1641 top level (using -n1), an error is reported if X is not found
1642 along the way. If multi-level logging is used (-n0), X may be
1643 a nested merge revision and the log will be truncated accordingly.
1644 Path filtering:
1646 If parameters are given and the first one is not a branch, the log
1648 will be filtered to show only those revisions that changed the
1649 nominated files or directories.
1650 Filenames are interpreted within their historical context. To log a
1652 deleted file, specify a revision range so that the file existed at
1653 the end or start of the range.
1654 Historical context is also important when interpreting pathnames of
1656 renamed files/directories. Consider the following example:
1657 * revision 1: add tutorial.txt
1659 * revision 2: modify tutorial.txt
1660 * revision 3: rename tutorial.txt to guide.txt; add tutorial.txt
1661 In this case:
1663 * \*(Aq\*(Aqbrz log guide.txt\*(Aq\*(Aq will log the file added in
1665 revision 1
1666 * \*(Aq\*(Aqbrz log tutorial.txt\*(Aq\*(Aq will log the new file
1668 added in revision 3
1669 * \*(Aq\*(Aqbrz log -r2 -p tutorial.txt\*(Aq\*(Aq will show the
1671 changes made to
1672 the original file in revision 2.
1673 * \*(Aq\*(Aqbrz log -r2 -p guide.txt\*(Aq\*(Aq will display an error
1675 message as there
1676 was no file called guide.txt in revision 2.
1677 Renames are always followed by log. By design, there is no need to
1679 explicitly ask for this (and no way to stop logging a file back
1680 until it was last renamed).
1681 Other filtering:
1683 The --match option can be used for finding revisions that match a
1685 regular expression in a commit message, committer, author or bug.
1686 Specifying the option several times will match any of the supplied
1687 expressions. --match-author, --match-bugs, --match-committer and
1688 --match-message can be used to only match a specific field.
1689 Tips & tricks:
1691 GUI tools and IDEs are often better at exploring history than command
1693 line tools: you may prefer qlog or viz from qbzr or bzr-gtk, the
1694 bzr-explorer shell, or the Loggerhead web interface. See the Bazaar
1695 Plugin Guide <http://doc.bazaar.canonical.com/plugins/en/> and
1696 <http://wiki.bazaar.canonical.com/IDEIntegration>.
1697 You may find it useful to add the aliases below to
1699 \*(Aq\*(Aqbreezy.conf\*(Aq\*(Aq:
1700 [ALIASES]
1702 tip = log -r-1
1703 top = log -l10 --line
1704 show = log -v -p
1705 \*(Aq\*(Aqbrz tip\*(Aq\*(Aq will then show the latest revision while
1707 \*(Aq\*(Aqbrz top\*(Aq\*(Aq
1708 will show the last 10 mainline revisions. To see the details of a
1709 particular revision X, \*(Aq\*(Aqbrz show -rX\*(Aq\*(Aq.
1710 If you are interested in looking deeper into a particular merge X,
1712 use \*(Aq\*(Aqbrz log -n0 -rX\*(Aq\*(Aq.
1713 \*(Aq\*(Aqbrz log -v\*(Aq\*(Aq on a branch with lots of history is
1715 currently
1716 very slow. A fix for this issue is currently under development.
1717 With or without that fix, it is recommended that a revision range
1718 be given when using the -v option.
1719 brz has a generic full-text matching plugin, brz-search, that can be
1721 used to find revisions matching user names, commit messages, etc.
1722 Among other features, this plugin can find all revisions containing
1723 a list of words but not others.
1724 When exploring non-mainline history on large projects with deep
1726 history, the performance of log can be greatly improved by installing
1727 the historycache plugin. This plugin buffers historical information
1728 trading disk space for faster speed.
1729 brz lp-find-proposal
1732 Options:
1733 --help, -h Show help message.
1734 --quiet, -q Only display errors and warnings.
1735 --revision ARG, -r See "help revisionspec" for details.
1736 --usage Show usage message and options.
1737 --verbose, -v Display more information.
1738 Find the proposal to merge this revision.
1740 Finds the merge proposal(s) that discussed landing the specified revi‐
1742 sion. This works only if the if the merged_revno was recorded for the
1743 merge proposal. The proposal(s) are opened in a web browser.
1744 Only the revision specified is searched for. To find the mainline
1746 revision that merged it into mainline, use the "mainline" revision
1747 spec.
1748 So, to find the merge proposal that reviewed line 1 of README:
1750 brz lp-find-proposal -r mainline:annotate:README:1
1752 brz lp-login
1755 Alias for "launchpad-login", see "brz launchpad-login".
1756 brz lp-logout
1758 Alias for "launchpad-logout", see "brz launchpad-logout".
1759 brz lp-open
1761 Alias for "launchpad-open", see "brz launchpad-open".
1762 brz ls [PATH]
1764 Options:
1765 --directory ARG, -d Branch to operate on, instead of working
1766 directory.
1767 --from-root Print paths relative to the root of the
1768 branch.
1769 --help, -h Show help message.
1770 --ignored, -i Print ignored files.
1771 --kind ARG, -k List entries of a particular kind: file,
1772 directory, symlink, tree-reference.
1773 --null, -0 Use an ASCII NUL (\0) separator rather
1774 than a newline.
1775 --quiet, -q Only display errors and warnings.
1776 --recursive, -R Recurse into subdirectories.
1777 --revision ARG, -r See "help revisionspec" for details.
1778 --show-ids Show internal object ids.
1779 --unknown, -u Print unknown files.
1780 --usage Show usage message and options.
1781 --verbose, -v Display more information.
1782 --versioned, -V Print versioned files.
1783 See also: cat, status
1785 List files in a tree.
1787 brz merge [LOCATION]
1791 Options:
1792 --change ARG, -c Select changes introduced by the
1793 specified revision. See also "help
1794 revisionspec".
1795 --directory ARG, -d Branch to merge into, rather than the
1796 one containing the working directory.
1797 --force Merge even if the destination tree has
1798 uncommitted changes.
1799 --help, -h Show help message.
1800 --interactive, -i Select changes interactively.
1801 --merge-type ARG Select a particular merge algorithm.
1802 --diff3 Merge using external diff3.
1803 --lca LCA-newness merge.
1804 --merge3 Native diff3-style merge.
1805 --weave Weave-based merge.
1806 --preview Instead of merging, show a diff of the
1807 merge.
1808 --pull If the destination is already completely
1809 merged into the source, pull from the
1810 source rather than merging. When this
1811 happens, you do not need to commit the
1812 result.
1813 --quiet, -q Only display errors and warnings.
1814 --remember Remember the specified location as a
1815 default.
1816 --reprocess Reprocess to reduce spurious conflicts.
1817 --revision ARG, -r See "help revisionspec" for details.
1818 --show-base Show base revision text in conflicts.
1819 --uncommitted Apply uncommitted changes from a working
1820 copy, instead of branch changes.
1821 --usage Show usage message and options.
1822 --verbose, -v Display more information.
1823 See also: remerge, send, status-flags, update
1825 Perform a three-way merge.
1827 The source of the merge can be specified either in the form of a
1829 branch, or in the form of a path to a file containing a merge directive
1830 generated with brz send. If neither is specified, the default is the
1831 upstream branch or the branch most recently merged using --remember.
1832 The source of the merge may also be specified in the form of a path to
1833 a file in another branch: in this case, only the modifications to that
1834 file are merged into the current working tree.
1835 When merging from a branch, by default brz will try to merge in all new
1837 work from the other branch, automatically determining an appropriate
1838 base revision. If this fails, you may need to give an explicit base.
1839 To pick a different ending revision, pass "--revision OTHER". brz will
1841 try to merge in all new work up to and including revision OTHER.
1842 If you specify two values, "--revision BASE..OTHER", only revisions
1844 BASE through OTHER, excluding BASE but including OTHER, will be merged.
1845 If this causes some revisions to be skipped, i.e. if the destination
1846 branch does not already contain revision BASE, such a merge is commonly
1847 referred to as a "cherrypick". Unlike a normal merge, Breezy does not
1848 currently track cherrypicks. The changes look like a normal commit, and
1849 the history of the changes from the other branch is not stored in the
1850 commit.
1851 Revision numbers are always relative to the source branch.
1853 Merge will do its best to combine the changes in two branches, but
1855 there are some kinds of problems only a human can fix. When it encoun‐
1856 ters those, it will mark a conflict. A conflict means that you need to
1857 fix something, before you can commit.
1858 Use brz resolve when you have fixed a problem. See also brz conflicts.
1860 If there is no default branch set, the first merge will set it (use
1862 --no-remember to avoid setting it). After that, you can omit the branch
1863 to use the default. To change the default, use --remember. The value
1864 will only be saved if the remote location can be accessed.
1865 The results of the merge are placed into the destination working direc‐
1867 tory, where they can be reviewed (with brz diff), tested, and then com‐
1868 mitted to record the result of the merge.
1869 merge refuses to run if there are any uncommitted changes, unless
1871 --force is given. If --force is given, then the changes from the
1872 source will be merged with the current working tree, including any
1873 uncommitted changes in the tree. The --force option can also be used
1874 to create a merge revision which has more than two parents.
1875 If one would like to merge changes from the working tree of the other
1877 branch without merging any committed revisions, the --uncommitted
1878 option can be given.
1879 To select only some changes to merge, use "merge -i", which will prompt
1881 you to apply each diff hunk and file change, similar to "shelve".
1882 Examples:
1884 To merge all new revisions from brz.dev:
1885 brz merge ../brz.dev
1887 To merge changes up to and including revision 82 from brz.dev:
1889 brz merge -r 82 ../brz.dev
1891 To merge the changes introduced by 82, without previous changes:
1893 brz merge -r 81..82 ../brz.dev
1895 To apply a merge directive contained in /tmp/merge:
1897 brz merge /tmp/merge
1899 To create a merge revision with three parents from two branches
1901 feature1a and feature1b:
1902 brz merge ../feature1a
1904 brz merge ../feature1b --force
1905 brz commit -m 'revision with three parents'
1906 brz missing [OTHER_BRANCH]
1909 Options:
1910 --directory ARG, -d Branch to operate on, instead of working
1911 directory.
1912 --help, -h Show help message.
1913 --include-merged Show all revisions in addition to the
1914 mainline ones.
1915 --log-format ARG Use specified log format.
1916 --gnu-changelog Format used by GNU ChangeLog files.
1917 --line Log format with one line per revision.
1918 --long Detailed log format.
1919 --short Moderately short log format.
1920 --mine-only Display changes in the local branch
1921 only.
1922 --my-revision ARG Filter on local branch revisions
1923 (inclusive). See "help revisionspec" for
1924 details.
1925 --other Same as --theirs-only.
1926 --quiet, -q Only display errors and warnings.
1927 --reverse Reverse the order of revisions.
1928 --revision ARG, -r Filter on other branch revisions
1929 (inclusive). See "help revisionspec" for
1930 details.
1931 --show-ids Show internal object ids.
1932 --theirs-only Display changes in the remote branch
1933 only.
1934 --this Same as --mine-only.
1935 --usage Show usage message and options.
1936 --verbose, -v Display more information.
1937 See also: merge, pull
1939 Show unmerged/unpulled revisions between two branches.
1941 OTHER_BRANCH may be local or remote.
1943 To filter on a range of revisions, you can use the command -r
1945 begin..end -r revision requests a specific revision, -r ..end or -r
1946 begin.. are also valid.
1947 Exit values:
1949 1 - some missing revisions
1950 0 - no missing revisions
1951 Examples:
1953 Determine the missing revisions between this and the branch at the
1955 remembered pull location:
1956 brz missing
1958 Determine the missing revisions between this and another branch:
1960 brz missing http://server/branch
1962 Determine the missing revisions up to a specific revision on the
1964 other
1965 branch:
1966 brz missing -r ..-10
1968 Determine the missing revisions up to a specific revision on this
1970 branch:
1971 brz missing --my-revision ..-10
1973 brz mkdir DIR...
1976 Options:
1977 --help, -h Show help message.
1978 --parents, -p No error if existing, make parent
1979 directories as needed.
1980 --quiet, -q Only display errors and warnings.
1981 --usage Show usage message and options.
1982 --verbose, -v Display more information.
1983 Create a new versioned directory.
1985 This is equivalent to creating the directory and then adding it.
1987 brz move
1990 Alias for "mv", see "brz mv".
1991 brz mv [NAMES...]
1993 Options:
1994 --after Move only the brz identifier of the
1995 file, because the file has already been
1996 moved.
1997 --auto Automatically guess renames.
1998 --dry-run Avoid making changes when guessing
1999 renames.
2000 --help, -h Show help message.
2001 --quiet, -q Only display errors and warnings.
2002 --usage Show usage message and options.
2003 --verbose, -v Display more information.
2004 Aliases: move, rename
2006 Move or rename a file.
2008 Usage:
2010 brz mv OLDNAME NEWNAME
2011 brz mv SOURCE... DESTINATION
2013 If the last argument is a versioned directory, all the other names are
2015 moved into it. Otherwise, there must be exactly two arguments and the
2016 file is changed to a new name.
2017 If OLDNAME does not exist on the filesystem but is versioned and NEW‐
2019 NAME does exist on the filesystem but is not versioned, mv assumes that
2020 the file has been manually moved and only updates its internal inven‐
2021 tory to reflect that change. The same is valid when moving many SOURCE
2022 files to a DESTINATION.
2023 Files cannot be moved between branches.
2025 brz nick [NICKNAME]
2028 Options:
2029 --directory ARG, -d Branch to operate on, instead of working
2030 directory.
2031 --help, -h Show help message.
2032 --quiet, -q Only display errors and warnings.
2033 --usage Show usage message and options.
2034 --verbose, -v Display more information.
2035 See also: info
2037 Print or set the branch nickname.
2039 If unset, the colocated branch name is used for colocated branches, and
2041 the branch directory name is used for other branches. To print the
2042 current nickname, execute with no argument.
2043 Bound branches use the nickname of its master branch unless it is set
2045 locally.
2046 brz pack [BRANCH_OR_REPO]
2049 Options:
2050 --clean-obsolete-packs Delete obsolete packs to save disk
2051 space.
2052 --help, -h Show help message.
2053 --quiet, -q Only display errors and warnings.
2054 --usage Show usage message and options.
2055 --verbose, -v Display more information.
2056 See also: repositories
2058 Compress the data within a repository.
2060 This operation compresses the data within a bazaar repository. As
2062 bazaar supports automatic packing of repository, this operation is nor‐
2063 mally not required to be done manually.
2064 During the pack operation, bazaar takes a backup of existing repository
2066 data, i.e. pack files. This backup is eventually removed by bazaar
2067 automatically when it is safe to do so. To save disk space by removing
2068 the backed up pack files, the --clean-obsolete-packs option may be
2069 used.
2070 Warning: If you use --clean-obsolete-packs and your machine crashes
2072 during or immediately after repacking, you may be left with a state
2073 where the deletion has been written to disk but the new packs have not
2074 been. In this case the repository may be unusable.
2075 brz ping LOCATION
2078 Options:
2079 --help, -h Show help message.
2080 --quiet, -q Only display errors and warnings.
2081 --usage Show usage message and options.
2082 --verbose, -v Display more information.
2083 Pings a Bazaar smart server.
2085 This command sends a 'hello' request to the given location using the
2087 brz smart protocol, and reports the response.
2088 brz plugins
2091 Options:
2092 --help, -h Show help message.
2093 --quiet, -q Only display errors and warnings.
2094 --usage Show usage message and options.
2095 --verbose, -v Display more information.
2096 List the installed plugins.
2098 This command displays the list of installed plugins including version
2100 of plugin and a short description of each.
2101 --verbose shows the path where each plugin is located.
2103 A plugin is an external component for Breezy that extends the revision
2105 control system, by adding or replacing code in Breezy. Plugins can do
2106 a variety of things, including overriding commands, adding new com‐
2107 mands, providing additional network transports and customizing log out‐
2108 put.
2109 See the Bazaar Plugin Guide <http://doc.bazaar.canonical.com/plug‐
2111 ins/en/> for further information on plugins including where to find
2112 them and how to install them. Instructions are also provided there on
2113 how to write new plugins using the Python programming language.
2114 brz praise
2117 Alias for "annotate", see "brz annotate".
2118 brz pull [LOCATION]
2120 Options:
2121 --directory ARG, -d Branch to pull into, rather than the one
2122 containing the working directory.
2123 --help, -h Show help message.
2124 --local Perform a local pull in a bound branch.
2125 Local pulls are not applied to the
2126 master branch.
2127 --overwrite Ignore differences between branches and
2128 overwrite unconditionally.
2129 --overwrite-tags Overwrite tags only.
2130 --quiet, -q Only display errors and warnings.
2131 --remember Remember the specified location as a
2132 default.
2133 --revision ARG, -r See "help revisionspec" for details.
2134 --show-base Show base revision text in conflicts.
2135 --usage Show usage message and options.
2136 --verbose, -v Show logs of pulled revisions.
2137 See also: push, send, status-flags, update
2139 Turn this branch into a mirror of another branch.
2141 By default, this command only works on branches that have not diverged.
2143 Branches are considered diverged if the destination branch's most
2144 recent commit is one that has not been merged (directly or indirectly)
2145 into the parent.
2146 If branches have diverged, you can use 'brz merge' to integrate the
2148 changes from one into the other. Once one branch has merged, the other
2149 should be able to pull it again.
2150 If you want to replace your local changes and just want your branch to
2152 match the remote one, use pull --overwrite. This will work even if the
2153 two branches have diverged.
2154 If there is no default location set, the first pull will set it (use
2156 --no-remember to avoid setting it). After that, you can omit the loca‐
2157 tion to use the default. To change the default, use --remember. The
2158 value will only be saved if the remote location can be accessed.
2159 The --verbose option will display the revisions pulled using the
2161 log_format configuration option. You can use a different format by
2162 overriding it with -Olog_format=<other_format>.
2163 Note: The location can be specified either in the form of a branch, or
2165 in the form of a path to a file containing a merge directive generated
2166 with brz send.
2167 brz push [LOCATION]
2170 Options:
2171 --create-prefix Create the path leading up to the branch
2172 if it does not already exist.
2173 --directory ARG, -d Branch to push from, rather than the one
2174 containing the working directory.
2175 --help, -h Show help message.
2176 --lossy Allow lossy push, i.e. dropping metadata
2177 that can't be represented in the target.
2178 --no-tree Don't populate the working tree, even
2179 for protocols that support it.
2180 --overwrite Ignore differences between branches and
2181 overwrite unconditionally.
2182 --overwrite-tags Overwrite tags only.
2183 --quiet, -q Only display errors and warnings.
2184 --remember Remember the specified location as a
2185 default.
2186 --revision ARG, -r See "help revisionspec" for details.
2187 --stacked Create a stacked branch that references
2188 the public location of the parent
2189 branch.
2190 --stacked-on ARG Create a stacked branch that refers to
2191 another branch for the commit history.
2192 Only the work not present in the
2193 referenced branch is included in the
2194 branch created.
2195 --strict Refuse to push if there are uncommitted
2196 changes in the working tree, --no-strict
2197 disables the check.
2198 --usage Show usage message and options.
2199 --use-existing-dir By default push will fail if the target
2200 directory exists, but does not already
2201 have a control directory. This flag
2202 will allow push to proceed.
2203 --verbose, -v Display more information.
2204 See also: pull, update, working-trees
2206 Update a mirror of this branch.
2208 The target branch will not have its working tree populated because this
2210 is both expensive, and is not supported on remote file systems.
2211 Some smart servers or protocols *may* put the working tree in place in
2213 the future.
2214 This command only works on branches that have not diverged. Branches
2216 are considered diverged if the destination branch's most recent commit
2217 is one that has not been merged (directly or indirectly) by the source
2218 branch.
2219 If branches have diverged, you can use 'brz push --overwrite' to
2221 replace the other branch completely, discarding its unmerged changes.
2222 If you want to ensure you have the different changes in the other
2224 branch, do a merge (see brz help merge) from the other branch, and com‐
2225 mit that. After that you will be able to do a push without '--over‐
2226 write'.
2227 If there is no default push location set, the first push will set it
2229 (use --no-remember to avoid setting it). After that, you can omit the
2230 location to use the default. To change the default, use --remember.
2231 The value will only be saved if the remote location can be accessed.
2232 The --verbose option will display the revisions pushed using the
2234 log_format configuration option. You can use a different format by
2235 overriding it with -Olog_format=<other_format>.
2236 brz reconcile [BRANCH]
2239 Options:
2240 --help, -h Show help message.
2241 --quiet, -q Only display errors and warnings.
2242 --usage Show usage message and options.
2243 --verbose, -v Display more information.
2244 See also: check
2246 Reconcile brz metadata in a branch.
2248 This can correct data mismatches that may have been caused by previous
2250 ghost operations or brz upgrades. You should only need to run this com‐
2251 mand if 'brz check' or a brz developer advises you to run it.
2252 If a second branch is provided, cross-branch reconciliation is also
2254 attempted, which will check that data like the tree root id which was
2255 not present in very early brz versions is represented correctly in both
2256 branches.
2257 At the same time it is run it may recompress data resulting in a poten‐
2259 tial saving in disk space or performance gain.
2260 The branch *MUST* be on a listable system such as local disk or sftp.
2262 brz reconfigure [LOCATION]
2265 Options:
2266 --bind-to ARG Branch to bind checkout to.
2267 --force Perform reconfiguration even if local
2268 changes will be lost.
2269 --help, -h Show help message.
2270 --quiet, -q Only display errors and warnings.
2271 --repository_trees ARG Whether new branches in the repository
2272 have trees.
2273 --with-no-trees Reconfigure repository to not create
2274 working trees on branches by default.
2275 --with-trees Reconfigure repository to create working
2276 trees on branches by default.
2277 --repository_type ARG Location fo the repository.
2278 --standalone Reconfigure to be a standalone branch
2279 (i.e. stop using shared repository).
2280 --use-shared Reconfigure to use a shared repository.
2281 --stacked-on ARG Reconfigure a branch to be stacked on
2282 another branch.
2283 --tree_type ARG The relation between branch and tree.
2284 --branch Reconfigure to be an unbound branch with
2285 no working tree.
2286 --checkout Reconfigure to be a bound branch with a
2287 working tree.
2288 --lightweight-checkout Reconfigure to be a lightweight checkout
2289 (with no local history).
2290 --tree Reconfigure to be an unbound branch with
2291 a working tree.
2292 --unstacked Reconfigure a branch to be unstacked.
2293 This may require copying substantial
2294 data into it.
2295 --usage Show usage message and options.
2296 --verbose, -v Display more information.
2297 See also: branches, checkouts, standalone-trees, working-trees
2299 Reconfigure the type of a brz directory.
2301 A target configuration must be specified.
2303 For checkouts, the bind-to location will be auto-detected if not speci‐
2305 fied. The order of preference is 1. For a lightweight checkout, the
2306 current bound location. 2. For branches that used to be checkouts, the
2307 previously-bound location. 3. The push location. 4. The parent loca‐
2308 tion. If none of these is available, --bind-to must be specified.
2309 brz remerge [FILE...]
2312 Options:
2313 --help, -h Show help message.
2314 --merge-type ARG Select a particular merge algorithm.
2315 --diff3 Merge using external diff3.
2316 --lca LCA-newness merge.
2317 --merge3 Native diff3-style merge.
2318 --weave Weave-based merge.
2319 --quiet, -q Only display errors and warnings.
2320 --reprocess Reprocess to reduce spurious conflicts.
2321 --show-base Show base revision text in conflicts.
2322 --usage Show usage message and options.
2323 --verbose, -v Display more information.
2324 Redo a merge.
2326 Use this if you want to try a different merge technique while resolving
2328 conflicts. Some merge techniques are better than others, and remerge
2329 lets you try different ones on different files.
2330 The options for remerge have the same meaning and defaults as the ones
2332 for merge. The difference is that remerge can (only) be run when there
2333 is a pending merge, and it lets you specify particular files.
2334 Examples:
2336 Re-do the merge of all conflicted files, and show the base text in
2337 conflict regions, in addition to the usual THIS and OTHER texts:
2338 brz remerge --show-base
2340 Re-do the merge of "foobar", using the weave merge algorithm, with
2342 additional processing to reduce the size of conflict regions:
2343 brz remerge --merge-type weave --reprocess foobar
2345 brz remove [FILE...]
2348 Options:
2349 --file-deletion-strategy ARGThe file deletion mode to be used.
2350 --keep Delete from brz but leave the working
2351 copy.
2352 --no-backup Don't backup changed files.
2353 --safe Backup changed files (default).
2354 --help, -h Show help message.
2355 --new Only remove files that have never been
2356 committed.
2357 --quiet, -q Only display errors and warnings.
2358 --usage Show usage message and options.
2359 --verbose, -v Display more information.
2360 Aliases: rm, del
2362 Remove files or directories.
2364 This makes Breezy stop tracking changes to the specified files. Breezy
2366 will delete them if they can easily be recovered using revert otherwise
2367 they will be backed up (adding an extension of the form .~#~). If no
2368 options or parameters are given Breezy will scan for files that are
2369 being tracked by Breezy but missing in your tree and stop tracking them
2370 for you.
2371 brz remove-branch [LOCATION]
2374 Options:
2375 --directory ARG, -d Branch to operate on, instead of working
2376 directory.
2377 --force Remove branch even if it is the active
2378 branch.
2379 --help, -h Show help message.
2380 --quiet, -q Only display errors and warnings.
2381 --usage Show usage message and options.
2382 --verbose, -v Display more information.
2383 Alias: rmbranch
2385 Remove a branch.
2387 This will remove the branch from the specified location but will keep
2389 any working tree or repository in place.
2390 Examples:
2392 Remove the branch at repo/trunk:
2394 brz remove-branch repo/trunk
2396 brz remove-tree [LOCATION...]
2399 Options:
2400 --force Remove the working tree even if it has
2401 uncommitted or shelved changes.
2402 --help, -h Show help message.
2403 --quiet, -q Only display errors and warnings.
2404 --usage Show usage message and options.
2405 --verbose, -v Display more information.
2406 See also: checkout, working-trees
2408 Remove the working tree from a given branch/checkout.
2410 Since a lightweight checkout is little more than a working tree this
2412 will refuse to run against one.
2413 To re-create the working tree, use "brz checkout".
2415 brz rename
2418 Alias for "mv", see "brz mv".
2419 brz renames [DIR]
2421 Options:
2422 --help, -h Show help message.
2423 --quiet, -q Only display errors and warnings.
2424 --usage Show usage message and options.
2425 --verbose, -v Display more information.
2426 See also: status
2428 Show list of renamed files.
2430 brz resolve [FILE...]
2434 Options:
2435 --action ARG How to resolve the conflict.
2436 --auto Detect whether conflict has been
2437 resolved by user.
2438 --done Marks the conflict as resolved.
2439 --take-other Resolve the conflict taking the merged
2440 version into account.
2441 --take-this Resolve the conflict preserving the
2442 version in the working tree.
2443 --all Resolve all conflicts in this tree.
2444 --directory ARG, -d Branch to operate on, instead of working
2445 directory.
2446 --help, -h Show help message.
2447 --quiet, -q Only display errors and warnings.
2448 --usage Show usage message and options.
2449 --verbose, -v Display more information.
2450 Alias: resolved
2452 See also: conflicts
2454 Mark a conflict as resolved.
2456 Merge will do its best to combine the changes in two branches, but
2458 there are some kinds of problems only a human can fix. When it encoun‐
2459 ters those, it will mark a conflict. A conflict means that you need to
2460 fix something, before you can commit.
2461 Once you have fixed a problem, use "brz resolve" to automatically mark
2463 text conflicts as fixed, "brz resolve FILE" to mark a specific conflict
2464 as resolved, or "brz resolve --all" to mark all conflicts as resolved.
2465 brz resolved
2468 Alias for "resolve", see "brz resolve".
2469 brz revert [FILE...]
2471 Options:
2472 --forget-merges Remove pending merge marker, without
2473 changing any files.
2474 --help, -h Show help message.
2475 --no-backup Do not save backups of reverted files.
2476 --quiet, -q Only display errors and warnings.
2477 --revision ARG, -r See "help revisionspec" for details.
2478 --usage Show usage message and options.
2479 --verbose, -v Display more information.
2480 See also: cat, export, merge, shelve
2482 Set files in the working tree back to the contents of a previous revi‐
2484 sion.
2485 Giving a list of files will revert only those files. Otherwise, all
2487 files will be reverted. If the revision is not specified with '--revi‐
2488 sion', the working tree basis revision is used. A revert operation
2489 affects only the working tree, not any revision history like the branch
2490 and repository or the working tree basis revision.
2491 To remove only some changes, without reverting to a prior version, use
2493 merge instead. For example, "merge . -r -2..-3" (don't forget the ".")
2494 will remove the changes introduced by the second last commit (-2),
2495 without affecting the changes introduced by the last commit (-1). To
2496 remove certain changes on a hunk-by-hunk basis, see the shelve command.
2497 To update the branch to a specific revision or the latest revision and
2498 update the working tree accordingly while preserving local changes, see
2499 the update command.
2500 Uncommitted changes to files that are reverted will be discarded. How‐
2502 ever, by default, any files that have been manually changed will be
2503 backed up first. (Files changed only by merge are not backed up.)
2504 Backup files have '.~#~' appended to their name, where # is a number.
2505 When you provide files, you can use their current pathname or the path‐
2507 name from the target revision. So you can use revert to "undelete" a
2508 file by name. If you name a directory, all the contents of that direc‐
2509 tory will be reverted.
2510 If you have newly added files since the target revision, they will be
2512 removed. If the files to be removed have been changed, backups will be
2513 created as above. Directories containing unknown files will not be
2514 deleted.
2515 The working tree contains a list of revisions that have been merged but
2517 not yet committed. These revisions will be included as additional par‐
2518 ents of the next commit. Normally, using revert clears that list as
2519 well as reverting the files. If any files are specified, revert leaves
2520 the list of uncommitted merges alone and reverts only the files. Use
2521 \*(Aq\*(Aqbrz revert.\*(Aq\*(Aq in the tree root to revert all files
2522 but keep the recorded merges, and \*(Aq\*(Aqbrz revert --for‐
2523 get-merges\*(Aq\*(Aq to clear the pending merge list without reverting
2524 any files.
2525 Using "brz revert --forget-merges", it is possible to apply all of the
2527 changes from a branch in a single revision. To do this, perform the
2528 merge as desired. Then doing revert with the "--forget-merges" option
2529 will keep the content of the tree as it was, but it will clear the list
2530 of pending merges. The next commit will then contain all of the
2531 changes that are present in the other branch, but without any other
2532 parent revisions. Because this technique forgets where these changes
2533 originated, it may cause additional conflicts on later merges involving
2534 the same source and target branches.
2535 brz revno [LOCATION]
2538 Options:
2539 --help, -h Show help message.
2540 --quiet, -q Only display errors and warnings.
2541 --revision ARG, -r See "help revisionspec" for details.
2542 --tree Show revno of working tree.
2543 --usage Show usage message and options.
2544 --verbose, -v Display more information.
2545 See also: info
2547 Show current revision number.
2549 This is equal to the number of revisions on this branch.
2551 brz rm
2554 Alias for "remove", see "brz remove".
2555 brz rmbranch
2557 Alias for "remove-branch", see "brz remove-branch".
2558 brz root [FILENAME]
2560 Options:
2561 --help, -h Show help message.
2562 --quiet, -q Only display errors and warnings.
2563 --usage Show usage message and options.
2564 --verbose, -v Display more information.
2565 Show the tree root directory.
2567 The root is the nearest enclosing directory with a control directory.
2569 brz send [SUBMIT_BRANCH] [PUBLIC_BRANCH]
2572 Options:
2573 --body ARG Body for the email.
2574 --format ARG Use the specified output format.
2575 --from ARG, -f Branch to generate the submission from,
2576 rather than the one containing the
2577 working directory.
2578 --help, -h Show help message.
2579 --mail-to ARG Mail the request to this address.
2580 --message ARG, -m Message string.
2581 --no-bundle Do not include a bundle in the merge
2582 directive.
2583 --no-patch Do not include a preview patch in the
2584 merge directive.
2585 --output ARG, -o Write merge directive to this file or
2586 directory; use - for stdout.
2587 --quiet, -q Only display errors and warnings.
2588 --remember Remember submit and public branch.
2589 --revision ARG, -r See "help revisionspec" for details.
2590 --strict Refuse to send if there are uncommitted
2591 changes in the working tree, --no-strict
2592 disables the check.
2593 --usage Show usage message and options.
2594 --verbose, -v Display more information.
2595 See also: merge, pull
2597 Mail or create a merge-directive for submitting changes.
2599 A merge directive provides many things needed for requesting merges:
2601 * A machine-readable description of the merge to perform
2603 * An optional patch that is a preview of the changes requested
2605 * An optional bundle of revision data, so that the changes can be
2607 applied
2608 directly from the merge directive, without retrieving data from a
2609 branch.
2610 \*(Aqbrz send\*(Aq creates a compact data set that, when applied using
2612 brz merge, has the same effect as merging from the source branch.
2613 By default the merge directive is self-contained and can be applied to
2615 any branch containing submit_branch in its ancestory without needing
2616 access to the source branch.
2617 If --no-bundle is specified, then Breezy doesn't send the contents of
2619 the revisions, but only a structured request to merge from the pub‐
2620 lic_location. In that case the public_branch is needed and it must be
2621 up-to-date and accessible to the recipient. The public_branch is
2622 always included if known, so that people can check it later.
2623 The submit branch defaults to the parent of the source branch, but can
2625 be overridden. Both submit branch and public branch will be remembered
2626 in branch.conf the first time they are used for a particular branch.
2627 The source branch defaults to that containing the working directory,
2628 but can be changed using --from.
2629 Both the submit branch and the public branch follow the usual behavior
2631 with respect to --remember: If there is no default location set, the
2632 first send will set it (use --no-remember to avoid setting it). After
2633 that, you can omit the location to use the default. To change the
2634 default, use --remember. The value will only be saved if the location
2635 can be accessed.
2636 In order to calculate those changes, brz must analyse the submit
2638 branch. Therefore it is most efficient for the submit branch to be a
2639 local mirror. If a public location is known for the submit_branch,
2640 that location is used in the merge directive.
2641 The default behaviour is to send the merge directive by mail, unless -o
2643 is given, in which case it is sent to a file.
2644 Mail is sent using your preferred mail program. This should be trans‐
2646 parent on Windows (it uses MAPI). On Unix, it requires the xdg-email
2647 utility. If the preferred client can't be found (or used), your editor
2648 will be used.
2649 To use a specific mail program, set the mail_client configuration
2651 option. Supported values for specific clients are "claws", "evolu‐
2652 tion", "kmail", "mail.app" (MacOS X's Mail.app), "mutt", and "thunder‐
2653 bird"; generic options are "default", "editor", "emacsclient", "mapi",
2654 and "xdg-email". Plugins may also add supported clients.
2655 If mail is being sent, a to address is required. This can be supplied
2657 either on the commandline, by setting the submit_to configuration
2658 option in the branch itself or the child_submit_to configuration option
2659 in the submit branch.
2660 The merge directives created by brz send may be applied using brz merge
2662 or brz pull by specifying a file containing a merge directive as the
2663 location.
2664 brz send makes extensive use of public locations to map local locations
2666 into URLs that can be used by other people. See \*(Aqbrz help configu‐
2667 ration\*(Aq to set them, and use \*(Aqbrz info\*(Aq to display them.
2668 brz serve
2671 Options:
2672 --allow-writes By default the server is a readonly
2673 server. Supplying --allow-writes
2674 enables write access to the contents of
2675 the served directory and below. Note
2676 that \*(Aq\*(Aqbrz serve\*(Aq\*(Aq does
2677 not perform
2678 authentication, so unless some form of
2679 external authentication is arranged
2680 supplying this option leads to global
2681 uncontrolled write access to your file
2682 system.
2683 --client-timeout ARG Override the default idle client timeout
2684 (5min).
2685 --directory ARG, -d Serve contents of this directory.
2686 --help, -h Show help message.
2687 --inet Serve on stdin/out for use from inetd or
2688 sshd.
2689 --listen ARG Listen for connections on nominated
2690 address.
2691 --port ARG Listen for connections on nominated
2692 port. Passing 0 as the port number will
2693 result in a dynamically allocated port.
2694 The default port depends on the
2695 protocol.
2696 --protocol ARG Protocol to serve.
2697 --bzr The Bazaar smart server protocol over
2698 TCP. (default port: 4155)
2699 --git Git Smart server protocol over TCP.
2700 (default port: 9418)
2701 --git-receive-pack Git Smart server receive pack command.
2702 (inetd mode only)
2703 --git-upload-pack Git Smart server upload pack command.
2704 (inetd mode only)
2705 --quiet, -q Only display errors and warnings.
2706 --usage Show usage message and options.
2707 --verbose, -v Display more information.
2708 Alias: server
2710 Run the brz server.
2712 brz server
2715 Alias for "serve", see "brz serve".
2716 brz shelve [FILE...]
2718 Options:
2719 --all Shelve all changes.
2720 --destroy Destroy removed changes instead of
2721 shelving them.
2722 --directory ARG, -d Branch to operate on, instead of working
2723 directory.
2724 --help, -h Show help message.
2725 --list List shelved changes.
2726 --message ARG, -m Message string.
2727 --quiet, -q Only display errors and warnings.
2728 --revision ARG, -r See "help revisionspec" for details.
2729 --usage Show usage message and options.
2730 --verbose, -v Display more information.
2731 --writer ARG Method to use for writing diffs.
2732 --plain Plaintext diff output.
2733 See also: configuration, unshelve
2735 Temporarily set aside some changes from the current tree.
2737 Shelve allows you to temporarily put changes you've made "on the
2739 shelf", ie. out of the way, until a later time when you can bring them
2740 back from the shelf with the 'unshelve' command. The changes are
2741 stored alongside your working tree, and so they aren't propagated along
2742 with your branch nor will they survive its deletion.
2743 If shelve --list is specified, previously-shelved changes are listed.
2745 Shelve is intended to help separate several sets of changes that have
2747 been inappropriately mingled. If you just want to get rid of all
2748 changes and you don't need to restore them later, use revert. If you
2749 want to shelve all text changes at once, use shelve --all.
2750 If filenames are specified, only the changes to those files will be
2752 shelved. Other files will be left untouched.
2753 If a revision is specified, changes since that revision will be
2755 shelved.
2756 You can put multiple items on the shelf, and by default, 'unshelve'
2758 will restore the most recently shelved changes.
2759 For complicated changes, it is possible to edit the changes in a sepa‐
2761 rate editor program to decide what the file remaining in the working
2762 copy should look like. To do this, add the configuration option
2763 change_editor = PROGRAM @new_path @old_path
2765 where @new_path is replaced with the path of the new version of the
2767 file and @old_path is replaced with the path of the old version of the
2768 file. The PROGRAM should save the new file with the desired contents
2769 of the file in the working tree.
2770 brz sign-my-commits [LOCATION] [COMMITTER]
2773 Options:
2774 --dry-run Don't actually sign anything, just print
2775 the revisions that would be signed.
2776 --help, -h Show help message.
2777 --quiet, -q Only display errors and warnings.
2778 --usage Show usage message and options.
2779 --verbose, -v Display more information.
2780 Sign all commits by a given committer.
2782 If location is not specified the local tree is used. If committer is
2784 not specified the default committer is used.
2785 This does not sign commits that already have signatures.
2787 brz split TREE
2790 Options:
2791 --help, -h Show help message.
2792 --quiet, -q Only display errors and warnings.
2793 --usage Show usage message and options.
2794 --verbose, -v Display more information.
2795 See also: join
2797 Split a subdirectory of a tree into a separate tree.
2799 This command will produce a target tree in a format that supports rich
2801 roots, like 'rich-root' or 'rich-root-pack'. These formats cannot be
2802 converted into earlier formats like 'dirstate-tags'.
2803 The TREE argument should be a subdirectory of a working tree. That
2805 subdirectory will be converted into an independent tree, with its own
2806 branch. Commits in the top-level tree will not apply to the new sub‐
2807 tree.
2808 brz st
2811 Alias for "status", see "brz status".
2812 brz stat
2814 Alias for "status", see "brz status".
2815 brz status [FILE...]
2817 Options:
2818 --change ARG, -c Select changes introduced by the
2819 specified revision. See also "help
2820 revisionspec".
2821 --help, -h Show help message.
2822 --no-classify Do not mark object type using indicator.
2823 --no-pending Don't show pending merges.
2824 --quiet, -q Only display errors and warnings.
2825 --revision ARG, -r See "help revisionspec" for details.
2826 --short, -S Use short status indicators.
2827 --show-ids Show internal object ids.
2828 --usage Show usage message and options.
2829 --verbose, -v Display more information.
2830 --versioned, -V Only show versioned files.
2831 Aliases: st, stat
2833 See also: diff, revert, status-flags
2835 Display status summary.
2837 This reports on versioned and unknown files, reporting them grouped by
2839 state. Possible states are:
2840 added
2842 Versioned in the working copy but not in the previous revision.
2843 removed
2845 Versioned in the previous revision but removed or deleted
2846 in the working copy.
2847 renamed
2849 Path of this file changed from the previous revision;
2850 the text may also have changed. This includes files whose
2851 parent directory was renamed.
2852 modified
2854 Text has changed since the previous revision.
2855 kind changed
2857 File kind has been changed (e.g. from file to directory).
2858 unknown
2860 Not versioned and not matching an ignore pattern.
2861 Additionally for directories, symlinks and files with a changed exe‐
2863 cutable bit, Breezy indicates their type using a trailing character:
2864 '/', '@' or '*' respectively. These decorations can be disabled using
2865 the '--no-classify' option.
2866 To see ignored files use 'brz ignored'. For details on the changes to
2868 file texts, use 'brz diff'.
2869 Note that --short or -S gives status flags for each item, similar to
2871 Subversion's status command. To get output similar to svn -q, use brz
2872 status -SV.
2873 If no arguments are specified, the status of the entire working direc‐
2875 tory is shown. Otherwise, only the status of the specified files or
2876 directories is reported. If a directory is given, status is reported
2877 for everything inside that directory.
2878 Before merges are committed, the pending merge tip revisions are shown.
2880 To see all pending merge revisions, use the -v option. To skip the
2881 display of pending merge information altogether, use the no-pending
2882 option or specify a file/directory.
2883 To compare the working directory to a specific revision, pass a single
2885 revision to the revision argument.
2886 To see which files have changed in a specific revision, or between two
2888 revisions, pass a revision range to the revision argument. This will
2889 produce the same results as calling 'brz diff --summarize'.
2890 brz switch [TO_LOCATION]
2893 Options:
2894 --create-branch, -b Create the target branch from this one
2895 before switching to it.
2896 --directory ARG, -d Branch to operate on, instead of working
2897 directory.
2898 --force Switch even if local commits will be
2899 lost.
2900 --help, -h Show help message.
2901 --quiet, -q Only display errors and warnings.
2902 --revision ARG, -r See "help revisionspec" for details.
2903 --store Store and restore uncommitted changes in
2904 the branch.
2905 --usage Show usage message and options.
2906 --verbose, -v Display more information.
2907 Set the branch of a checkout and update.
2909 For lightweight checkouts, this changes the branch being referenced.
2911 For heavyweight checkouts, this checks that there are no local commits
2912 versus the current bound branch, then it makes the local branch a mir‐
2913 ror of the new location and binds to it.
2914 In both cases, the working tree is updated and uncommitted changes are
2916 merged. The user can commit or revert these as they desire.
2917 Pending merges need to be committed or reverted before using switch.
2919 The path to the branch to switch to can be specified relative to the
2921 parent directory of the current branch. For example, if you are cur‐
2922 rently in a checkout of /path/to/branch, specifying 'newbranch' will
2923 find a branch at /path/to/newbranch.
2924 Bound branches use the nickname of its master branch unless it is set
2926 locally, in which case switching will update the local nickname to be
2927 that of the master.
2928 brz tag [TAG_NAME]
2931 Options:
2932 --delete Delete this tag rather than placing it.
2933 --directory ARG, -d Branch in which to place the tag.
2934 --force Replace existing tags.
2935 --help, -h Show help message.
2936 --quiet, -q Only display errors and warnings.
2937 --revision ARG, -r See "help revisionspec" for details.
2938 --usage Show usage message and options.
2939 --verbose, -v Display more information.
2940 See also: commit, tags
2942 Create, remove or modify a tag naming a revision.
2944 Tags give human-meaningful names to revisions. Commands that take a -r
2946 (--revision) option can be given -rtag:X, where X is any previously
2947 created tag.
2948 Tags are stored in the branch. Tags are copied from one branch to
2950 another along when you branch, push, pull or merge.
2951 It is an error to give a tag name that already exists unless you pass
2953 --force, in which case the tag is moved to point to the new revision.
2954 To rename a tag (change the name but keep it on the same revsion), run
2956 \*(Aq\*(Aqbrz tag new-name -r tag:old-name\*(Aq\*(Aq and then
2957 \*(Aq\*(Aqbrz tag --delete oldname\*(Aq\*(Aq.
2958 If no tag name is specified it will be determined through the 'auto‐
2960 matic_tag_name' hook. This can e.g. be used to automatically tag
2961 upstream releases by reading configure.ac. See \*(Aq\*(Aqbrz help
2962 hooks\*(Aq\*(Aq for details.
2963 brz tags
2966 Options:
2967 --directory ARG, -d Branch whose tags should be displayed.
2968 --help, -h Show help message.
2969 --quiet, -q Only display errors and warnings.
2970 --revision ARG, -r See "help revisionspec" for details.
2971 --show-ids Show internal object ids.
2972 --sort ARG Sort tags by different criteria.
2973 --usage Show usage message and options.
2974 --verbose, -v Display more information.
2975 See also: tag
2977 List tags.
2979 This command shows a table of tag names and the revisions they refer‐
2981 ence.
2982 brz testament [BRANCH]
2985 Options:
2986 --help, -h Show help message.
2987 --long Produce long-format testament.
2988 --quiet, -q Only display errors and warnings.
2989 --revision ARG, -r See "help revisionspec" for details.
2990 --strict Produce a strict-format testament.
2991 --usage Show usage message and options.
2992 --verbose, -v Display more information.
2993 Show testament (signing-form) of a revision.
2995 brz unbind
2998 Options:
2999 --directory ARG, -d Branch to operate on, instead of working
3000 directory.
3001 --help, -h Show help message.
3002 --quiet, -q Only display errors and warnings.
3003 --usage Show usage message and options.
3004 --verbose, -v Display more information.
3005 See also: bind, checkouts
3007 Convert the current checkout into a regular branch.
3009 After unbinding, the local branch is considered independent and subse‐
3011 quent commits will be local only.
3012 brz uncommit [LOCATION]
3015 Options:
3016 --dry-run Don't actually make changes.
3017 --force Say yes to all questions.
3018 --help, -h Show help message.
3019 --keep-tags Keep tags that point to removed
3020 revisions.
3021 --local Only remove the commits from the local
3022 branch when in a checkout.
3023 --quiet, -q Only display errors and warnings.
3024 --revision ARG, -r See "help revisionspec" for details.
3025 --usage Show usage message and options.
3026 --verbose, -v Display more information.
3027 See also: commit
3029 Remove the last committed revision.
3031 --verbose will print out what is being removed. --dry-run will go
3033 through all the motions, but not actually remove anything.
3034 If --revision is specified, uncommit revisions to leave the branch at
3036 the specified revision. For example, "brz uncommit -r 15" will leave
3037 the branch at revision 15.
3038 Uncommit leaves the working tree ready for a new commit. The only
3040 change it may make is to restore any pending merges that were present
3041 before the commit.
3042 brz unshelve [SHELF_ID]
3045 Options:
3046 --action ARG The action to perform.
3047 --apply Apply changes and remove from the shelf.
3048 --delete-only Delete changes without applying them.
3049 --dry-run Show changes, but do not apply or remove
3050 them.
3051 --keep Apply changes but don't delete them.
3052 --preview Instead of unshelving the changes, show
3053 the diff that would result from
3054 unshelving.
3055 --directory ARG, -d Branch to operate on, instead of working
3056 directory.
3057 --help, -h Show help message.
3058 --quiet, -q Only display errors and warnings.
3059 --usage Show usage message and options.
3060 --verbose, -v Display more information.
3061 See also: shelve
3063 Restore shelved changes.
3065 By default, the most recently shelved changes are restored. However if
3067 you specify a shelf by id those changes will be restored instead. This
3068 works best when the changes don't depend on each other.
3069 brz up
3072 Alias for "update", see "brz update".
3073 brz update [DIR]
3075 Options:
3076 --help, -h Show help message.
3077 --quiet, -q Only display errors and warnings.
3078 --revision ARG, -r See "help revisionspec" for details.
3079 --show-base Show base revision text in conflicts.
3080 --usage Show usage message and options.
3081 --verbose, -v Display more information.
3082 Alias: up
3084 See also: pull, status-flags, working-trees
3086 Update a working tree to a new revision.
3088 This will perform a merge of the destination revision (the tip of the
3090 branch, or the specified revision) into the working tree, and then make
3091 that revision the basis revision for the working tree.
3092 You can use this to visit an older revision, or to update a working
3094 tree that is out of date from its branch.
3095 If there are any uncommitted changes in the tree, they will be carried
3097 across and remain as uncommitted changes after the update. To discard
3098 these changes, use 'brz revert'. The uncommitted changes may conflict
3099 with the changes brought in by the change in basis revision.
3100 If the tree's branch is bound to a master branch, brz will also update
3102 the branch from the master.
3103 You cannot update just a single file or directory, because each Breezy
3105 working tree has just a single basis revision. If you want to restore
3106 a file that has been removed locally, use 'brz revert' instead of 'brz
3107 update'. If you want to restore a file to its state in a previous
3108 revision, use 'brz revert' with a '-r' option, or use 'brz cat' to
3109 write out the old content of that file to a new location.
3110 The 'dir' argument, if given, must be the location of the root of a
3112 working tree to update. By default, the working tree that contains the
3113 current working directory is used.
3114 brz upgrade [URL]
3117 Options:
3118 --clean Remove the backup.bzr directory if
3119 successful.
3120 --dry-run Show what would be done, but don't
3121 actually do anything.
3122 --format ARG Upgrade to a specific format. See "brz
3123 help formats" for details.
3124 --2a Format for the bzr 2.0 series.
3125 --bzr Format for the bzr 2.0 series.
3126 --default Format for the bzr 2.0 series.
3127 --git GIT repository.
3128 --git-bare Bare GIT repository (no working tree).
3129 --help, -h Show help message.
3130 --quiet, -q Only display errors and warnings.
3131 --usage Show usage message and options.
3132 --verbose, -v Display more information.
3133 See also: check, formats, reconcile
3135 Upgrade a repository, branch or working tree to a newer format.
3137 When the default format has changed after a major new release of
3139 Bazaar/Breezy, you may be informed during certain operations that you
3140 should upgrade. Upgrading to a newer format may improve performance or
3141 make new features available. It may however limit interoperability with
3142 older repositories or with older versions of Bazaar or Breezy.
3143 If you wish to upgrade to a particular format rather than the current
3145 default, that can be specified using the --format option. As a conse‐
3146 quence, you can use the upgrade command this way to "downgrade" to an
3147 earlier format, though some conversions are a one way process (e.g.
3148 changing from the 1.x default to the 2.x default) so downgrading is not
3149 always possible.
3150 A backup.bzr.~#~ directory is created at the start of the conversion
3152 process (where # is a number). By default, this is left there on com‐
3153 pletion. If the conversion fails, delete the new .bzr directory and
3154 rename this one back in its place. Use the --clean option to ask for
3155 the backup.bzr directory to be removed on successful conversion.
3156 Alternatively, you can delete it by hand if everything looks good
3157 afterwards.
3158 If the location given is a shared repository, dependent branches are
3160 also converted provided the repository converts successfully. If the
3161 conversion of a branch fails, remaining branches are still tried.
3162 For more information on upgrades, see the Breezy Upgrade Guide,
3164 https://www.breezy-vcs.org/doc/en/upgrade-guide/.
3165 brz verify-signatures [LOCATION]
3168 Options:
3169 --acceptable-keys ARG, -k Comma separated list of GPG key patterns
3170 which are acceptable for verification.
3171 --help, -h Show help message.
3172 --quiet, -q Only display errors and warnings.
3173 --revision ARG, -r See "help revisionspec" for details.
3174 --usage Show usage message and options.
3175 --verbose, -v Display more information.
3176 Verify all commit signatures.
3178 Verifies that all commits in the branch are signed by known GnuPG keys.
3180 brz version
3183 Options:
3184 --help, -h Show help message.
3185 --quiet, -q Only display errors and warnings.
3186 --short Print just the version number.
3187 --usage Show usage message and options.
3188 --verbose, -v Display more information.
3189 Show version of brz.
3191 brz version-info [LOCATION]
3194 Options:
3195 --all Include all possible information.
3196 --check-clean Check if tree is clean.
3197 --format ARG Select the output format.
3198 --custom Version info in Custom template-based
3199 format.
3200 --python Version info in Python format.
3201 --rio Version info in RIO (simple text) format
3202 (default).
3203 --help, -h Show help message.
3204 --include-file-revisions Include the last revision for each file.
3205 --include-history Include the revision-history.
3206 --quiet, -q Only display errors and warnings.
3207 --revision ARG, -r See "help revisionspec" for details.
3208 --template ARG Template for the output.
3209 --usage Show usage message and options.
3210 --verbose, -v Display more information.
3211 Show version information about this tree.
3213 You can use this command to add information about version into source
3215 code of an application. The output can be in one of the supported for‐
3216 mats or in a custom format based on a template.
3217 For example:
3219 brz version-info --custom \
3221 --template="#define VERSION_INFO \"Project 1.2.3 (r{revno})\"\n"
3222 will produce a C header file with formatted string containing the cur‐
3224 rent revision number. Other supported variables in templates are:
3225 * {date} - date of the last revision
3227 * {build_date} - current date
3228 * {revno} - revision number
3229 * {revision_id} - revision id
3230 * {branch_nick} - branch nickname
3231 * {clean} - 0 if the source tree contains uncommitted changes,
3232 otherwise 1
3233 brz view [FILE...]
3236 Options:
3237 --all Apply list or delete action to all
3238 views.
3239 --delete Delete the view.
3240 --help, -h Show help message.
3241 --name ARG Name of the view to define, list or
3242 delete.
3243 --quiet, -q Only display errors and warnings.
3244 --switch ARG Name of the view to switch to.
3245 --usage Show usage message and options.
3246 --verbose, -v Display more information.
3247 Manage filtered views.
3249 Views provide a mask over the tree so that users can focus on a subset
3251 of a tree when doing their work. After creating a view, commands that
3252 support a list of files - status, diff, commit, etc - effectively have
3253 that list of files implicitly given each time. An explicit list of
3254 files can still be given but those files must be within the current
3255 view.
3256 In most cases, a view has a short life-span: it is created to make a
3258 selected change and is deleted once that change is committed. At other
3259 times, you may wish to create one or more named views and switch
3260 between them.
3261 To disable the current view without deleting it, you can switch to the
3263 pseudo view called \*(Aq\*(Aqoff\*(Aq\*(Aq. This can be useful when you
3264 need to see the whole tree for an operation or two (e.g. merge) but
3265 want to switch back to your view after that.
3266 Examples:
3268 To define the current view:
3269 brz view file1 dir1 ...
3271 To list the current view:
3273 brz view
3275 To delete the current view:
3277 brz view --delete
3279 To disable the current view without deleting it:
3281 brz view --switch off
3283 To define a named view and switch to it:
3285 brz view --name view-name file1 dir1 ...
3287 To list a named view:
3289 brz view --name view-name
3291 To delete a named view:
3293 brz view --name view-name --delete
3295 To switch to a named view:
3297 brz view --switch view-name
3299 To list all views defined:
3301 brz view --all
3303 To delete all views:
3305 brz view --delete --all
3307 brz whoami [NAME]
3310 Options:
3311 --branch Set identity for the current branch
3312 instead of globally.
3313 --directory ARG, -d Branch to operate on, instead of working
3314 directory.
3315 --email Display email address only.
3316 --help, -h Show help message.
3317 --quiet, -q Only display errors and warnings.
3318 --usage Show usage message and options.
3319 --verbose, -v Display more information.
3320 Show or set brz user id.
3322 Examples:
3324 Show the email of the current user:
3325 brz whoami --email
3327 Set the current user:
3329 brz whoami "Frank Chu <fchu@example.com>"
3331
3334 BRZPATH
3335 Path where brz is to look for shell plugin external commands.
3336 BRZ_EMAIL
3338 E-Mail address of the user. Overrides EMAIL.
3339 EMAIL E-Mail address of the user.
3341 BRZ_EDITOR
3343 Editor for editing commit messages. Overrides EDITOR.
3344 EDITOR Editor for editing commit messages.
3346 BRZ_PLUGIN_PATH
3348 Paths where brz should look for plugins.
3349 BRZ_DISABLE_PLUGINS
3351 Plugins that brz should not load.
3352 BRZ_PLUGINS_AT
3354 Plugins to load from a directory not in BRZ_PLUGIN_PATH.
3355 BRZ_HOME
3357 Directory holding breezy config dir. Overrides HOME.
3358 BRZ_HOME (Win32)
3360 Directory holding breezy config dir. Overrides APPDATA and HOME.
3361 BZR_REMOTE_PATH
3363 Full name of remote 'brz' command (for brz+ssh:// URLs).
3364 BRZ_SSH
3366 Path to SSH client, or one of paramiko, openssh, sshcorp, plink
3367 or lsh.
3368 BRZ_LOG
3370 Location of .brz.log (use '/dev/null' to suppress log).
3371 BRZ_LOG (Win32)
3373 Location of .brz.log (use 'NUL' to suppress log).
3374 BRZ_COLUMNS
3376 Override implicit terminal width.
3377 BRZ_CONCURRENCY
3379 Number of processes that can be run concurrently (selftest)
3380 BRZ_PROGRESS_BAR
3382 Override the progress display. Values are 'none' or 'text'.
3383 BRZ_PDB
3385 Control whether to launch a debugger on error.
3386 BRZ_SIGQUIT_PDB
3388 Control whether SIGQUIT behaves normally or invokes a breakin
3389 debugger.
3390 BRZ_TEXTUI_INPUT
3392 Force console input mode for prompts to line-based (instead of
3393 char-based).
3394
3396 ~/.config/breezy/breezy.conf
3397 Contains the user's default configuration. The section [DEFAULT]
3398 is used to define general configuration that will be applied
3399 everywhere. The section [ALIASES] can be used to create command
3400 aliases for commonly used options.
3401 A typical config file might look something like:
3403 [DEFAULT]
3405 email=John Doe <jdoe@isp.com>
3406 [ALIASES]
3407 commit = commit --strict
3408 log10 = log --short -r -10..-1
3409
3411 https://www.breezy-vcs.org/
34123.0.2 2019-12-01 brz(1)