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.3: |
6 | - make #/ generate a warning. | |
d33e93c1 | 7 | - make SCHEME_LOAD_PATH generate a warning. |
17061108 JB |
8 | - Perry Metzger <perry@piermont.com> is willing to do beta-testing |
9 | for NetBSD. | |
caa8de98 JB |
10 | |
11 | In release 1.4: | |
12 | - remove #/ syntax | |
d33e93c1 | 13 | - Remove SCHEME_LOAD_PATH. |
caa8de98 | 14 | |
cc914709 JB |
15 | Platforms for test builds: |
16 | SunOS (gcc and pcc) --- galapas.ai.mit.edu | |
17 | Solaris (gcc and SUN cc) --- saturn.ai.mit.edu | |
18 | NetBSD (gcc) --- repo-man.ai.mit.edu (use /home/repo/jimb) | |
19 | HP/UX (gcc, HP cc) --- nutrimat.gnu.ai.mit.edu | |
20 | ||
21 | ||
2732830a JB |
22 | 1) Verify that Guile builds and runs in your working directory. I |
23 | hope that we'll eventually have a test suite to make this more | |
24 | concrete, but for the moment, just make sure things seem sane. | |
25 | 2) Make sure NEWS and the docs are up to date: | |
26 | a) Scan the ChangeLogs for user-visible changes, marked with an asterisk | |
27 | at the left margin. | |
28 | b) Update NEWS and the Texinfo documentation as appropriate. | |
29 | c) Remove the user-visible markers from the log entries once they're | |
30 | documented. | |
9e2310a8 | 31 | d) Check for any [[incomplete]] sections of NEWS. |
fa3f45cc JB |
32 | 3) Scan output from `cvs log' to find files that have changed a lot, but |
33 | do not have up-to-date copyright notices. | |
34 | 4) Update the version numbers in GUILE-VERSION, and README, to remove the | |
9986a72f JB |
35 | "unreleased" indications. They should be straight numbers, of the form |
36 | "N.M", not alpha numbers, of the form "N.Ma". | |
a14e4791 JB |
37 | 5) Set up README appropriately for the release; check name spellings |
38 | in THANKS, and reformat. | |
c484bf7f JB |
39 | 6) Choose new interface numbers for shared libraries. |
40 | 7) Do a `cvs update -A', to get rid of any sticky tags. | |
2bb68285 JB |
41 | 8) Rebuild all generated files in the source tree: |
42 | a) Check that the versions of aclocal, automake, autoconf, and autoheader | |
43 | in your PATH match those given in README. | |
44 | a) Install the .m4 files where aclocal will find them. | |
45 | b) Run aclocal. | |
46 | c) Run automake. | |
47 | d) Run autoconf. | |
48 | e) Run autoheader. | |
49 | 9) Commit all changes to the CVS repository. | |
50 | 10) Verify that the disty works, too: | |
51 | a) Make a disty, using 'make dist'. | |
52 | b) Unpack it somewhere else. | |
53 | c) Remove automake and autoconf from your path, or turn off their | |
54 | execute bits, or something. (Users should be able to build disty | |
55 | without installing those tools.) | |
56 | d) Configure, make, and install. | |
57 | e) Test the installed version; don't forget to unset SCHEME_LOAD_PATH. | |
58 | f) If you made any fixes, commit them, and start from a) again | |
59 | 11) Tag the entire source tree with a tag of the form "release_N_M". | |
60 | 12) Copy the tar file over to the GNU machines, and ask the appropriate | |
8225b156 JB |
61 | person to put it on prep. At the time of this writing, Daniel Hagerty |
62 | <hag@ai.mit.edu> has been generous about helping with that. | |
2bb68285 | 63 | 13) Send an announcement message to gnu-announce@gnu.org. Put |
c484bf7f JB |
64 | "Obtaining Guile" first, then a brief summary of the changes in |
65 | this release, then "Thanks," "About This Distribution," and | |
66 | "Nightly Snapshots." If I remember correctly, the moderator will | |
67 | delay it until the tar file appears on prep. The announcement | |
68 | text should be mostly taken from Guile's README file. | |
2bb68285 JB |
69 | 14) Notify freshmeat.net, although they're probably watching anyway. |
70 | 15) Tweak the version numbers in GUILE-VERSION, and README to indicate that | |
9986a72f JB |
71 | the sources are snapshot again. Snapshots should have version numbers |
72 | of the form "N.Ma", where the "a" means "alpha". | |
2bb68285 JB |
73 | 16) Start a new section of the NEWS file. |
74 | 17) Send mail to majordomo-owner@cygnus.com updating the message you get | |
538c267a | 75 | when you ask majordomo for "info guile". |