Admin/Release/CHECKLIST
author wenzelm
Wed Apr 08 23:00:09 2015 +0200 (2015-04-08)
changeset 59980 070f04c94b2e
parent 59952 550b74e9b08c
child 60032 7fcbdc4aeb8e
permissions -rw-r--r--
misc tuning for release;
wenzelm@13447
     1
Checklist for official releases
wenzelm@13447
     2
===============================
wenzelm@13447
     3
wenzelm@59952
     4
- check latest updates of polyml, smlnj, jdk, scala, jedit;
wenzelm@50647
     5
wenzelm@50647
     6
- check Admin/components;
wenzelm@50647
     7
wenzelm@47979
     8
- test polyml-5.4.1, polyml-5.4.0, polyml-5.3.0, smlnj;
wenzelm@31308
     9
wenzelm@53660
    10
- test Isabelle/jEdit on single-core;
wenzelm@53660
    11
wenzelm@53660
    12
- test Isabelle/jEdit on airy device;
wenzelm@30888
    13
wenzelm@50957
    14
- test 'display_drafts' command;
wenzelm@25428
    15
wenzelm@53583
    16
- test "#!/usr/bin/env isabelle_scala_script";
wenzelm@53583
    17
wenzelm@56829
    18
- check sources:
wenzelm@56829
    19
    isabelle java isabelle.Check_Source '~~' '$AFP_BASE'
wenzelm@53665
    20
wenzelm@37368
    21
- check ANNOUNCE, README, NEWS, COPYRIGHT, CONTRIBUTORS;
wenzelm@30888
    22
wenzelm@41617
    23
- check funny base directory, e.g. "Test 中国";
wenzelm@41617
    24
wenzelm@57454
    25
- check scalable fonts, e.g. src/Doc/Prog_Prove (NOTE: T1 encoding
wenzelm@55367
    26
  requires cm-super fonts, which are usually available on MacTeX or
wenzelm@55367
    27
  Cygwin, but not on Ubuntu/Debian);
wenzelm@55367
    28
wenzelm@36860
    29
- diff NEWS wrt. last official release, which is read-only;
wenzelm@36860
    30
wenzelm@53979
    31
- update https://bitbucket.org/isabelle_project/isabelle-website
wenzelm@13447
    32
wenzelm@53416
    33
- maintain doc/Contents;
wenzelm@13447
    34
wenzelm@13447
    35
- maintain Logics:
wenzelm@50647
    36
    ROOTS
wenzelm@30852
    37
    lib/html/library_index_content.template
wenzelm@13447
    38
wenzelm@57876
    39
- check HTML header of library;
wenzelm@57876
    40
wenzelm@47408
    41
- test separate compilation of Isabelle/Scala PIDE sources:
wenzelm@47408
    42
    Admin/build jars_test
wenzelm@47408
    43
wenzelm@47834
    44
- test Isabelle/jEdit:
wenzelm@47834
    45
    print buffer
wenzelm@47834
    46
wenzelm@46729
    47
- test contrib components:
wenzelm@46729
    48
    x86_64-linux without 32bit C/C++ libraries
wenzelm@46729
    49
wenzelm@50784
    50
- check "Handler catches all exceptions", using
wenzelm@50784
    51
  PolyML.Compiler.reportExhaustiveHandlers := true;
wenzelm@50784
    52
wenzelm@57624
    53
- Mac OS X: check app bundle with Retina display;
wenzelm@57624
    54
wenzelm@59980
    55
- Mac OS X: check recent MacTeX;
wenzelm@59980
    56
wenzelm@57876
    57
- Windows: check dpi scaling with high-definition display;
wenzelm@57876
    58
wenzelm@59980
    59
- Windows: check recent MiKTeX;
wenzelm@59980
    60
wenzelm@37526
    61
wenzelm@54052
    62
Repository fork
wenzelm@54052
    63
===============
wenzelm@54052
    64
wenzelm@54052
    65
- isabelle: finalize NEWS / CONTRIBUTORS -- proper headers for named release;
wenzelm@54052
    66
wenzelm@54052
    67
- isabelle-release: hg tag;
wenzelm@54052
    68
wenzelm@54053
    69
- isabelle: back to post-release mode -- after fork point;
wenzelm@54052
    70
wenzelm@54052
    71
wenzelm@37526
    72
Packaging
wenzelm@37526
    73
=========
wenzelm@37526
    74
wenzelm@57454
    75
- fully-automated packaging (requires Mac OS X with gnutar, avoid Mavericks):
wenzelm@37526
    76
wenzelm@57681
    77
  hg up -r DISTNAME && Admin/Release/build -O -l -r DISTNAME /home/isabelle/dist
wenzelm@41600
    78
wenzelm@41600
    79
wenzelm@41600
    80
Final release stage
wenzelm@41600
    81
===================
wenzelm@41600
    82
wenzelm@47863
    83
- various .hg/hgrc files:
wenzelm@51097
    84
  default = http://bitbucket.org/isabelle_project/isabelle-release
wenzelm@51097
    85
  default = ssh://hg@bitbucket.org/isabelle_project/isabelle-release
wenzelm@41600
    86
wenzelm@47863
    87
- isatest@macbroy28:hg-isabelle/.hg/hgrc
wenzelm@41608
    88
- isatest@macbroy28:devel-page/content/index.content
wenzelm@41608
    89
wenzelm@47977
    90
wenzelm@47977
    91
Post-release
wenzelm@47977
    92
============
wenzelm@47977
    93
wenzelm@47977
    94
- update /home/isabelle and /home/isabelle/html-data