annotate admin/notes/BRANCH @ 106879:bd5f6908042c

Edit some notes/ files to replace `cvs' with `bzr', or something general.
author Glenn Morris <rgm@gnu.org>
date Sat, 16 Jan 2010 19:03:59 -0800
parents 8080c98e919f
children d5a9f1780d1e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
106879
bd5f6908042c Edit some notes/ files to replace `cvs' with `bzr', or something general.
Glenn Morris <rgm@gnu.org>
parents: 102135
diff changeset
1 This file describes the bzr branch in which it is maintained.
55428
7dd2d0d806e8 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
2 Everything below the line is branch-specific.
7dd2d0d806e8 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
3 ________________________________________________________________________
7dd2d0d806e8 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
4
102135
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
5 This is the trunk (sometimes mistakenly called "HEAD").
106879
bd5f6908042c Edit some notes/ files to replace `cvs' with `bzr', or something general.
Glenn Morris <rgm@gnu.org>
parents: 102135
diff changeset
6 When people say "use the development version of Emacs" or the
bd5f6908042c Edit some notes/ files to replace `cvs' with `bzr', or something general.
Glenn Morris <rgm@gnu.org>
parents: 102135
diff changeset
7 "bzr version of Emacs", this is the branch they are talking about.
102135
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
8
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
9 Emacs development takes place on the trunk. Most of the time, Emacs
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
10 hackers add to it relatively free of constraint (aside from proper
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
11 legal / accounting practices), although sometimes there is related
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
12 discussion on the emacs-devel mailing list.
55428
7dd2d0d806e8 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
13
102135
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
14 Sometime before the release of a new major version of Emacs (eg 22.1),
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
15 a "feature freeze" is imposed on the trunk. No new features may be
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
16 added after this point. This is usually many months before the release.
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
17 During this time, there is no official place for development of new features.
55428
7dd2d0d806e8 Initial revision
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
diff changeset
18
102135
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
19 Shortly before the release, a release branch is created. For example,
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
20 EMACS_22_BASE or EMACS_21_1_RC for Emacs 22.x and 21.x, respectively.
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
21 (Unfortunately the naming scheme has not always been consistent.)
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
22
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
23 The release branch is used to make the release (22.1), and all later
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
24 members of the series (22.2, 22.3, etc). Generally, only bug-fixes have
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
25 been allowed in the minor releases, although in 22.x, self-contained
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
26 new features were allowed on a case-by-case basis.
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
27
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
28 From the point that a release branch is created, the trunk is free for
8080c98e919f Update.
Glenn Morris <rgm@gnu.org>
parents: 55428
diff changeset
29 development for the next major version.