isabelle: Admin/Release/CHECKLIST@eddcc7c726f3 (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
58312dae25a5 updated for release; wenzelm parents: 49004 diff changeset	6	- check Admin/components;
58312dae25a5 updated for release; wenzelm parents: 49004 diff changeset	7
68544 8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	8	- test "isabelle dump -l Pure ZF";
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	9
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	10	- test "isabelle -o export_theory -f ZF";
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	11
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	12	- test "isabelle server" according to "system" manual;
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	13
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	14	- test Isabelle/VSCode;
8285fa53bfac more manual tests; wenzelm parents: 67263 diff changeset	15
66647 6666fced78cc updated for release; wenzelm parents: 66609 diff changeset	16	- test Isabelle/jEdit: print buffer
6666fced78cc updated for release; wenzelm parents: 66609 diff changeset	17
53583 b78eccad3939 more CHECKLIST; wenzelm parents: 53416 diff changeset	18	- test "#!/usr/bin/env isabelle_scala_script";
b78eccad3939 more CHECKLIST; wenzelm parents: 53416 diff changeset	19
68591 90381a0f5474 more manual tests; wenzelm parents: 68573 diff changeset	20	- test Windows 10 subsystem for Linux:
90381a0f5474 more manual tests; wenzelm parents: 68573 diff changeset	21	https://docs.microsoft.com/en-us/windows/wsl/install-win10
90381a0f5474 more manual tests; wenzelm parents: 68573 diff changeset	22
69169 a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	23	- check (non-)executable files:
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	24	$ 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	25	$ find -type f -executable
a5640ec8fcb8 check (non-)executable files -- and eliminate them manually from the repository) wenzelm parents: 68738 diff changeset	26
56829 f151ade98b15 proper tool wrap-up; wenzelm parents: 56824 diff changeset	27	- check sources:
62452 f25b67245699 more official "isabelle check_sources"; wenzelm parents: 62354 diff changeset	28	isabelle check_sources '~~' '$AFP_BASE'
65567 c556c09765dd tuned documentation; wenzelm parents: 65565 diff changeset	29	isabelle imports -M -a -d '~~/src/Benchmarks'
53665 ea8343187225 adhoc check of ML sources, in addition to thy files already covered in Thy_Load; wenzelm parents: 53660 diff changeset	30
37368 1c816f2abb0e removed outdated/confusing INSTALL file; wenzelm parents: 37285 diff changeset	31	- check ANNOUNCE, README, NEWS, COPYRIGHT, CONTRIBUTORS;
30888 a8f9e12d815e misc updates for Isabelle2009; wenzelm parents: 30852 diff changeset	32
66477 7dccaa6d419a updated for release; wenzelm parents: 65567 diff changeset	33	- check versions:
7dccaa6d419a updated for release; wenzelm parents: 65567 diff changeset	34	src/Tools/jEdit/src/Isabelle.props
7dccaa6d419a updated for release; wenzelm parents: 65567 diff changeset	35	src/Tools/jEdit/src-base/Isabelle_Base.props
60295 3f0bb5c58dfa updated versions; wenzelm parents: 60294 diff changeset	36
66598 e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	37	- check Isabelle version:
e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	38	src/Tools/VSCode/extension/README.md
e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	39	src/Tools/VSCode/extension/package.json
e2671e8c476f VSCode extension for official Isabelle release; wenzelm parents: 66477 diff changeset	40
41617 0f98d8f27912 more release checks; wenzelm parents: 41608 diff changeset	41	- check funny base directory, e.g. "Test 中国";
0f98d8f27912 more release checks; wenzelm parents: 41608 diff changeset	42
68573 fb693268991a updated for release; wenzelm parents: 68544 diff changeset	43	- check scalable fonts, e.g. src/Doc/Prog_Prove
fb693268991a updated for release; wenzelm parents: 68544 diff changeset	44	(NOTE: T1 encoding requires cm-super fonts);
55367 f4bbfc2eeae8 check scalable fonts; wenzelm parents: 54053 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
62238 3cde0ea64727 tuned; wenzelm parents: 60763 diff changeset	50	- check doc/Contents, src/Tools/jEdit/dist/doc/Contents;
13447 3470596f3cd5 updated; wenzelm parents: diff changeset	51
62238 3cde0ea64727 tuned; wenzelm parents: 60763 diff changeset	52	- check Logics:
50647 58312dae25a5 updated for release; wenzelm parents: 49004 diff changeset	53	ROOTS
30852 59a422908e29 misc tuning for release; wenzelm parents: 30189 diff changeset	54	lib/html/library_index_content.template
13447 3470596f3cd5 updated; wenzelm parents: diff changeset	55
63899 dc036b1a2a6f misc updates; wenzelm parents: 63897 diff changeset	56	- HTML library: check HTML header;
dc036b1a2a6f misc updates; wenzelm parents: 63897 diff changeset	57
dc036b1a2a6f misc updates; wenzelm parents: 63897 diff changeset	58	- HTML library: check theory dependencies (PDF);
57876 7d45e47c2765 tuned; wenzelm parents: 57694 diff changeset	59
60032 7fcbdc4aeb8e tuned; wenzelm parents: 59980 diff changeset	60	- check "Handler catches all exceptions"
50784 cbc7002cc273 more CHECKLIST; wenzelm parents: 50647 diff changeset	61
57624 a7acd2d8c2fb enable hires explictly, as seen for other high-end Java applications on the Web; wenzelm parents: 57454 diff changeset	62	- Mac OS X: check app bundle with Retina display;
a7acd2d8c2fb enable hires explictly, as seen for other high-end Java applications on the Web; wenzelm parents: 57454 diff changeset	63
59980 070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	64	- Mac OS X: check recent MacTeX;
070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	65
57876 7d45e47c2765 tuned; wenzelm parents: 57694 diff changeset	66	- Windows: check dpi scaling with high-definition display;
7d45e47c2765 tuned; wenzelm parents: 57694 diff changeset	67
59980 070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	68	- Windows: check recent MiKTeX;
070f04c94b2e misc tuning for release; wenzelm parents: 59952 diff changeset	69
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	70
54052 797ae756d64d more notes; wenzelm parents: 53979 diff changeset	71	Repository fork
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	72	===============
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	73
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	74	- isabelle: finalize NEWS / CONTRIBUTORS -- proper headers for named release;
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	75
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	76	- isabelle-release: hg tag;
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	77
54053 ad5e2ed466ac tuned; wenzelm parents: 54052 diff changeset	78	- isabelle: back to post-release mode -- after fork point;
54052 797ae756d64d more notes; wenzelm parents: 53979 diff changeset	79
797ae756d64d more notes; wenzelm parents: 53979 diff changeset	80
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	81	Packaging
f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	82	=========
f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	83
63897 85c83757788c consolidate implicit use of gnutar, via somewhat fragile dynamic scoping within existing shell scripts; wenzelm parents: 63061 diff changeset	84	- Mac OS X: provide "gnutar" executable via shell PATH
85c83757788c consolidate implicit use of gnutar, via somewhat fragile dynamic scoping within existing shell scripts; wenzelm parents: 63061 diff changeset	85	(e.g. copy of /usr/bin/gnutar from Mountain Lion)
85c83757788c consolidate implicit use of gnutar, via somewhat fragile dynamic scoping within existing shell scripts; wenzelm parents: 63061 diff changeset	86
68573 fb693268991a updated for release; wenzelm parents: 68544 diff changeset	87	- fully-automated packaging (e.g. on lxbroy10):
37526 f4016fca4ff9 notes on packaging; wenzelm parents: 37368 diff changeset	88
69435 e18e4532fb42 clarified example: avoid unpacking into /home/isabelle/components at TUM; wenzelm parents: 69432 diff changeset	89	hg up -r DISTNAME && Admin/build_release -O -l -R DISTNAME -C ~/tmp/isadist/contrib /home/isabelle/dist
41600 46d65140c5de some notes on final release stage; wenzelm parents: 41598 diff changeset	90
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	91	- Docker image:
6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	92
68738 34b8ff7cb109 updated for release; wenzelm parents: 68591 diff changeset	93	isabelle build_docker -o Dockerfile -E -t makarius/isabelle:Isabelle2018 Isabelle2018_app.tar.gz
66792 6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	94
6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	95	https://hub.docker.com/r/makarius/isabelle
6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	96	https://docs.docker.com/docker-cloud/builds/push-images
6b76a5d1b7a5 more on Docker; wenzelm parents: 66647 diff changeset	97
41600 46d65140c5de some notes on final release stage; wenzelm parents: 41598 diff changeset	98
47977 455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	99	Post-release
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	100	============
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	101
455a9f89c47d some post-release notes; wenzelm parents: 47863 diff changeset	102	- update /home/isabelle and /home/isabelle/html-data

author	paulson <lp15@cam.ac.uk>
	Mon, 18 Mar 2019 15:35:34 +0000
changeset 69918	eddcc7c726f3
parent 69691	9c6651cd6141
child 69956	800ec9074701
permissions	-rw-r--r--