annotate README.MAINT @ 318:be4d471f3de5 lwlink-1.0

Moved old tags and branches for lwlink to global tags/branches dirs
author lost
date Wed, 28 Jan 2009 05:54:43 +0000
parents f14e82afdac7
children 69ead2e61763
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
293
f14e82afdac7 created project
lost
parents:
diff changeset
1 This file is intended for source package maintainers/distributors.
f14e82afdac7 created project
lost
parents:
diff changeset
2
f14e82afdac7 created project
lost
parents:
diff changeset
3 Before a release is made, a branch for that release must be made. Within
f14e82afdac7 created project
lost
parents:
diff changeset
4 that branch, all files that will be distributed with the particular release
f14e82afdac7 created project
lost
parents:
diff changeset
5 must be generated and added to the repository on that branch. Once the
f14e82afdac7 created project
lost
parents:
diff changeset
6 release is deemed stable and ready for release, the release tag should
f14e82afdac7 created project
lost
parents:
diff changeset
7 be generated from the head of that particular branch. Thus all release
f14e82afdac7 created project
lost
parents:
diff changeset
8 series will have the autotool generated files in the repository.
f14e82afdac7 created project
lost
parents:
diff changeset
9
f14e82afdac7 created project
lost
parents:
diff changeset
10 Any branch not directly intended to be a release need not include the
f14e82afdac7 created project
lost
parents:
diff changeset
11 autotool generated files.
f14e82afdac7 created project
lost
parents:
diff changeset
12
f14e82afdac7 created project
lost
parents:
diff changeset
13 The trunk development stream must not include the autotool generated files
f14e82afdac7 created project
lost
parents:
diff changeset
14 as these are likely to change rapidly and it can cause a great deal of
f14e82afdac7 created project
lost
parents:
diff changeset
15 confusion for little gain.
f14e82afdac7 created project
lost
parents:
diff changeset
16
f14e82afdac7 created project
lost
parents:
diff changeset
17 By including the generated files in the release branches, it is possible
f14e82afdac7 created project
lost
parents:
diff changeset
18 to replicate any problems users of the package may have, including if it
f14e82afdac7 created project
lost
parents:
diff changeset
19 is due to problems with the autotools themselves.
f14e82afdac7 created project
lost
parents:
diff changeset
20
f14e82afdac7 created project
lost
parents:
diff changeset
21
f14e82afdac7 created project
lost
parents:
diff changeset
22 Naming of branches and tags should conform to the following guidlines.
f14e82afdac7 created project
lost
parents:
diff changeset
23
f14e82afdac7 created project
lost
parents:
diff changeset
24 1. any branch leading to a release series must be named as the base revision
f14e82afdac7 created project
lost
parents:
diff changeset
25 of the series. Thus, for a 1.0 release, the branch is called 1.0 and will
f14e82afdac7 created project
lost
parents:
diff changeset
26 contain the results for a 1.0 release, a 1.0.1 release, and so on. If a
f14e82afdac7 created project
lost
parents:
diff changeset
27 sub-release will occur, say under 1.0.1, then a branch named "1.0.1" would
f14e82afdac7 created project
lost
parents:
diff changeset
28 be created and then releases such as 1.0.1.1 would be created. This should
f14e82afdac7 created project
lost
parents:
diff changeset
29 be avoided if at all possible.
f14e82afdac7 created project
lost
parents:
diff changeset
30
f14e82afdac7 created project
lost
parents:
diff changeset
31 2. any tag for a specific release version will be named as the release. So
f14e82afdac7 created project
lost
parents:
diff changeset
32 for a 1.0 release, the name would be "1.0". For version 1.0.1.1, the name
f14e82afdac7 created project
lost
parents:
diff changeset
33 would be "1.0.1.1".
f14e82afdac7 created project
lost
parents:
diff changeset
34
f14e82afdac7 created project
lost
parents:
diff changeset
35 3. branches not associated with a release stream - say for feature development
f14e82afdac7 created project
lost
parents:
diff changeset
36 or what have you should be named sensibly and should be removed when no longer
f14e82afdac7 created project
lost
parents:
diff changeset
37 needed. They must not appear to be version numbers.
f14e82afdac7 created project
lost
parents:
diff changeset
38
f14e82afdac7 created project
lost
parents:
diff changeset
39 4. tags not specifying a release must not look like version numbers