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