* README.semi.ja: Add keiichi and nana-gnus to the branches info. Modify the
[elisp/gnus.git-] / README.branch
1 README.branch --- description of branches and tags. (DRAFT)
2 ========================================================================
3
4 Semi-gnus revision tree (1999-01-19)
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        stable branch
44        :                        |   feedback  6.9.2
45        :                     (6.9.2)<---------6.9.2
46        :                        |    \
47        :                        |     \
48        :                        |       --> 6.10 (for SEMI 1.12, FLIM 1.12)
49        :                        |             6.10.1      develop branch
50        :                        :               :
51        :                        :               :
52 ========================================================================
53
54 The Vendor Branch
55
56     Original version of Gnus.
57     Each version has a tag of the form "qgnus-0_XY" or "gnus-5_X_Y" or
58     "pgnus-0_XY".
59
60     The branch tag for the vendor branch is "larsi".
61
62 The Main Trunk
63
64     Semi-gnus was developed on the main trunk until current branch-
65     management plan (See "Public Branches" below) was introduced.
66     Each version has a tag of the form "gnus-6_N2_N3". (0 < N2 < 5)
67
68 Public Branches
69
70     Current main stream of Semi-gnus development.
71
72     [Goal and policy of public branches here ???]
73
74     Each branch has a tag of the form "gnus-N1_N2" and each version
75     has a tag of the form "gnus-N1_N2_N3".
76
77     N1, N2, and N3 are changed by the following rules.
78
79     N1 will be incremented if any fundamental architecture change is
80     made.  Of cource, in this case, N2 and N3 will be reset to zero.
81
82     N2 will be incremented and new branch will be made if any "major
83     changes" are made.  "major changes" include API changes, major
84     version up of original Gnus, or synchronization with original Gnus
85     which requires design decision.
86
87     N3 will be incremented if some "minor changes" are made.  "minor
88     changes" include small bug fix or synchronization with original Gnus
89     without design decision.
90
91     The following branch tags are currently available.
92
93         for-semi-1_5    Semi-gnus for SEMI 1.5 API
94         for-semi-1_6    Semi-gnus for SEMI 1.6 API
95         gnus-6_5        Semi-gnus for SEMI 1.7 API
96         gnus-6_6        Semi-gnus for SEMI 1.8, FLIM 1.7 API (stable)
97         gnus-6_7        Semi-gnus for SEMI 1.8, FLIM 1.7 API (stable)
98         gnus-6_8        Semi-gnus for SEMI 1.8, FLIM 1.8 API (stable)
99         gnus-6_9        Semi-gnus for SEMI 1.11, FLIM 1.12 API (stable)
100         gnus-6_10       Semi-gnus for SEMI 1.12, FLIM 1.12 API (develop)
101
102 Personal Branches
103
104     Some Semi-gnus developers have their own "personal branches".
105     Each personal branch may have its own goal and/or policy.
106     See README.${tag} (if exists) for information of each branch.
107
108     The following branch tags are curretly available.
109
110         himi            Owner: Miyashita Hisashi
111         ichikawa        Owner: Tatsuya Ichikawa
112         akr             Owner: Tanaka Akira
113         shuhei-k        Owner: Shuhei KOBAYASHI
114         pgnus-ichikawa  Owner: Tatsuya Ichikawa
115         keiichi         Owner: Keiichi Suzuki
116
117 "semi-gnus" Tag
118
119     Was assigned to the latest stable version.
120     Currently not maintained. (XXX: ???)
121
122 "for-semi-N1_N2" Tags
123
124     Were assigned to corresponding version of SEMI API N1.N2.
125     We will not use this convention any longer. (XXX: ???)