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