← Back to branch summary

~abentley/bzrtools/bzrtools.dev

« back to all changes in this revision

Viewing changes to README

  • Committer: Max Bowsher
  • Date: 2009-11-13 00:43:08 UTC
  • mto: This revision was merged to the branch mainline in revision 739.
  • Revision ID: maxb@f2s.com-20091113004308-4dcwu1kwt3lhf1kp
Having discovered that bzr-builddeb import_dsc.py is a horrid copy-paste job of bzrtools upstream_import.py, restructure the change to minimize divergence from it.

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
1
1
BZR TOOLS
2
2
 
3
 
This is is a set of plugins for bzr.
4
 
 
5
 
BAZ-IMPORT
6
 
baz-bzr will import an Arch or Baz branch into bzr.
7
 
Data converted:
8
 
- source tree
9
 
- file ids
10
 
- revision ids
11
 
- log summaries
12
 
 
13
 
Data not converted:
14
 
- data on revisions merged
15
 
- log bodies
16
 
- symlinks in Arch trees are not handled (but can be skipped).
17
 
 
18
 
After more commits are made to the baz/arch branch, you can re-run baz-import
19
 
to import just those changes.
20
 
 
21
 
The conversion algorithm is still in flux, and old data may become invalid as
22
 
newer conversion functionality is introduced.
23
 
 
24
 
 
25
 
PUSH
 
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
26
44
Uses rsync to copy a branch to a remote location.  Remembers the last location
27
45
used.  Will not push if
28
46
- there are unknown files
29
47
- there are uncommitted changes in the working tree.
30
48
These safeguards are intended to prevent dirty trees from being uploaded.
31
49
 
32
 
ANNOTATE
33
 
Output a version of the requested file that indicates which revision introduced
34
 
each line.
35
 
 
36
 
SHELVE/UNSHELVE
37
 
Temporarily put aside some changes, to restore them later.  This can be useful
38
 
to separate two sets of changes, so that they can be committed separately.
39
 
 
40
 
CLEAN-TREE
41
 
Delete unknown (or, optionally, ignored) files, leaving versioned files
42
 
untouched.
43
 
 
44
 
CONFLICTS
45
 
List files in the tree that have conflicts.
46
 
 
47
 
RESOLVE
48
 
Mark conflicts as resolved, by deleting TREE, BASE and OTHER files.
49
 
 
50
 
GRAPH-ANCESTRY
51
 
Use dot (from Graphviz) to produce graphics of a tree's ancestry.
52
 
 
53
 
FETCH-MISSING
54
 
Scan this branch for missing ancestors, and attempt to retrieve them from
55
 
another branch
56
 
 
57
 
PATCH
58
 
Use patch to apply a patch to this tree.
 
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.