Admin/Release/CHECKLIST
author wenzelm
Mon, 21 Aug 2017 17:31:03 +0200
changeset 66477 7dccaa6d419a
parent 65567 c556c09765dd
child 66598 e2671e8c476f
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
50957
wenzelm
parents: 50899
diff changeset
     8
- test 'display_drafts' command;
25428
95c0b4dc600b some more items;
wenzelm
parents: 25236
diff changeset
     9
53583
b78eccad3939 more CHECKLIST;
wenzelm
parents: 53416
diff changeset
    10
- test "#!/usr/bin/env isabelle_scala_script";
b78eccad3939 more CHECKLIST;
wenzelm
parents: 53416
diff changeset
    11
56829
f151ade98b15 proper tool wrap-up;
wenzelm
parents: 56824
diff changeset
    12
- check sources:
62452
f25b67245699 more official "isabelle check_sources";
wenzelm
parents: 62354
diff changeset
    13
    isabelle check_sources '~~' '$AFP_BASE'
65567
c556c09765dd tuned documentation;
wenzelm
parents: 65565
diff changeset
    14
    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
    15
37368
1c816f2abb0e removed outdated/confusing INSTALL file;
wenzelm
parents: 37285
diff changeset
    16
- check ANNOUNCE, README, NEWS, COPYRIGHT, CONTRIBUTORS;
30888
a8f9e12d815e misc updates for Isabelle2009;
wenzelm
parents: 30852
diff changeset
    17
66477
7dccaa6d419a updated for release;
wenzelm
parents: 65567
diff changeset
    18
- check versions:
7dccaa6d419a updated for release;
wenzelm
parents: 65567
diff changeset
    19
    src/Tools/jEdit/src/Isabelle.props
7dccaa6d419a updated for release;
wenzelm
parents: 65567
diff changeset
    20
    src/Tools/jEdit/src-base/Isabelle_Base.props
60295
3f0bb5c58dfa updated versions;
wenzelm
parents: 60294
diff changeset
    21
41617
0f98d8f27912 more release checks;
wenzelm
parents: 41608
diff changeset
    22
- check funny base directory, e.g. "Test 中国";
0f98d8f27912 more release checks;
wenzelm
parents: 41608
diff changeset
    23
57454
wenzelm
parents: 56987
diff changeset
    24
- check scalable fonts, e.g. src/Doc/Prog_Prove (NOTE: T1 encoding
55367
f4bbfc2eeae8 check scalable fonts;
wenzelm
parents: 54053
diff changeset
    25
  requires cm-super fonts, which are usually available on MacTeX or
f4bbfc2eeae8 check scalable fonts;
wenzelm
parents: 54053
diff changeset
    26
  Cygwin, but not on Ubuntu/Debian);
f4bbfc2eeae8 check scalable fonts;
wenzelm
parents: 54053
diff changeset
    27
36860
d9338f121406 check NEWS;
wenzelm
parents: 36858
diff changeset
    28
- diff NEWS wrt. last official release, which is read-only;
d9338f121406 check NEWS;
wenzelm
parents: 36858
diff changeset
    29
53979
711104822c8e updated for release;
wenzelm
parents: 53665
diff changeset
    30
- update https://bitbucket.org/isabelle_project/isabelle-website
13447
3470596f3cd5 updated;
wenzelm
parents:
diff changeset
    31
62238
wenzelm
parents: 60763
diff changeset
    32
- check doc/Contents, src/Tools/jEdit/dist/doc/Contents;
13447
3470596f3cd5 updated;
wenzelm
parents:
diff changeset
    33
62238
wenzelm
parents: 60763
diff changeset
    34
- check Logics:
50647
58312dae25a5 updated for release;
wenzelm
parents: 49004
diff changeset
    35
    ROOTS
30852
59a422908e29 misc tuning for release;
wenzelm
parents: 30189
diff changeset
    36
    lib/html/library_index_content.template
13447
3470596f3cd5 updated;
wenzelm
parents:
diff changeset
    37
63899
dc036b1a2a6f misc updates;
wenzelm
parents: 63897
diff changeset
    38
- HTML library: check HTML header;
dc036b1a2a6f misc updates;
wenzelm
parents: 63897
diff changeset
    39
dc036b1a2a6f misc updates;
wenzelm
parents: 63897
diff changeset
    40
- HTML library: check theory dependencies (PDF);
57876
wenzelm
parents: 57694
diff changeset
    41
47834
4e247a648a01 more CHECKLIST;
wenzelm
parents: 47408
diff changeset
    42
- test Isabelle/jEdit:
60294
wenzelm
parents: 60186
diff changeset
    43
    . print buffer
wenzelm
parents: 60186
diff changeset
    44
    . on single-core
wenzelm
parents: 60186
diff changeset
    45
    . on airy device
47834
4e247a648a01 more CHECKLIST;
wenzelm
parents: 47408
diff changeset
    46
46729
046ea3c1000e more release tests;
wenzelm
parents: 45147
diff changeset
    47
