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