← Back to branch summary

~ubuntu-branches/debian/sid/trac-bzr/sid

« back to all changes in this revision

Viewing changes to HACKING

  • Committer: Bazaar Package Importer
  • Author(s): Jelmer Vernooij
  • Date: 2010-03-05 19:17:52 UTC
  • mto: This revision was merged to the branch mainline in revision 6.
  • Revision ID: james.westby@ubuntu.com-20100305191752-6l2m7eaaxqop7or9
Tags: upstream-0.3.2
Import upstream version 0.3.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
HACKING
14
14
  a revision id by itself wouldn't give us an absolute path in that
15
15
  tree if there were multiple branches containing that revision.
16
16
 
 
17
- Since Trac assumes revision numbers are global (as they are for svn)
 
18
  and it doesn't give enough context for queries (e.g. path), there's no
 
19
  way around this for now.  This may change in the future when multi-repo
 
20
  support is available (Trac 0.12).
 
21
 
17
22
- If there is only a single branch at the root of the directory
18
23
  configured as the bzr repository in Trac, then no branch name will
19
24
  be included in revision strings. In this case, simple revision
21
26
  trac-bzr will allow users to configure a "default branch" to obtain
22
27
  simple revision names even when dealing with multiple branches.
23
28
 
 
29
- In order to be able to use simple revision numbers in TracLinks, one could
 
30
  write a wiki syntax parser which translates e.g. specifications like
 
31
  ``[tracsource:/foo/bar/baz@10]`` into link to the source browser with full
 
32
  revision specification (i.e. ``.../browser/foo/bar/baz?rev=foo,10``) while
 
33
  making sure things are unambiguous.
 
34
 
 
35
- The way revision numbers are displayed in the source browser is controlled
 
36
  by Trac's internal Genshi template.  In Trac >= 0.11 it would be possible
 
37
  to affect that by writing a component which would act as postprocessing
 
38
  hook with it's own Genshi template which reformats such links (i.e. the
 
39
  hrefs would still need to use the same format but the visible text can be
 
40
  rendered as simple numbers, e.g. check the ``Branches`` macro).
 
41
 
24
42
- When generating revision strings, we prefer (dotted) revision
25
43
  numbers over bzr revision identifiers. Only when the revision in
26
44
  question hasn't been merged into that branch yet we emit a revision