annotate doc/devel/versions.txt @ 24:a4899cdfc2d6 default tip

Obfuscate the regexps to strip off the IBM compiler's copyright banners. I don't want bots scanning github to think they're real copyright notices because that could cause real problems.
author David A. Holland
date Mon, 13 Jun 2022 00:40:23 -0400
parents 12171da8943f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
1 Theory of AG version numbers (as of 20060806, updated 20070603, 20070613)
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
2
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
3
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
4 - Any version of AG has a "base version number". This is 2.01 for
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
5 2.01, 2.40 for the first public open source version, 2.50 for the
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
6 stable open source version, and 3.00 for the first GTK version,
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
7 whenever that appears. This version goes into the Windows registry.
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
8
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
9 - Development snapshots leading up to the first release with a
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
10 particular base version number are numbered with the new base version,
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
11 a dash, and the date or a release candidate number. Examples:
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
12 2.40-20070610; 2.40-RC2.
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
13
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
14 - Stable versions have the base version followed by a dot and the
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
15 build number, aka patchlevel. For example: 2.40.01.
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
16
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
17 - Every changeset committed to the stable branch causes a new build
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
18 and increments the build number. Needless to say, you don't commit to
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
19 the stable branch lightly.
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
20
17
12171da8943f Don't refer to CVS.
David A. Holland
parents: 0
diff changeset
21 - A development version built directly from a Mercurial or Git
0
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
22 working directory will be numbered 2.40-current, because it's difficult or
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
23 impossible to ascertain the proper date. Assuming the proper date is
17
12171da8943f Don't refer to CVS.
David A. Holland
parents: 0
diff changeset
24 even well defined; after all, most such builds happen while coding and
12171da8943f Don't refer to CVS.
David A. Holland
parents: 0
diff changeset
25 include uncommitted changes.
0
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
26
17
12171da8943f Don't refer to CVS.
David A. Holland
parents: 0
diff changeset
27 - A stable version built directly from a Mercurial or Git working
0
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
28 directory will be numbered 2.40.01-current.
13d2b8934445 Import AnaGram (near-)release tree into Mercurial.
David A. Holland
parents:
diff changeset
29
17
12171da8943f Don't refer to CVS.
David A. Holland
parents: 0
diff changeset
30 - Note that while injecting the last committed change hash in these
12171da8943f Don't refer to CVS.
David A. Holland
parents: 0
diff changeset
31 circumstances is possible, it isn't worthwhile.