File: Checklist

package info (click to toggle)
icon 9.5.25a-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 15,624 kB
  • sloc: ansic: 28,692; cpp: 5,650; yacc: 926; makefile: 882; lisp: 873; sh: 319; sed: 13; php: 1
file content (70 lines) | stat: -rw-r--r-- 2,485 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
MODIFICATION CHECKLIST
<<ARIZONA-ONLY>>

Icon maintenance has evolved from infrequent formal releases to a system of
continual modifications that are immediately available publicly through GitHub.
When a set of changes is ready to go:

Set the version number and date (for &version) in src/h/version.h.
The date should be the date of modification, i.e. today's date.
The version number should be of the form  9.5.yyx  where
	yy is the last two digits of today's year
	x is an alphabetic sequence character within the year (a,b,c,...)

Update doc/relnotes or doc/faq if warranted, also changing the date at the top.

Do full rebuilds and tests, both with and without graphics.
Do this on multiple architectures if warranted by non-trivial edits.
Verify the appearance of &version as printed by the tests.
Update any config/*/status files as appropriate.

Check in the changes.
Set a Git "annotated" tag of the form "v9.5.yyx" (note the leading v):
	git tag -a "v9.5.yyx" -m "fix xxx yyy problem on zzz"
Push the mods *with the tag*:
	git push
	git push --tags

Propagate documentation changes to the website "ugide" directory.
Rebuild the IPL documentation if necessary.
Send an announcement to the Icon-language mailing list if warranted.


-------------------------------------------------------------------
The old checklist for periodic heavyweight releases was as follows:

review diffs; check vs release notes; check spelling
run manual gtests
run full library test script (ipl/CheckAll)
build & test on several platforms

set final value for &version
update version numbers in doc files
update date in man page files
grep for other places to update the version number
review docs especially acknowledgments
update FAQ
update README
run "make" in the doc directory

copy source and make Dist-Clean to prune ARIZONA-ONLY, .git, etc
install source package for distribution
make binary packages & put in place
make library package and test with Jcon
update Jcon copy of library

make new v9nn web directory and install docs
rebuild and install library reference pages
update other web pages to reference new version
edit configuration names on other pages (e.g. Mac, Cygwin)

install updated FAQ
sync FTP area 
update website status page
update other website pages
change redirection of /icon/current URLs (.htaccess AND symlink)
add "superseded" line to previous release index.htm
post announcement comp.lang.icon

tag distributed version in Git
modify &version setting in Git copy