Mercurial > ~dholland > hg > ag > index.cgi

annotate doc/devel/versions.txt @ 21:1c9dac05d040

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add lint-style FALLTHROUGH annotations to fallthrough cases. (in the parse engine and thus the output code) Document this, because the old output causes warnings with gcc10.
author David A. Holland
date Mon, 13 Jun 2022 00:04:38 -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.