Admin/Release/CHECKLIST
author wenzelm
Sun, 15 Oct 2023 13:48:08 +0200
changeset 78781 847739805b8d
parent 78145 2a28450b992b
child 79059 ae682b2aab03
permissions -rw-r--r--
disable naproche component for now: to be updated before the next Isabelle 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
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
53583
b78eccad3939 more CHECKLIST;
wenzelm
parents: 53416
diff changeset
    25
- test "#!/usr/bin/env isabelle_scala_script";
b78eccad3939 more CHECKLIST;
wenzelm
parents: 53416
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
68591
90381a0f5474 more manual tests;
wenzelm
parents: 68573
diff changeset
    29
- test Windows 10 subsystem for Linux:
90381a0f5474 more manual tests;
wenzelm
parents: 68573
diff changeset
    30
  https://docs.microsoft.com/en-us/windows/wsl/install-win10
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
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
78145
2a28450b992b back to more concise build_release, thanks to build_host_macos = "mini3";
wenzelm
parents: 78143
diff changeset
    80
  #on fast Linux machine, with access to Linux + Apple ARM + Windows build_host
78781
847739805b8d disable naproche component for now: to be updated before the next Isabelle release;
wenzelm
parents: 78145
diff changeset
    81
  Admin/build_release -D ~/tmp/isadist -b HOL -R Isabelle2023 -j2 -l
76378
c0566b6f6ca8 formal bundling for Admin/build_release: avoid confusion about presence or absence in manual invocations;
wenzelm
parents: 76374
diff changeset
    82
78781
847739805b8d disable naproche component for now: to be updated before the next Isabelle release;
wenzelm
parents: 78145
diff changeset
    83
  #with access Linux ARM build_host
78143
7ea4f986e41a updated for release;
wenzelm
parents: 77577
diff changeset
    84
  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
    85
66792
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
    86
- Docker image:
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
    87
78143
7ea4f986e41a updated for release;
wenzelm
parents: 77577
diff changeset
    88
  isabelle docker_build -o Dockerfile -E -t makarius/isabelle:Isabelle2023 Isabelle2023_linux.tar.gz
7ea4f986e41a updated for release;
wenzelm
parents: 77577
diff changeset
    89
  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
    90
78143
7ea4f986e41a updated for release;
wenzelm
parents: 77577
diff changeset
    91
  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
    92
  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
    93
73258
fdc76c10bb61 more hints;
wenzelm
parents: 73219
diff changeset
    94
  docker login
fdc76c10bb61 more hints;
wenzelm
parents: 73219
diff changeset
    95
78143
7ea4f986e41a updated for release;
wenzelm
parents: 77577
diff changeset
    96
  docker push makarius/isabelle:Isabelle2023
73258
fdc76c10bb61 more hints;
wenzelm
parents: 73219
diff changeset
    97
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
    98
  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
    99
  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
   100
66792
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
   101
  https://hub.docker.com/r/makarius/isabelle
70330
312e4a40db01 proper URL;
wenzelm
parents: 70104
diff changeset
   102
  https://docs.docker.com/engine/reference/commandline/push
66792
6b76a5d1b7a5 more on Docker;
wenzelm
parents: 66647
diff changeset
   103
41600
46d65140c5de some notes on final release stage;
wenzelm
parents: 41598
diff changeset
   104
47977
455a9f89c47d some post-release notes;
wenzelm
parents: 47863
diff changeset
   105
Post-release
455a9f89c47d some post-release notes;
wenzelm
parents: 47863
diff changeset
   106
============
455a9f89c47d some post-release notes;
wenzelm
parents: 47863
diff changeset
   107
76374
8c1ba8907c6b official release;
wenzelm
parents: 76369
diff changeset
   108
- update .hgtags
8c1ba8907c6b official release;
wenzelm
parents: 76369
diff changeset
   109
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
   110
- 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
   111
74653
cfe295b2e6e5 update paths at TUM;
wenzelm
parents: 74426
diff changeset
   112
- update /p/home/isabelle and /p/home/isabelle/html-data