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