~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Aaron Bentley
  • Date: 2008-11-12 17:09:36 UTC
  • Revision ID: aaron@aaronbentley.com-20081112170936-3dybsv7il8gxhchz
Use bzrlib's getchar

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
BZR TOOLS
 
2
 
 
3
This is is a set of plugins for Bazaar.
 
4
 
 
5
Please report bugs at: https://bugs.launchpad.net/bzrtools/
 
6
 
 
7
 
 
8
BRANCHES
 
9
List all the branches present at, or underneath, a location.
 
10
 
 
11
BRANCH-HISTORY
 
12
Show a history of the branch, separated by committer and branch nick.
 
13
 
 
14
CBRANCH
 
15
Create a branch in a repository and a checkout elsewhere, in one command.
 
16
 
 
17
CDIFF
 
18
cdiff mimics bzr diff, but displays the diff in colour. cdiff knows how
 
19
to read a ~/.colordiffrc file, in the same format as for colordiff(1).
 
20
 
 
21
# example ~/.colordiffrc
 
22
plain=darkwhite
 
23
newtext=darkblue
 
24
oldtext=darkred
 
25
diffstuff=darkgreen
 
26
 
 
27
CLEAN-TREE
 
28
Delete unknown, ignored, or detritus files, leaving versioned files untouched.
 
29
 
 
30
FETCH-GHOSTS
 
31
Scan this branch for missing ancestors (aka "ghosts), and attempt to retrieve
 
32
them from a specified branch.
 
33
 
 
34
GRAPH-ANCESTRY
 
35
Use dot (from Graphviz) to produce graphics of a tree's ancestry.
 
36
 
 
37
IMPORT
 
38
Import a tarball into a bzr branch, or update to a fresh tarball.
 
39
 
 
40
PATCH
 
41
Use patch to apply a patch to this tree.
 
42
 
 
43
MULTI-PULL
 
44
Pull all branches and checkouts at or underneath the current location.
 
45
 
 
46
RSPUSH
 
47
Uses rsync to copy a branch to a remote location.  Remembers the last location
 
48
used.  Will not push if
 
49
- there are unknown files
 
50
- there are uncommitted changes in the working tree.
 
51
These safeguards are intended to prevent dirty trees from being uploaded.
 
52
 
 
53
SHELL
 
54
An interactive shell with bzr commands available as single commands, and
 
55
nice shell completion.
 
56
 
 
57
SHELVE/UNSHELVE/SHELF
 
58
Shelve allows you to temporarily put changes you've made "on the shelf",
 
59
ie. out of the way, until a later time when you can bring them back from
 
60
the shelf with the 'unshelve' command.
 
61
 
 
62
You can put multiple items on the shelf, each time you run unshelve the
 
63
most recently shelved changes will be reinstated.
 
64
 
 
65
If filenames are specified, only the changes to those files will be
 
66
shelved, other files will be left untouched.
 
67
 
 
68
If a revision is specified, changes since that revision will be shelved.
 
69
 
 
70
If you specifiy "--pick" you'll be prompted for each hunk of the diff as
 
71
to whether you want to shelve it or not. Press "?" at the prompt for help.
 
72
 
 
73
SHOW-PATHS
 
74
List the locations used by a branch or checkout.
 
75
 
 
76
More Info
 
77
=========
 
78
 
 
79
http://bazaar.canonical.com/BzrShelveExample
 
80
 
 
81
SWITCH
 
82
Change the branch associated with a lightweight checkout, and update the tree
 
83
while retaining local changes.
 
84
 
 
85
ZAP
 
86
Safely remove undesired checkouts.