Admin/Release/CHECKLIST
author wenzelm
Wed Nov 01 22:13:38 2017 +0100 (19 months ago)
changeset 66986 5188b1c59434
parent 66908 9b074f01a305
child 67263 449a989f42cd
permissions -rw-r--r--
more timing;
wenzelm@13447
     1
Checklist for official releases
wenzelm@13447
     2
===============================
wenzelm@13447
     3
wenzelm@62354
     4
- check latest updates of polyml, jdk, scala, jedit;
wenzelm@50647
     5
wenzelm@50647
     6
- check Admin/components;
wenzelm@50647
     7
wenzelm@50957
     8
- test 'display_drafts' command;
wenzelm@25428
     9
wenzelm@66647
    10
- test Isabelle/jEdit: print buffer
wenzelm@66647
    11
wenzelm@53583
    12
- test "#!/usr/bin/env isabelle_scala_script";
wenzelm@53583
    13
wenzelm@56829
    14
- check sources:
wenzelm@62452
    15
    isabelle check_sources '~~' '$AFP_BASE'
wenzelm@65567
    16
    isabelle imports -M -a -d '~~/src/Benchmarks'
wenzelm@53665
    17
wenzelm@37368
    18
- check ANNOUNCE, README, NEWS, COPYRIGHT, CONTRIBUTORS;
wenzelm@30888
    19
wenzelm@66477
    20
- check versions:
wenzelm@66477
    21
    src/Tools/jEdit/src/Isabelle.props
wenzelm@66477
    22
    src/Tools/jEdit/src-base/Isabelle_Base.props
wenzelm@60295
    23
wenzelm@66598
    24
- check Isabelle version:
wenzelm@66598
    25
    src/Tools/VSCode/extension/README.md
wenzelm@66598
    26
    src/Tools/VSCode/extension/package.json
wenzelm@66598
    27
wenzelm@41617
    28
- check funny base directory, e.g. "Test 中国";
wenzelm@41617
    29
wenzelm@57454
    30
- check scalable fonts, e.g. src/Doc/Prog_Prove (NOTE: T1 encoding
wenzelm@55367
    31
  requires cm-super fonts, which are usually available on MacTeX or
wenzelm@55367
    32
  Cygwin, but not on Ubuntu/Debian);
wenzelm@55367
    33
wenzelm@36860
    34
- diff NEWS wrt. last official release, which is read-only;
wenzelm@36860
    35
wenzelm@53979
    36
- update https://bitbucket.org/isabelle_project/isabelle-website
wenzelm@13447
    37
wenzelm@62238
    38
- check doc/Contents, src/Tools/jEdit/dist/doc/Contents;
wenzelm@13447
    39
wenzelm@62238
    40
- check Logics:
wenzelm@50647
    41
    ROOTS
wenzelm@30852
    42
    lib/html/library_index_content.template
wenzelm@13447
    43
wenzelm@63899
    44
- HTML library: check HTML header;
wenzelm@63899
    45
wenzelm@63899
    46
- HTML library: check theory dependencies (PDF);
wenzelm@57876
    47
wenzelm@60032
    48
- check "Handler catches all exceptions"
wenzelm@50784
    49
wenzelm@57624
    50
- Mac OS X: check app bundle with Retina display;
wenzelm@57624
    51
wenzelm@59980
    52
- Mac OS X: check recent MacTeX;
wenzelm@59980
    53
wenzelm@57876
    54
- Windows: check dpi scaling with high-definition display;
wenzelm@57876
    55
wenzelm@59980
    56
- Windows: check recent MiKTeX;
wenzelm@59980
    57
wenzelm@37526
    58
wenzelm@54052
    59
Repository fork
wenzelm@54052
    60
===============
wenzelm@54052
    61
wenzelm@54052
    62
- isabelle: finalize NEWS / CONTRIBUTORS -- proper headers for named release;
wenzelm@54052
    63
wenzelm@54052
    64
- isabelle-release: hg tag;
wenzelm@54052
    65
wenzelm@54053
    66
- isabelle: back to post-release mode -- after fork point;
wenzelm@54052
    67
wenzelm@54052
    68
wenzelm@37526
    69
Packaging
wenzelm@37526
    70
=========
wenzelm@37526
    71
wenzelm@63897
    72
- Mac OS X: provide "gnutar" executable via shell PATH
wenzelm@63897
    73
  (e.g. copy of /usr/bin/gnutar from Mountain Lion)
wenzelm@63897
    74
wenzelm@63899
    75
- Linux: avoid some versions of Debian / Ubuntu (bitmap fonts for prog-prove);
wenzelm@63899
    76
wenzelm@64436
    77
- fully-automated packaging (e.g. on lxbroy10 or macbroy2):
wenzelm@37526
    78
wenzelm@64202
    79
  hg up -r DISTNAME && Admin/build_release -M macbroy30 -O -l -R DISTNAME /home/isabelle/dist
wenzelm@41600
    80
wenzelm@66792
    81
- Docker image:
wenzelm@66792
    82
wenzelm@66792
    83
  isabelle build_docker -E -t makarius/isabelle:Isabelle2017 Isabelle2017_app.tar.gz
wenzelm@66792
    84
wenzelm@66792
    85
  https://hub.docker.com/r/makarius/isabelle
wenzelm@66792
    86
  https://docs.docker.com/docker-cloud/builds/push-images
wenzelm@66792
    87
wenzelm@41600
    88
wenzelm@41600
    89
Final release stage
wenzelm@41600
    90
===================
wenzelm@41600
    91
wenzelm@47863
    92
- various .hg/hgrc files:
wenzelm@51097
    93
  default = http://bitbucket.org/isabelle_project/isabelle-release
wenzelm@51097
    94
  default = ssh://hg@bitbucket.org/isabelle_project/isabelle-release
wenzelm@41600
    95
wenzelm@47977
    96
wenzelm@47977
    97
Post-release
wenzelm@47977
    98
============
wenzelm@47977
    99
wenzelm@47977
   100
- update /home/isabelle and /home/isabelle/html-data