isabelle: Admin/Release/CHECKLIST@b2889dd54a2a (annotated)

13447 3470596f3cd5 updated; wenzelm parents: diff changeset	1	Checklist for official releases
3470596f3cd5 updated; wenzelm parents: diff changeset	2	===============================
3470596f3cd5 updated; wenzelm parents: diff changeset	3
62354 fdd6989cc8a0 SML/NJ is no longer supported; wenzelm parents: 62238 diff changeset	4	- check latest updates of polyml, jdk, scala, jedit;
50647 58312dae25a5 updated for release; wenzelm parents: 49004 diff changeset	5
76465 2b19c70c44c2 more TODO for release; wenzelm parents: 76378 diff changeset	6	- check isabelle.Dotnet_Setup.default_version:
2b19c70c44c2 more TODO for release; wenzelm parents: 76378 diff changeset	7	$ isabelle dotnet_setup -n -v -V "" \| grep invocation
2b19c70c44c2 more TODO for release; wenzelm parents: 76378 diff changeset	8
50647 58312dae25a5 updated for release; wenzelm parents: 49004 diff changeset	9	- check Admin/components;
58312dae25a5 updated for release; wenzelm parents: 49004 diff changeset	10
78781 847739805b8d disable naproche component for now: to be updated before the next Isabelle release; wenzelm parents: 78145 diff changeset	11	- Admin/components/bundled: update naproche;
847739805b8d disable naproche component for now: to be updated before the next Isabelle release; wenzelm parents: 78145 diff changeset	12
71431 508b4f6431ae updated for release; wenzelm parents: 71289 diff changeset	13	- test "isabelle dump -b Pure ZF";
68544 8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	14
69956 800ec9074701 proper command-line; wenzelm parents: 69691 diff changeset	15	- test "isabelle build -o export_theory -f ZF";
68544 8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	16
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	17	- test "isabelle server" according to "system" manual;
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	18
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	19	- test Isabelle/VSCode;
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	20
66647 6666fced78cc updated for release; wenzelm parents: 66609 diff changeset	21	- test Isabelle/jEdit: print buffer
6666fced78cc updated for release; wenzelm parents: 66609 diff changeset	22
74001 118057a1093b more tests; wenzelm parents: 73987 diff changeset	23	- test Isabelle/jEdit: deactivate main plugin;
118057a1093b more tests; wenzelm parents: 73987 diff changeset	24
75410 832f764093e1 avoid static access to sun.tools.jconsole: more robust compilation (notably with scala3), but less robust invocation; wenzelm parents: 75186 diff changeset	25	- test "isabelle java_monitor -P pid" with "isabelle jedit";
832f764093e1 avoid static access to sun.tools.jconsole: more robust compilation (notably with scala3), but less robust invocation; wenzelm parents: 75186 diff changeset	26
80088 5afbf04418ec avoid Scala if-expressions and thus make it work both for -new-syntax or -old-syntax; wenzelm parents: 79792 diff changeset	27	- test "isabelle build HOL-Codegenerator_Test" with -new-syntax
5afbf04418ec avoid Scala if-expressions and thus make it work both for -new-syntax or -old-syntax; wenzelm parents: 79792 diff changeset	28	(see also etc/settings:ISABELLE_SCALAC_OPTIONS);
5afbf04418ec avoid Scala if-expressions and thus make it work both for -new-syntax or -old-syntax; wenzelm parents: 79792 diff changeset	29
80150 96f60533ec1d update Windows test machines; wenzelm parents: 80088 diff changeset	30	- test Windows Subsystem for Linux (e.g. on Windows Server 2022);
68591 90381a0f5474 more manual tests; wenzelm parents: 68573 diff changeset	31
69169 a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	32	- check (non-)executable files:
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	33	$ find . "(" -name ".thy" -o -name ".ML" -o -name "*.scala" -o -name ROOT ")" -executable
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	34	$ find -type f -executable
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	35
56829 f151ade98b15 proper tool wrap-up; wenzelm parents: 56824 diff changeset	36	- check sources:
62452 f25b67245699 more official "isabelle check_sources"; wenzelm parents: 62354 diff changeset	37	isabelle check_sources '~~' '$AFP_BASE'
53665 ea8343187225 adhoc check of ML sources, in addition to thy files already covered in Thy_Load; wenzelm parents: 53660 diff changeset	38
37368 1c816f2abb0e removed outdated/confusing INSTALL file; wenzelm parents: 37285 diff changeset	39	- check ANNOUNCE, README, NEWS, COPYRIGHT, CONTRIBUTORS;
30888 a8f9e12d815e misc updates for Isabelle2009; wenzelm parents: 30852 diff changeset	40
66477 7dccaa6d419a updated for release; wenzelm parents: 65567 diff changeset	41	- check versions:
74426 61a6fd4f9862 misc tuning for release; wenzelm parents: 74001 diff changeset	42	src/Tools/jEdit/jedit_base/plugin.props
61a6fd4f9862 misc tuning for release; wenzelm parents: 74001 diff changeset	43	src/Tools/jEdit/jedit_main/plugin.props
66598 e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	44	src/Tools/VSCode/extension/package.json
e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	45
41617 0f98d8f27912 more release checks; wenzelm parents: 41608 diff changeset	46	- check funny base directory, e.g. "Test 中国";
0f98d8f27912 more release checks; wenzelm parents: 41608 diff changeset	47
36860 d9338f121406 check NEWS; wenzelm parents: 36858 diff changeset	48	- diff NEWS wrt. last official release, which is read-only;
d9338f121406 check NEWS; wenzelm parents: 36858 diff changeset	49
69691 9c6651cd6141 clarified URLs: prefer sketis over bitbucket; wenzelm parents: 69435 diff changeset	50	- update https://isabelle.sketis.net/repos/isabelle-website
13447 3470596f3cd5 updated; wenzelm parents: diff changeset	51
73987 fc363a3b690a build.props for isabelle.jar, including isabelle.jedit; wenzelm parents: 73607 diff changeset	52	- check doc/Contents, $JEDIT_HOME/doc/Contents;
13447 3470596f3cd5 updated; wenzelm parents: diff changeset	53
72894 bd2269b6cd99 updated "macOS" terminology: current Big Sur is already version 11; wenzelm parents: 72793 diff changeset	54	- test old HD display: Linux, Windows, macOS;
57624 a7acd2d8c2fb enable hires explictly, as seen for other high-end Java applications on the Web; wenzelm parents: 57454 diff changeset	55
72894 bd2269b6cd99 updated "macOS" terminology: current Big Sur is already version 11; wenzelm parents: 72793 diff changeset	56	- macOS: check recent MacTeX;
59980 070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	57
070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	58	- Windows: check recent MiKTeX;
070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	59
71289 16e3662217e9 more checks for release; wenzelm parents: 70330 diff changeset	60	- Phabricator:
16e3662217e9 more checks for release; wenzelm parents: 70330 diff changeset	61	. src/Doc/System/Phabricator.thy: check/update underlying Ubuntu version
71431 508b4f6431ae updated for release; wenzelm parents: 71289 diff changeset	62	. etc/options: check/update phabricator_version entries;
71289 16e3662217e9 more checks for release; wenzelm parents: 70330 diff changeset	63
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	64
54052 797ae756d64d more notes; wenzelm parents: 53979 diff changeset	65	Repository fork
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	66	===============
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	67
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	68	- isabelle: finalize NEWS / CONTRIBUTORS -- proper headers for named release;
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	69
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	70	- isabelle-release: hg tag;
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	71
54053 ad5e2ed466ac tuned; wenzelm parents: 54052 diff changeset	72	- isabelle: back to post-release mode -- after fork point;
54052 797ae756d64d more notes; wenzelm parents: 53979 diff changeset	73
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	74
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	75	Packaging
f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	76	=========
f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	77
76193 83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	78	- regular packaging:
83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	79
79792 98f009f56400 updated for release; wenzelm parents: 79059 diff changeset	80	#on fast Linux machine, with access to build_host for each platform
98f009f56400 updated for release; wenzelm parents: 79059 diff changeset	81	Admin/build_release -D ~/tmp/isadist -b HOL -R Isabelle2024 -j2 -l
41600 46d65140c5de some notes on final release stage; wenzelm parents: 41598 diff changeset	82
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	83	- Docker image:
6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	84
79792 98f009f56400 updated for release; wenzelm parents: 79059 diff changeset	85	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2024 Isabelle2024_linux.tar.gz
98f009f56400 updated for release; wenzelm parents: 79059 diff changeset	86	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2024_X11_Latex -P X11 -P latex Isabelle2024_linux.tar.gz
76193 83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	87
79792 98f009f56400 updated for release; wenzelm parents: 79059 diff changeset	88	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2024_ARM Isabelle2024_linux_arm.tar.gz
98f009f56400 updated for release; wenzelm parents: 79059 diff changeset	89	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2024_ARM_X11_Latex -P X11 -P latex Isabelle2024_linux_arm.tar.gz
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	90
73258 fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	91	docker login
fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	92
79792 98f009f56400 updated for release; wenzelm parents: 79059 diff changeset	93	docker push makarius/isabelle:Isabelle2024
73258 fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	94
73299 43ce3b8a25ee proper "latest" tag, otherwise the default pull command from https://hub.docker.com/r/makarius/isabelle won't work; wenzelm parents: 73258 diff changeset	95	docker tag ... latest
43ce3b8a25ee proper "latest" tag, otherwise the default pull command from https://hub.docker.com/r/makarius/isabelle won't work; wenzelm parents: 73258 diff changeset	96	docker push makarius/isabelle:latest
43ce3b8a25ee proper "latest" tag, otherwise the default pull command from https://hub.docker.com/r/makarius/isabelle won't work; wenzelm parents: 73258 diff changeset	97
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	98	https://hub.docker.com/r/makarius/isabelle
70330 312e4a40db01 proper URL; wenzelm parents: 70104 diff changeset	99	https://docs.docker.com/engine/reference/commandline/push
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	100
41600 46d65140c5de some notes on final release stage; wenzelm parents: 41598 diff changeset	101
47977 455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	102	Post-release
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	103	============
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	104
76374 8c1ba8907c6b official release; wenzelm parents: 76369 diff changeset	105	- update .hgtags
8c1ba8907c6b official release; wenzelm parents: 76369 diff changeset	106
73478 1be70e3de751 record official releases that follow a certain structure, with public access via https://isabelle.sketis.net/repos/isabelle/raw-file/tip/Admin/Release/official (NB: Isabelle2013-1 had to be retracted); wenzelm parents: 73299 diff changeset	107	- update Admin/Release/official
1be70e3de751 record official releases that follow a certain structure, with public access via https://isabelle.sketis.net/repos/isabelle/raw-file/tip/Admin/Release/official (NB: Isabelle2013-1 had to be retracted); wenzelm parents: 73299 diff changeset	108
74653 cfe295b2e6e5 update paths at TUM; wenzelm parents: 74426 diff changeset	109	- update /p/home/isabelle and /p/home/isabelle/html-data

author	Fabian Huch <huch@in.tum.de>
	Mon, 03 Jun 2024 19:21:22 +0200
changeset 80243	b2889dd54a2a
parent 80150	96f60533ec1d
child 81740	9f0cee195ee9
permissions	-rw-r--r--