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