1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
Multi-branch Bazaar plugin for Trac
===================================
.. contents:
This plugin is based on earlier plugins. Its main innovation is to make
multiple branches available, the way Trac normally does.
Copyright (C) 2005 Edgewall Software
Copyright (C) 2005-2006 Christian Boos <cboos@neuf.fr>
Copyright (C) 2005 Johan Rydberg <jrydberg@gnu.org>
Copyright (C) 2006 Yann Hodique <hodique@lifl.fr>
Copyright (C) 2006 Jelmer Vernooij <jelmer@samba.org>
Copyright (C) 2006 Lukas Lalinsky <lalinsky@gmail.com>
Copyright (C) 2006 Marien Zwart <marienz@gentoo.org>
Copyright (C) 2006, 2007 Panoramic Feedback <abentley@panoramicfeedback.com>
All rights reserved.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Features
========
Supports all major Trac views and "changeset:" notation.
Allows a collection of branches to be treated as a "trac repository",
regardless of whether they are related or in the same bzr repository.
Follows symlinks to branches
Requirements
============
Python 2.4
----------
This plugin uses bzrlib directly, so it requires Python 2.4 or greater.
Bazaar 0.13
-----------
This has been tested with Bazaar 0.13. Earlier versions may or may not work.
Configuration
=============
After installing, you'll want to set the following values:
components
----------
This should include "tracbzr.* = enabled"
repository_dir
--------------
This should point at the directory containing your branches. This directory
does not have to be a repository. trac+bzr doesn't require branches to
be related, though that is permitted, of course.
repository_type
---------------
This should be "bzr".
You can also use "bzr+debug" for debug mode. In debug mode, all
repository operations are logged to the standard log output. (Turning this on
for one repository_dir may enable it for all of them.)
Limitations
===========
Bogus changesets
----------------
This plugin introduces the bogus changeset "current:", which is used as
the last-revision for directories that are not branches. It also provides
"null:", which is part of Bazaar's theoretical model, but usually hidden.
Hidden Nested Branches
----------------------
Because Trac, like Subversion, doesn't differentiate between "source file
namespace" and "branch namespace", it is impossible to view branches whose
directories are directly inside other branches' directories.
Speed issues
------------
Some user-level operations are rather slow, because Trac's assumptions
about which repository operations are cheap vs expensive doesn't match Bazaar's
design. In particular, Bzr doesn't track "which revision last modified files
in this directory." In theory, this can be solved by caching the results of
expensive operations.
Revision Order
--------------
Changesets are sorted by timestamp, so clock skew may cause some changesets
to be displayed out-of order. Changesets have only a partial ordering anyhow,
and this was deemed faster.
Bracket syntax
--------------
Trac appears not to recognize bzr revision strings in its bracket notation,
e.g. [tree,25]. However, you can use the changeset notation instead, e.g.
changeset:tree,25.
File encoding
-------------
Because at the moment Bazaar does not store information about encoding of text
files, you may want to change the default character set used by trac.
By default trac use encoding iso-8895-15 to show content of your files.
If you need to change this option, you need to edit trac.ini of your project.
In section "trac" you need to change parameter named "default_charset". E.g.
for russian files::
[trac]
default_charset = cp1251
.. vim: ft=rst
|