- test contrib components:
046ea3c1000e more release tests;
wenzelm
parents: 45147
diff changeset
    48
    x86_64-linux without 32bit C/C++ libraries
66477
7dccaa6d419a updated for release;
wenzelm
parents: 65567
diff changeset
    49
    x86-linux on 32bit hardware
46729
046ea3c1000e more release tests;
wenzelm
parents: 45147
diff changeset
    50
60032
wenzelm
parents: 59980
diff changeset
    51
- check "Handler catches all exceptions"
50784
cbc7002cc273 more CHECKLIST;
wenzelm
parents: 50647
diff changeset
    52
57624
a7acd2d8c2fb enable hires explictly, as seen for other high-end Java applications on the Web;
wenzelm
parents: 57454
diff changeset
    53
- 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
    54
59980
070f04c94b2e misc tuning for release;
wenzelm
parents: 59952
diff changeset
    55
- Mac OS X: check recent MacTeX;
070f04c94b2e misc tuning for release;
wenzelm
parents: 59952
diff changeset
    56
57876
wenzelm
parents: 57694
diff changeset
    57
- Windows: check dpi scaling with high-definition display;
wenzelm
parents: 57694
diff changeset
    58
59980
070f04c94b2e misc tuning for release;
wenzelm
parents: 59952
diff changeset
    59
- Windows: check recent MiKTeX;
070f04c94b2e misc tuning for release;
wenzelm
parents: 59952
diff changeset
    60
37526
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    61
54052
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    62
Repository fork
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    63
===============
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    64
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    65
- isabelle: finalize NEWS / CONTRIBUTORS -- proper headers for named release;
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    66
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    67
- isabelle-release: hg tag;
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    68
54053
wenzelm
parents: 54052
diff changeset
    69
- isabelle: back to post-release mode -- after fork point;
54052
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    70
797ae756d64d more notes;
wenzelm
parents: 53979
diff changeset
    71
37526
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    72
Packaging
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    73
=========
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    74
63897
85c83757788c consolidate implicit use of gnutar, via somewhat fragile dynamic scoping within existing shell scripts;
wenzelm
parents: 63061
diff changeset
    75
- 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
    76
  (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
    77
63899
dc036b1a2a6f misc updates;
wenzelm
parents: 63897
diff changeset
    78
- Linux: avoid some versions of Debian / Ubuntu (bitmap fonts for prog-prove);
dc036b1a2a6f misc updates;
wenzelm
parents: 63897
diff changeset
    79
64436
254c9411fc48 build_release on lxbroy10 appears to work, including latex and remote_dmg;
wenzelm
parents: 64370
diff changeset
    80
- fully-automated packaging (e.g. on lxbroy10 or macbroy2):
37526
f4016fca4ff9 notes on packaging;
wenzelm
parents: 37368
diff changeset
    81
64202
967515846691 replaced shell script by Isabelle/Scala;
wenzelm
parents: 64145
diff changeset
    82
  hg up -r DISTNAME && Admin/build_release -M macbroy30 -O -l -R DISTNAME /home/isabelle/dist
41600
46d65140c5de some notes on final release stage;
wenzelm
parents: 41598
diff changeset
    83
46d65140c5de some notes on final release stage;
wenzelm
parents: 41598
diff changeset
    84
46d65140c5de some notes on final release stage;
wenzelm
parents: 41598
diff changeset
    85
Final release stage
46d65140c5de some notes on final release stage;
wenzelm
parents: 41598
diff changeset
    86
===================
46d65140c5de some notes on final release stage;
wenzelm
parents: 41598
diff changeset
    87
47863
ec5d54029664 clarified;
wenzelm
parents: 47858
diff changeset
    88
- various .hg/hgrc files:
51097
72c355842f42 updated isabelle-release URLs;
wenzelm
parents: 50990
diff changeset
    89
  default = http://bitbucket.org/isabelle_project/isabelle-release
72c355842f42 updated isabelle-release URLs;
wenzelm
parents: 50990
diff changeset
    90
  default = ssh://hg@bitbucket.org/isabelle_project/isabelle-release
41600
46d65140c5de some notes on final release stage;
wenzelm
parents: 41598
diff changeset
    91
64437
dba2ca0e0a53 updated to new cronjob;
wenzelm
parents: 64436
diff changeset
    92
- Admin/cronjob/self_update:
dba2ca0e0a53 updated to new cronjob;
wenzelm
parents: 64436
diff changeset
    93
  http://bitbucket.org/isabelle_project/isabelle-release
41608
5a3696574ebb more notes on final release stage;
wenzelm
parents: 41600
diff changeset
    94
64452
b52141002646 proper remote repository source;
wenzelm
parents: 64437
diff changeset
    95
- src/Pure/Admin/isabelle_cronjon.scala:
b52141002646 proper remote repository source;
wenzelm
parents: 64437
diff changeset
    96
  isabelle_repos_source = isabelle_release_source
b52141002646 proper remote repository source;
wenzelm
parents: 64437
diff changeset
    97
47977
455a9f89c47d some post-release notes;
wenzelm
parents: 47863
diff changeset
    98
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