~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Aaron Bentley
  • Date: 2005-06-08 15:02:28 UTC
  • Revision ID: abentley@panoramicfeedback.com-20050608150228-4d9daad616b1213e
Continued symlink fix, cleaned up merge, error message

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
BZR TOOLS
2
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
 
FETCH-GHOSTS
28
 
Scan this branch for missing ancestors (aka "ghosts), and attempt to retrieve
29
 
them from a specified branch.
30
 
 
31
 
GRAPH-ANCESTRY
32
 
Use dot (from Graphviz) to produce graphics of a tree's ancestry.
33
 
 
34
 
IMPORT
35
 
Import a tarball into a bzr branch, or update to a fresh tarball.
36
 
 
37
 
PATCH
38
 
Use patch to apply a patch to this tree.
39
 
 
40
 
MULTI-PULL
41
 
Pull all branches and checkouts at or underneath the current location.
42
 
 
43
 
RSPUSH
 
3
This is is a set of helper tools for bzr.
 
4
 
 
5
BAZ2BZR
 
6
baz2bzr will import an Arch or Baz branch into bzr.
 
7
Data converted:
 
8
- source tree
 
9
- file ids
 
10
- log summaries
 
11
- revision ids
 
12
 
 
13
Data not converted:
 
14
- data on revisions merged
 
15
 
 
16
After more commits are made to the baz/arch branch, you can re-run baz2bzr
 
17
to import just those changes
 
18
 
 
19
BZR-PUSH
44
20
Uses rsync to copy a branch to a remote location.  Remembers the last location
45
21
used.  Will not push if
46
22
- there are unknown files
47
23
- there are uncommitted changes in the working tree.
48
24
These safeguards are intended to prevent dirty trees from being uploaded.
49
25
 
50
 
SHELL
51
 
An interactive shell with bzr commands available as single commands, and
52
 
nice shell completion.
53
 
 
54
 
SHELVE/UNSHELVE/SHELF
55
 
Shelve allows you to temporarily put changes you've made "on the shelf",
56
 
ie. out of the way, until a later time when you can bring them back from
57
 
the shelf with the 'unshelve' command.
58
 
 
59
 
You can put multiple items on the shelf, each time you run unshelve the
60
 
most recently shelved changes will be reinstated.
61
 
 
62
 
If filenames are specified, only the changes to those files will be
63
 
shelved, other files will be left untouched.
64
 
 
65
 
If a revision is specified, changes since that revision will be shelved.
66
 
 
67
 
If you specifiy "--pick" you'll be prompted for each hunk of the diff as
68
 
to whether you want to shelve it or not. Press "?" at the prompt for help.
69
 
 
70
 
SHOW-PATHS
71
 
List the locations used by a branch or checkout.
72
 
 
73
 
More Info
74
 
=========
75
 
 
76
 
http://bazaar.canonical.com/BzrShelveExample
77
 
 
78
 
SWITCH
79
 
Change the branch associated with a lightweight checkout, and update the tree
80
 
while retaining local changes.
81
 
 
82
 
ZAP
83
 
Safely remove undesired checkouts.
 
26
BZR-PULL (obsolete as of Bzr 0.5)
 
27
Uses rsync to get the latest changes from an upstream location.  Remembers the
 
28
last location used.  Will not pull if
 
29
- there are unknown files
 
30
- there are uncommitted changes
 
31
- there have been local commits
 
32
These safeguards are intended to prevent accidental data loss.