Synch to No Gnus 200604110611.
[elisp/gnus.git-] / README.branch
1 README.branch --- description of branches and tags. (DRAFT)
2 ========================================================================
3
4 Semi-gnus revision tree (2004-01-05)
5
6     vendor      personal    main trunk      public
7     branch      branches                    branches
8 ------------------------------------------------------------------------
9 qGnus 0.??  ------> Semi-gnus 6.0.0
10        :                        :
11        :        himi     <--  6.0.7
12        :    ichikawa <------  6.0.8
13        :       |                |
14        :     6.8.17 ---+        :
15        :       :       :        :
16        :               V        :
17        :         pgnus-ichikawa :
18        :               |        :
19        :             6.9.01     :
20        :               :        : (1999.07.02: turn into the public branch)
21        :               +-------->---------------+
22        :                        :               :
23        :                        :               V
24        :                        :            6.10.072 -----> t-gnus-6_12
25        :                        :               :     \      (for FLIM 1.12,
26        :                        :               :      \      stable)
27        :                        :               :       \
28        :                        :               :        --> t-gnus-6_13
29        :                        :               :            (for FLIM 1.13,
30        :                        :               :             develop)
31        :                        :               :               :
32        :                        :         t-gnus-6_10-last-  t-gnus-6_13-last-
33        :                        :               | feedback      |
34        :                        :               +<--------------+
35        :                        :               |               |
36        :            ------------<---------------+            t-gnus-6_14
37        : Oort Gnus /            :               |            (for FLIM 1.13,
38        :     |    |             :               :             develop)
39        :     V    V             :               :               |
40        :  t-gnus-6_15-quimby<---<-----(t-gnus-6_14-quimby)<-----+
41        :          |             :               :               |
42        :          |             :               | feedback      |
43        :          |             : (Gnus 5.8.8)->+<--------------+
44        :          |             :               |               |
45        :          |             :               |            t-gnus-6_15
46        :          +------------->--------------->----------> (for FLIM 1.14,
47        :                        :               |             develop)
48        :                        :               | feedback      |
49        :                        :  (Gnus 5.10)->+<--------------+
50        :                        :              /|\
51        :          +-------------<-------------- | ------------- +
52        :          |             :               :               |
53        :  t-gnus-6_16-quimby    :               :               V
54        :          |             :               :            t-gnus-6_16
55        :          +------------->--------------->----------> (for FLIM 1.14,
56        :                        :               :             develop)
57        :                        :               | feedback      |
58        :                        :(No Gnus 0.1)->+<--------------+
59        :                        :              /|\
60        :          +-------------<-------------- | --------------+
61        :          |             :               :               |
62        :  t-gnus-6_17-quimby    :               :               V
63        :          |             :               :            t-gnus-6_17
64        :          +------------->--------------->----------> (for FLIM 1.14,
65        :                        :               :             develop)
66        :        akr      <--  6.2.3             :               |
67        :        shuhei-k <--  6.3.1                             :
68 Gnus 5.6.11 ------>           6.3.3
69        :                      6.4.0 (for SEMI 1.5)
70        :                      (6.4.?)------> for SEMI 1.5
71        :                        |    \
72        :                        |     \
73 (Synch with original Gnus       |      ---> for SEMI 1.6
74  was done many times, but    (6.4.?)------> 6.5 (for SEMI 1.7)
75  we don't include them.)        |        /    6.5.0
76        :                        |    (?)/
77        :                        |   <---
78        :                     (6.5.?)------> 6.6 (for SEMI 1.8, FLIM 1.7)
79        :                        |    \        6.6.0        stable branch
80        :                        |     \
81        :                        |      ---> 6.7 (for SEMI 1.8, FLIM 1.7)
82        :                        |             6.7.0        stable branch
83        :     sync               |               :
84 Gnus 5.6.22 ------>             |   feedback  6.7.7
85        :                     (6.7.8)<------   6.7.8
86        :                        |    \
87        :                        |     \
88        :                        |      ---> 6.8 (for SEMI 1.8, FLIM 1.8)
89        :        keiichi  <--  6.8.18          6.8.0        stable branch
90        :     sync               |               :
91 Gnus 5.6.45 ------>             |   feedback  6.8.20
92        :                     (6.8.20)<------  6.8.20
93        :                        |     \
94        :                        |      \
95        :                        |       --> 6.9 (for SEMI 1.11, FLIM 1.12)
96        :                        |             6.9.1        stable branch
97        :                        |   feedback  6.9.2
98        :                     (6.9.2)<---------6.9.2
99        :                        |    \
100        :                        |     \
101        :                        |       --> 6.10 (for SEMI 1.12, FLIM 1.12)
102        :                        |             6.10.1      develop branch
103        :                        :               :
104        :                        :               :
105 ========================================================================
106
107 The Vendor Branch
108
109     Original version of Gnus.
110     Each version has a tag of the form "qgnus-0_XY" or "gnus-5_X_Y" or
111     "pgnus-0_XY".
112
113     The branch tag for the vendor branch is "larsi".
114
115 The Main Trunk
116
117     Semi-gnus was developed on the main trunk until current branch-
118     management plan (See "Public Branches" below) was introduced.
119     Each version has a tag of the form "gnus-6_N2_N3". (0 < N2 < 5)
120
121 Public Branches
122
123     Current main stream of Semi-gnus development.
124
125     [Goal and policy of public branches here ???]
126
127     Each branch has a tag of the form "gnus-N1_N2" and each version
128     has a tag of the form "gnus-N1_N2_N3".
129
130     N1, N2, and N3 are changed by the following rules.
131
132     N1 will be incremented if any fundamental architecture change is
133     made.  Of cource, in this case, N2 and N3 will be reset to zero.
134
135     N2 will be incremented and new branch will be made if any "major
136     changes" are made.  "major changes" include API changes, major
137     version up of original Gnus, or synchronization with original Gnus
138     which requires design decision.
139
140     N3 will be incremented if some "minor changes" are made.  "minor
141     changes" include small bug fix or synchronization with original Gnus
142     without design decision.
143
144     The following branch tags are currently available.
145
146         for-semi-1_5    Semi-gnus for SEMI 1.5 API
147         for-semi-1_6    Semi-gnus for SEMI 1.6 API
148         gnus-6_5        Semi-gnus for SEMI 1.7 API
149         gnus-6_6        Semi-gnus for SEMI 1.8, FLIM 1.7 API (stable)
150         gnus-6_7        Semi-gnus for SEMI 1.8, FLIM 1.7 API (stable)
151         gnus-6_8        Semi-gnus for SEMI 1.8, FLIM 1.8 API (stable)
152         gnus-6_9        Semi-gnus for SEMI 1.11, FLIM 1.12 API (stable)
153         gnus-6_10       Semi-gnus for SEMI 1.12, FLIM 1.12 API (develop)
154         pgnus-ichikawa  (Main trunk of T-gnus)
155         t-gnus-6_12     T-gnus for SEMI 1.12/1.13, FLIM 1.12 API (stable)
156         t-gnus-6_13     T-gnus for SEMI 1.13, FLIM 1.13 API (develop)
157         t-gnus-6_14     T-gnus for SEMI 1.13, FLIM 1.13 API (develop)
158         t-gnus-6_15     T-gnus for SEMI 1.14, FLIM 1.14 API (develop)
159         t-gnus-6_16     T-gnus for SEMI 1.14, FLIM 1.14 API (develop)
160         t-gnus-6_17     T-gnus for SEMI 1.14, FLIM 1.14 API (develop)
161      t-gnus-6_17-quimby T-gnus for SEMI 1.14, FLIM 1.14 API (develop)
162
163     Note: T-gnus versions 6.15 based on Oort Gnus v0.03 and earlier
164           had supported SEMI 1.13 and FLIM 1.13 as well.
165
166 Personal Branches
167
168     Some Semi-gnus developers have their own "personal branches".
169     Each personal branch may have its own goal and/or policy.
170     See README.${tag} (if exists) for information of each branch.
171
172     The following branch tags are curretly available.
173
174         himi            Owner: Miyashita Hisashi
175         ichikawa        Owner: Tatsuya Ichikawa
176         akr             Owner: Tanaka Akira
177         shuhei-k        Owner: Shuhei KOBAYASHI
178         keiichi         Owner: Keiichi Suzuki
179
180 "semi-gnus" Tag
181
182     Was assigned to the latest stable version.
183     Currently not maintained. (XXX: ???)
184
185 "for-semi-N1_N2" Tags
186
187     Were assigned to corresponding version of SEMI API N1.N2.
188     We will not use this convention any longer. (XXX: ???)