Admin/Release/CHECKLIST
author wenzelm
Tue, 02 Apr 2019 16:58:10 +0200
changeset 70037 5863d6a8374a
parent 69959 795ca58cee29
child 70038 3374d16efc61
permissions -rw-r--r--
updated for release;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
69956
800ec9074701 proper command-line;
wenzelm
parents: 69691
diff changeset
    10
- test "isabelle build -o export_theory -f ZF";
68544
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
36860
d9338f121406 check NEWS;
wenzelm
parents: 36858
diff changeset
    43
- diff NEWS wrt. last official release, which is read-only;
d9338f121406 check NEWS;
wenzelm
parents: 36858
diff changeset
    44
69691
9c6651cd6141 clarified URLs: prefer sketis over bitbucket;
wenzelm
parents: 69435
diff changeset
    45
- update https://isabelle.sketis.net/repos/isabelle-website
13447
3470596f3cd5 updated;
wenzelm
parents:
diff changeset
    46
62238
wenzelm
parents: 60763
diff changeset
    47
- check doc/Contents, src/Tools/jEdit/dist/doc/Contents;
13447
3470596f3cd5 updated;
wenzelm
parents:
diff changeset
    48
60032
wenzelm
parents: 59980
diff changeset
    49
- check "Handler catches all exceptions"
50784
cbc7002cc273 more CHECKLIST;
wenzelm
parents: 50647
diff changeset
    50
70037
5863d6a8374a updated for release;
wenzelm
parents: 69959
diff changeset
    51
- Mac OS X: check app bundle with UHD display;
57624
a7acd2d8c2fb enable hires explictly, as seen for other high-end Java applications on the Web;
wenzelm
parents: 57454
diff changeset
    52
59980
070f04c94b2e misc tuning for release;
wenzelm
parents: 59952
diff changeset
    53
- Mac OS X: check recent MacTeX;
070f04c94b2e misc tuning for release;
wenzelm
parents: 59952
diff changeset
    54
70037
5863d6a8374a updated for release;
wenzelm
parents: 69959
diff changeset
    55
- Windows: check dpi scaling with UHD display;
57876
wenzelm
parents: 57694
diff changeset
    56
59980
070f04c94b2e misc tuning for release;
wenzelm
parents: 59952
diff changeset
    57
- Windows: check recent MiKTeX;
070f04c94b2e misc tuning for release;
wenzelm
parents: 59952
diff changeset
    58
37526
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    59
54052
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    60
Repository fork
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    61
===============
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    62
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    63
- isabelle: finalize NEWS / CONTRIBUTORS -- proper headers for named release;
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    64
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    65
- isabelle-release: hg tag;
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    66
54053
wenzelm
parents: 54052
diff changeset
    67
- isabelle: back to post-release mode -- after fork point;
54052
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    68
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    69
37526
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    70
Packaging
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    71
=========
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    72
63897
85c83757788c consolidate implicit use of gnutar, via somewhat fragile dynamic scoping within existing shell scripts;
wenzelm
parents: 63061
diff changeset
    73
- 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
    74
  (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
    75
70037
5863d6a8374a updated for release;
wenzelm
parents: 69959
diff changeset
    76
- fully-automated packaging (e.g. on lxcisa0):
37526
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    77
69435
e18e4532fb42 clarified example: avoid unpacking into /home/isabelle/components at TUM;
wenzelm
parents: 69432
diff changeset
    78
  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
    79
66792
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
    80
- Docker image:
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
    81
68738
34b8ff7cb109 updated for release;
wenzelm
parents: 68591
diff changeset
    82
  isabelle build_docker -o Dockerfile -E -t makarius/isabelle:Isabelle2018 Isabelle2018_app.tar.gz
66792
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
    83
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
    84
  https://hub.docker.com/r/makarius/isabelle
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
    85
  https://docs.docker.com/docker-cloud/builds/push-images
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
    86
41600
46d65140c5de some notes on final release stage;
wenzelm
parents: 41598
diff changeset
    87
47977
455a9f89c47d some post-release notes;
wenzelm
parents: 47863
diff changeset
    88
Post-release
455a9f89c47d some post-release notes;
wenzelm
parents: 47863
diff changeset
    89
============
455a9f89c47d some post-release notes;
wenzelm
parents: 47863
diff changeset
    90
455a9f89c47d some post-release notes;
wenzelm
parents: 47863
diff changeset
    91
- update /home/isabelle and /home/isabelle/html-data