isabelle: Admin/Release/CHECKLIST@123bbc715ec9 (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
71431 508b4f6431ae updated for release; wenzelm parents: 71289 diff changeset	11	- test "isabelle dump -b Pure ZF";
68544 8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	12
69956 800ec9074701 proper command-line; wenzelm parents: 69691 diff changeset	13	- test "isabelle build -o export_theory -f ZF";
68544 8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	14
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	15	- test "isabelle server" according to "system" manual;
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	16
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	17	- test Isabelle/VSCode;
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	18
66647 6666fced78cc updated for release; wenzelm parents: 66609 diff changeset	19	- test Isabelle/jEdit: print buffer
6666fced78cc updated for release; wenzelm parents: 66609 diff changeset	20
74001 118057a1093b more tests; wenzelm parents: 73987 diff changeset	21	- test Isabelle/jEdit: deactivate main plugin;
118057a1093b more tests; wenzelm parents: 73987 diff changeset	22
53583 b78eccad3939 more CHECKLIST; wenzelm parents: 53416 diff changeset	23	- test "#!/usr/bin/env isabelle_scala_script";
b78eccad3939 more CHECKLIST; wenzelm parents: 53416 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
68591 90381a0f5474 more manual tests; wenzelm parents: 68573 diff changeset	27	- test Windows 10 subsystem for Linux:
90381a0f5474 more manual tests; wenzelm parents: 68573 diff changeset	28	https://docs.microsoft.com/en-us/windows/wsl/install-win10
90381a0f5474 more manual tests; wenzelm parents: 68573 diff changeset	29
69169 a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	30	- check (non-)executable files:
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	31	$ 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	32	$ find -type f -executable
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	33
56829 f151ade98b15 proper tool wrap-up; wenzelm parents: 56824 diff changeset	34	- check sources:
62452 f25b67245699 more official "isabelle check_sources"; wenzelm parents: 62354 diff changeset	35	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	36
37368 1c816f2abb0e removed outdated/confusing INSTALL file; wenzelm parents: 37285 diff changeset	37	- check ANNOUNCE, README, NEWS, COPYRIGHT, CONTRIBUTORS;
30888 a8f9e12d815e misc updates for Isabelle2009; wenzelm parents: 30852 diff changeset	38
66477 7dccaa6d419a updated for release; wenzelm parents: 65567 diff changeset	39	- check versions:
74426 61a6fd4f9862 misc tuning for release; wenzelm parents: 74001 diff changeset	40	src/Tools/jEdit/jedit_base/plugin.props
61a6fd4f9862 misc tuning for release; wenzelm parents: 74001 diff changeset	41	src/Tools/jEdit/jedit_main/plugin.props
66598 e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	42	src/Tools/VSCode/extension/package.json
e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	43
41617 0f98d8f27912 more release checks; wenzelm parents: 41608 diff changeset	44	- check funny base directory, e.g. "Test 中国";
0f98d8f27912 more release checks; wenzelm parents: 41608 diff changeset	45
36860 d9338f121406 check NEWS; wenzelm parents: 36858 diff changeset	46	- diff NEWS wrt. last official release, which is read-only;
d9338f121406 check NEWS; wenzelm parents: 36858 diff changeset	47
69691 9c6651cd6141 clarified URLs: prefer sketis over bitbucket; wenzelm parents: 69435 diff changeset	48	- update https://isabelle.sketis.net/repos/isabelle-website
13447 3470596f3cd5 updated; wenzelm parents: diff changeset	49
73987 fc363a3b690a build.props for isabelle.jar, including isabelle.jedit; wenzelm parents: 73607 diff changeset	50	- check doc/Contents, $JEDIT_HOME/doc/Contents;
13447 3470596f3cd5 updated; wenzelm parents: diff changeset	51
72894 bd2269b6cd99 updated "macOS" terminology: current Big Sur is already version 11; wenzelm parents: 72793 diff changeset	52	- 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	53
72894 bd2269b6cd99 updated "macOS" terminology: current Big Sur is already version 11; wenzelm parents: 72793 diff changeset	54	- macOS: check recent MacTeX;
59980 070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	55
070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	56	- Windows: check recent MiKTeX;
070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	57
71289 16e3662217e9 more checks for release; wenzelm parents: 70330 diff changeset	58	- Phabricator:
16e3662217e9 more checks for release; wenzelm parents: 70330 diff changeset	59	. src/Doc/System/Phabricator.thy: check/update underlying Ubuntu version
71431 508b4f6431ae updated for release; wenzelm parents: 71289 diff changeset	60	. etc/options: check/update phabricator_version entries;
71289 16e3662217e9 more checks for release; wenzelm parents: 70330 diff changeset	61
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	62
54052 797ae756d64d more notes; wenzelm parents: 53979 diff changeset	63	Repository fork
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	64	===============
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	65
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	66	- isabelle: finalize NEWS / CONTRIBUTORS -- proper headers for named release;
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	67
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	68	- isabelle-release: hg tag;
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	69
54053 ad5e2ed466ac tuned; wenzelm parents: 54052 diff changeset	70	- isabelle: back to post-release mode -- after fork point;
54052 797ae756d64d more notes; wenzelm parents: 53979 diff changeset	71
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	72
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	73	Packaging
f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	74	=========
f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	75
76193 83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	76	- regular packaging:
83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	77
78145 2a28450b992b back to more concise build_release, thanks to build_host_macos = "mini3"; wenzelm parents: 78143 diff changeset	78	#on fast Linux machine, with access to Linux + Apple ARM + Windows build_host
2a28450b992b back to more concise build_release, thanks to build_host_macos = "mini3"; wenzelm parents: 78143 diff changeset	79	Admin/build_release -D ~/tmp/isadist -b HOL -R Isabelle2023 -j2 -l -c .../naproche-XYZ
76378 c0566b6f6ca8 formal bundling for Admin/build_release: avoid confusion about presence or absence in manual invocations; wenzelm parents: 76374 diff changeset	80
78145 2a28450b992b back to more concise build_release, thanks to build_host_macos = "mini3"; wenzelm parents: 78143 diff changeset	81	#with access Linux ARM build_host, without "naproche" component
78143 7ea4f986e41a updated for release; wenzelm parents: 77577 diff changeset	82	Admin/build_release -D ~/tmp/isadist -b HOL -R Isabelle2023 -p linux_arm
41600 46d65140c5de some notes on final release stage; wenzelm parents: 41598 diff changeset	83
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	84	- Docker image:
6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	85
78143 7ea4f986e41a updated for release; wenzelm parents: 77577 diff changeset	86	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2023 Isabelle2023_linux.tar.gz
7ea4f986e41a updated for release; wenzelm parents: 77577 diff changeset	87	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2023_X11_Latex -P X11 -P latex Isabelle2023_linux.tar.gz
76193 83d465d71fc6 clarified packaging; wenzelm parents: 76188 diff changeset	88
78143 7ea4f986e41a updated for release; wenzelm parents: 77577 diff changeset	89	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2023_ARM Isabelle2023_linux_arm.tar.gz
7ea4f986e41a updated for release; wenzelm parents: 77577 diff changeset	90	isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2023_ARM_X11_Latex -P X11 -P latex Isabelle2023_linux_arm.tar.gz
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	91
73258 fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	92	docker login
fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	93
78143 7ea4f986e41a updated for release; wenzelm parents: 77577 diff changeset	94	docker push makarius/isabelle:Isabelle2023
73258 fdc76c10bb61 more hints; wenzelm parents: 73219 diff changeset	95
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	96	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	97	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	98
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	99	https://hub.docker.com/r/makarius/isabelle
70330 312e4a40db01 proper URL; wenzelm parents: 70104 diff changeset	100	https://docs.docker.com/engine/reference/commandline/push
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	101
41600 46d65140c5de some notes on final release stage; wenzelm parents: 41598 diff changeset	102
47977 455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	103	Post-release
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	104	============
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	105
76374 8c1ba8907c6b official release; wenzelm parents: 76369 diff changeset	106	- update .hgtags
8c1ba8907c6b official release; wenzelm parents: 76369 diff changeset	107
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	108	- 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	109
74653 cfe295b2e6e5 update paths at TUM; wenzelm parents: 74426 diff changeset	110	- update /p/home/isabelle and /p/home/isabelle/html-data

author	wenzelm
	Mon, 11 Sep 2023 23:13:23 +0200
changeset 78662	123bbc715ec9
parent 78145	2a28450b992b
child 78781	847739805b8d
permissions	-rw-r--r--