isabelle: Admin/Release/CHECKLIST@4b875a4c83b0 (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
82130 5888f0bec971 less ambitious test, thanks to 1126ee407227; wenzelm parents: 81787 diff changeset	13	- test "isabelle find_facts_index FOL && isabelle find_facts_server";
81783 9c62b9201e12 more to check; wenzelm parents: 81740 diff changeset	14
71431 508b4f6431ae updated for release; wenzelm parents: 71289 diff changeset	15	- test "isabelle dump -b Pure ZF";
68544 8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	16
69956 800ec9074701 proper command-line; wenzelm parents: 69691 diff changeset	17	- test "isabelle build -o export_theory -f ZF";
68544 8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	18
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	19	- test "isabelle server" according to "system" manual;
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	20
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	21	- test Isabelle/VSCode;
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	22
66647 6666fced78cc updated for release; wenzelm parents: 66609 diff changeset	23	- test Isabelle/jEdit: print buffer
6666fced78cc updated for release; wenzelm parents: 66609 diff changeset	24
74001 118057a1093b more tests; wenzelm parents: 73987 diff changeset	25	- test Isabelle/jEdit: deactivate main plugin;
118057a1093b more tests; wenzelm parents: 73987 diff changeset	26
75410 832f764093e1 avoid static access to sun.tools.jconsole: more robust compilation (notably with scala3), but less robust invocation; wenzelm parents: 75186 diff changeset	27	- 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	28
80088 5afbf04418ec avoid Scala if-expressions and thus make it work both for -new-syntax or -old-syntax; wenzelm parents: 79792 diff changeset	29	- 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	30	(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	31
80150 96f60533ec1d update Windows test machines; wenzelm parents: 80088 diff changeset	32	- test Windows Subsystem for Linux (e.g. on Windows Server 2022);
68591 90381a0f5474 more manual tests; wenzelm parents: 68573 diff changeset	33
69169 a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	34	- check (non-)executable files:
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	35	$ 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	36	$ find -type f -executable
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	37
56829 f151ade98b15 proper tool wrap-up; wenzelm parents: 56824 diff changeset	38	- check sources:
62452 f25b67245699 more official "isabelle check_sources"; wenzelm parents: 62354 diff changeset	39	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	40
37368 1c816f2abb0e removed outdated/confusing INSTALL file; wenzelm parents: 37285 diff changeset	41	- check ANNOUNCE, README, NEWS, COPYRIGHT, CONTRIBUTORS;
30888 a8f9e12d815e misc updates for Isabelle2009; wenzelm parents: 30852 diff changeset	42
66477 7dccaa6d419a updated for release; wenzelm parents: 65567 diff changeset	43	- check versions:
74426 61a6fd4f9862 misc tuning for release; wenzelm parents: 74001 diff changeset	44	src/Tools/jEdit/jedit_base/plugin.props
61a6fd4f9862 misc tuning for release; wenzelm parents: 74001 diff changeset	45	src/Tools/jEdit/jedit_main/plugin.props
66598 e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	46	src/Tools/VSCode/extension/package.json
e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	47
41617 0f98d8f27912 more release checks; wenzelm parents: 41608 diff changeset	48	- check funny base directory, e.g. "Test 中国";
0f98d8f27912 more release checks; wenzelm parents: 41608 diff changeset	49
36860 d9338f121406 check NEWS; wenzelm parents: 36858 diff changeset	50	- diff NEWS wrt. last official release, which is read-only;
d9338f121406 check NEWS; wenzelm parents: 36858 diff changeset	51
69691 9c6651cd6141 clarified URLs: prefer sketis over bitbucket; wenzelm parents: 69435 diff changeset	52	- update https://isabelle.sketis.net/repos/isabelle-website
13447 3470596f3cd5 updated; wenzelm parents: diff changeset	53
73987 fc363a3b690a build.props for isabelle.jar, including isabelle.jedit; wenzelm parents: 73607 diff changeset	54	- check doc/Contents, $JEDIT_HOME/doc/Contents;
13447 3470596f3cd5 updated; wenzelm parents: diff changeset	55
72894 bd2269b6cd99 updated "macOS" terminology: current Big Sur is already version 11; wenzelm parents: 72793 diff changeset	56	- 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	57
72894 bd2269b6cd99 updated "macOS" terminology: current Big Sur is already version 11; wenzelm parents: 72793 diff changeset	58	- macOS: check recent MacTeX;
59980 070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	59
070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	60	- Windows: check recent MiKTeX;
070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	61
82265 4b875a4c83b0 update for release; wenzelm parents: 82130 diff changeset	62	- Phorge:
71289 16e3662217e9 more checks for release; wenzelm parents: 70330 diff changeset	63	. src/Doc/System/Phabricator.thy: check/update underlying Ubuntu version
71431 508b4f6431ae updated for release; wenzelm parents: 71289 diff changeset	64	. etc/options: check/update phabricator_version entries;
71289 16e3662217e9 more checks for release; wenzelm parents: 70330 diff changeset	65
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	66
54052 797ae756d64d more notes; wenzelm parents: 53979 diff changeset	67	Repository fork
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	68	===============
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	69
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	70	- isabelle: finalize NEWS / CONTRIBUTORS -- proper headers for named release;
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	71
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	72	- isabelle-release: hg tag;
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	73
54053 ad5e2ed466ac tuned; wenzelm parents: 54052 diff changeset	74	- isabelle: back to post-release mode -- after fork point;
54052 797ae756d64d more notes; wenzelm parents: 53979 diff changeset	75
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	76
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	77	Packaging
f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	78	=========
f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	79
76193 83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	80	- regular packaging:
83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	81
79792 98f009f56400 updated for release; wenzelm parents: 79059 diff changeset	82	#on fast Linux machine, with access to build_host for each platform
82265 4b875a4c83b0 update for release; wenzelm parents: 82130 diff changeset	83	Admin/build_release -D ~/tmp/isadist -b HOL -R Isabelle2025 -j2 -l -F -L
41600 46d65140c5de some notes on final release stage; wenzelm parents: 41598 diff changeset	84
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	85	- Docker image:
6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	86
81740 9f0cee195ee9 update release name; wenzelm parents: 80150 diff changeset	87	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2025 Isabelle2025_linux.tar.gz
9f0cee195ee9 update release name; wenzelm parents: 80150 diff changeset	88	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2025_X11_Latex -P X11 -P latex Isabelle2025_linux.tar.gz
76193 83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	89
81740 9f0cee195ee9 update release name; wenzelm parents: 80150 diff changeset	90	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2025_ARM Isabelle2025_linux_arm.tar.gz
9f0cee195ee9 update release name; wenzelm parents: 80150 diff changeset	91	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2025_ARM_X11_Latex -P X11 -P latex Isabelle2025_linux_arm.tar.gz
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	92
73258 fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	93	docker login
fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	94
81740 9f0cee195ee9 update release name; wenzelm parents: 80150 diff changeset	95	docker push makarius/isabelle:Isabelle2025
73258 fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	96
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	97	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	98	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	99
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	100	https://hub.docker.com/r/makarius/isabelle
70330 312e4a40db01 proper URL; wenzelm parents: 70104 diff changeset	101	https://docs.docker.com/engine/reference/commandline/push
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	102
41600 46d65140c5de some notes on final release stage; wenzelm parents: 41598 diff changeset	103
47977 455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	104	Post-release
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	105	============
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	106
76374 8c1ba8907c6b official release; wenzelm parents: 76369 diff changeset	107	- update .hgtags
8c1ba8907c6b official release; wenzelm parents: 76369 diff changeset	108
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	109	- 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	110
74653 cfe295b2e6e5 update paths at TUM; wenzelm parents: 74426 diff changeset	111	- update /p/home/isabelle and /p/home/isabelle/html-data

author	wenzelm
	Wed, 12 Mar 2025 11:39:00 +0100
changeset 82265	4b875a4c83b0
parent 82130	5888f0bec971
permissions	-rw-r--r--