Commit | Line | Data |
---|---|---|
2732830a | 1 | This is a checklist for making Guile releases. |
251ca7ab JB |
2 | It's specific to the FSF's development environment; please don't put |
3 | it in the distribution. | |
2732830a | 4 | |
caa8de98 JB |
5 | In release 1.2: |
6 | - note that #/ syntax is going to go away. | |
7 | ||
8 | In release 1.3: | |
9 | - make #/ generate a warning. | |
10 | ||
11 | In release 1.4: | |
12 | - remove #/ syntax | |
13 | ||
2732830a JB |
14 | 1) Verify that Guile builds and runs in your working directory. I |
15 | hope that we'll eventually have a test suite to make this more | |
16 | concrete, but for the moment, just make sure things seem sane. | |
17 | 2) Make sure NEWS and the docs are up to date: | |
18 | a) Scan the ChangeLogs for user-visible changes, marked with an asterisk | |
19 | at the left margin. | |
20 | b) Update NEWS and the Texinfo documentation as appropriate. | |
21 | c) Remove the user-visible markers from the log entries once they're | |
22 | documented. | |
fa3f45cc JB |
23 | 3) Scan output from `cvs log' to find files that have changed a lot, but |
24 | do not have up-to-date copyright notices. | |
25 | 4) Update the version numbers in GUILE-VERSION, and README, to remove the | |
9986a72f JB |
26 | "unreleased" indications. They should be straight numbers, of the form |
27 | "N.M", not alpha numbers, of the form "N.Ma". | |
8225b156 JB |
28 | 5) Choose new interface numbers for shared libraries. |
29 | 6) Do a `cvs update -A', to get rid of any sticky tags. | |
30 | 7) Commit all changes to the CVS repository. | |
31 | 8) Verify that the disty works, too: | |
2732830a JB |
32 | a) Make a disty, using 'make dist'. |
33 | b) Unpack it somewhere else. | |
34 | c) Remove automake and autoconf from your path, or turn off their | |
d8bb5a39 JB |
35 | execute bits, or something. (Users should be able to build disty |
36 | without installing those tools.) | |
2732830a JB |
37 | d) Configure, make, and install. |
38 | e) Test the installed version; don't forget to unset SCHEME_LOAD_PATH. | |
fa3f45cc | 39 | f) If you made any fixes, commit them, and start from a) again |
8225b156 JB |
40 | 9) Tag the entire source tree with a tag of the form "release_N_M". |
41 | 10) Copy the tar file over to the GNU machines, and ask the appropriate | |
42 | person to put it on prep. At the time of this writing, Daniel Hagerty | |
43 | <hag@ai.mit.edu> has been generous about helping with that. | |
44 | 11) Send an announcement message to gnu-announce@prep.ai.mit.edu. If I | |
fa3f45cc JB |
45 | remember correctly, the moderator will delay it until the tar file |
46 | appears on prep. The announcement text should be mostly taken from | |
47 | Guile's README file. | |
8225b156 | 48 | 12) Tweak the version numbers in GUILE-VERSION, and README to indicate that |
9986a72f JB |
49 | the sources are snapshot again. Snapshots should have version numbers |
50 | of the form "N.Ma", where the "a" means "alpha". | |
8225b156 JB |
51 | 13) Start a new section of the NEWS file. |
52 | 14) Send mail to majordomo-owner@cygnus.com updating the message you get | |
538c267a | 53 | when you ask majordomo for "info guile". |