2 - branch in refs/topbloke-tips/<full-name>
3 contains the working version, fast-forwarding
4 - branch in refs/topbloke-bases/<full-name>
5 contains the base version, being the pulling
8 In-tree, there are metadata files in .topbloke
10 msg brach "commit message"
12 deps direct dependencies, one per line
15 /refs/heads/<something>
17 included actual included branches, one per line
20 flags flags that apply to this branch, one per line
21 unknown flags starting with [a-z] are ok;
22 otherwise fatal. Currently defined flags:
23 Deleted branch is deleted
25 .gitattributes Sets the attributes
28 <full-name> has the format:
29 <email>@<domain.name>/<yyyy>-<mm>-<dd>T<hh><mm><ss>Z/<nickname-path>
30 where nickname-path's first component must not start with a digit
31 contain ~ or @ (: is not allowed in refs hence the squashing)
33 ijackson@chiark.greenend.org.uk/2012-01-20T225127Z/reorg/sponge
34 NB only exactly that date format is allowed and timezone must be Z.
36 Branches may be specified as
37 [<qualifier>/...]<nickname-path-spec>
38 where <qualifier>/ is one of
39 [<email>]@[<domain.name>/
40 Only branches matching the specified email local part
43 A prefix of the ISO8601 date spec, stopping
44 just after a numeric component (or at the end)
45 [<approx-date-containing-~>/]
46 Intepreted by date -d after ~s have been replaced by
47 spaces. When we come to select, take the branch
48 nearest that date rather than the most recent
51 <nickname-path-spec> may be
53 ./<nickname-new-leaf-component>
54 ../<nickname-path-spec>
57 <approximate date spec containing at least one ~>
58 means all branches are candidates
60 So overall, if the current branch is
61 ijackson@chiark.greenend.org.uk/2011-08-20T120320Z/fixes/pudding
62 then all of the following can refer to the same branch
70 ijackson@/reorg/sponge
71 ijackson@/2012/reorg/sponge
72 ijackson@chiark.greenend.org.uk/reorg/sponge
73 ijackson@chiark.greenend.org.uk/2012-01-20T225127Z/reorg/sponge
76 1. prefer branches with email address (or domain)
77 matching current branch
78 2. prefer branches with our own email address (or domain)
80 Within this there may be branches with multiple dates; prefer the most