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