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