NEWS
author wenzelm
Thu, 31 Jan 2019 17:18:15 +0100
changeset 69775 5a8ae7a4b7d0
parent 69764 3ceff650adb9
child 69778 09ad02c0fbee
permissions -rw-r--r--
added option jedit_text_overview for visual appearance (not performance, see also 72216713733a);
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
57491
9eedaafc05c8 tuned grammar and spelling (cf. 0cf15843b82f);
wenzelm
parents: 57476
diff changeset
     1
Isabelle NEWS -- history of user-relevant changes
9eedaafc05c8 tuned grammar and spelling (cf. 0cf15843b82f);
wenzelm
parents: 57476
diff changeset
     2
=================================================
2553
ed941505cab7 Isabelle NEWS -- history of user-visible changes;
wenzelm
parents:
diff changeset
     3
62114
a7cf464933f7 generate HTML version of NEWS, with proper symbol rendering;
wenzelm
parents: 62111
diff changeset
     4
(Note: Isabelle/jEdit shows a tree-view of the NEWS file in Sidekick.)
60006
wenzelm
parents: 59998
diff changeset
     5
64603
a7f5e59378f7 tuned whitespace;
wenzelm
parents: 64602
diff changeset
     6
68683
d69127c6e80f back to post-release mode -- after fork point;
wenzelm
parents: 68681
diff changeset
     7
New in this Isabelle version
d69127c6e80f back to post-release mode -- after fork point;
wenzelm
parents: 68681
diff changeset
     8
----------------------------
d69127c6e80f back to post-release mode -- after fork point;
wenzelm
parents: 68681
diff changeset
     9
69042
6e9df530b441 discontinued old-style inner comments;
wenzelm
parents: 69037
diff changeset
    10
*** General ***
6e9df530b441 discontinued old-style inner comments;
wenzelm
parents: 69037
diff changeset
    11
69506
7d59af98af29 {* verbatim *} is explicit legacy feature;
wenzelm
parents: 69470
diff changeset
    12
* Old-style {* verbatim *} tokens are explicitly marked as legacy
7d59af98af29 {* verbatim *} is explicit legacy feature;
wenzelm
parents: 69470
diff changeset
    13
feature and will be removed soon. Use \<open>cartouche\<close> syntax instead, e.g.
7d59af98af29 {* verbatim *} is explicit legacy feature;
wenzelm
parents: 69470
diff changeset
    14
via "isabelle update_cartouches -t" (available since Isabelle2015).
7d59af98af29 {* verbatim *} is explicit legacy feature;
wenzelm
parents: 69470
diff changeset
    15
69343
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    16
* The font family "Isabelle DejaVu" is systematically derived from the
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    17
existing "DejaVu" collection, with variants "Sans Mono", "Sans", "Serif"
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    18
and styles "Normal", "Bold", "Italic/Oblique", "Bold-Italic/Oblique".
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    19
The DejaVu base fonts are retricted to well-defined Unicode ranges and
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    20
augmented by special Isabelle symbols, taken from the former
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    21
"IsabelleText" font (which is no longer provided separately). The line
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    22
metrics and overall rendering quality is closer to original DejaVu.
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    23
INCOMPATIBILITY with display configuration expecting the old
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    24
"IsabelleText" font: use e.g. "Isabelle DejaVu Sans Mono" instead.
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    25
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    26
* The Isabelle fonts render "\<inverse>" properly as superscript "-1".
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    27
69042
6e9df530b441 discontinued old-style inner comments;
wenzelm
parents: 69037
diff changeset
    28
* Old-style inner comments (* ... *) within the term language are no
6e9df530b441 discontinued old-style inner comments;
wenzelm
parents: 69037
diff changeset
    29
longer supported (legacy feature in Isabelle2018).
6e9df530b441 discontinued old-style inner comments;
wenzelm
parents: 69037
diff changeset
    30
69066
nipkow
parents: 69045
diff changeset
    31
* Infix operators that begin or end with a "*" can now be paranthesized
nipkow
parents: 69045
diff changeset
    32
without additional spaces, eg "(*)" instead of "( * )".
nipkow
parents: 69045
diff changeset
    33
69580
6f755e3cd95d mixfix annotations may use cartouches;
wenzelm
parents: 69569
diff changeset
    34
* Mixfix annotations may use cartouches instead of old-style double
69586
9171d1ce5a35 support for "isabelle update -u mixfix_cartouches";
wenzelm
parents: 69585
diff changeset
    35
quotes, e.g. (infixl \<open>+\<close> 60). The command-line tool "isabelle update -u
9171d1ce5a35 support for "isabelle update -u mixfix_cartouches";
wenzelm
parents: 69585
diff changeset
    36
mixfix_cartouches" allows to update existing theory sources
9171d1ce5a35 support for "isabelle update -u mixfix_cartouches";
wenzelm
parents: 69585
diff changeset
    37
automatically.
69580
6f755e3cd95d mixfix annotations may use cartouches;
wenzelm
parents: 69569
diff changeset
    38
69216
1a52baa70aed clarified ML_Context.expression: it is a closed expression, not a let-declaration -- thus source positions are more accurate (amending d8849cfad60f, 162a4c2e97bc);
wenzelm
parents: 69213
diff changeset
    39
* ML setup commands (e.g. 'setup', 'method_setup', 'parse_translation')
1a52baa70aed clarified ML_Context.expression: it is a closed expression, not a let-declaration -- thus source positions are more accurate (amending d8849cfad60f, 162a4c2e97bc);
wenzelm
parents: 69213
diff changeset
    40
need to provide a closed expression -- without trailing semicolon. Minor
1a52baa70aed clarified ML_Context.expression: it is a closed expression, not a let-declaration -- thus source positions are more accurate (amending d8849cfad60f, 162a4c2e97bc);
wenzelm
parents: 69213
diff changeset
    41
INCOMPATIBILITY.
1a52baa70aed clarified ML_Context.expression: it is a closed expression, not a let-declaration -- thus source positions are more accurate (amending d8849cfad60f, 162a4c2e97bc);
wenzelm
parents: 69213
diff changeset
    42
69042
6e9df530b441 discontinued old-style inner comments;
wenzelm
parents: 69037
diff changeset
    43
69189
wenzelm
parents: 69183
diff changeset
    44
*** Isabelle/jEdit Prover IDE ***
wenzelm
parents: 69183
diff changeset
    45
69643
83f15deb2d36 added action "isabelle-export-browser";
wenzelm
parents: 69624
diff changeset
    46
* Action "isabelle-export-browser" points the File Browser to the theory
69764
wenzelm
parents: 69755
diff changeset
    47
exports of the current buffer, based on the "isabelle-export:" virtual
wenzelm
parents: 69755
diff changeset
    48
file-system. The directory view needs to be reloaded manually to follow
wenzelm
parents: 69755
diff changeset
    49
ongoing document processing.
wenzelm
parents: 69755
diff changeset
    50
wenzelm
parents: 69755
diff changeset
    51
* Action "isabelle-session-browser" points the File Browser to session
wenzelm
parents: 69755
diff changeset
    52
information, based on the "isabelle-session:" virtual file-system. Its
wenzelm
parents: 69755
diff changeset
    53
entries are structured according to chapter / session names, the open
wenzelm
parents: 69755
diff changeset
    54
operation is redirected to the session ROOT file.
69643
83f15deb2d36 added action "isabelle-export-browser";
wenzelm
parents: 69624
diff changeset
    55
69775
5a8ae7a4b7d0 added option jedit_text_overview for visual appearance (not performance, see also 72216713733a);
wenzelm
parents: 69764
diff changeset
    56
* System option "jedit_text_overview" allows to disable the text
5a8ae7a4b7d0 added option jedit_text_overview for visual appearance (not performance, see also 72216713733a);
wenzelm
parents: 69764
diff changeset
    57
overview column.
5a8ae7a4b7d0 added option jedit_text_overview for visual appearance (not performance, see also 72216713733a);
wenzelm
parents: 69764
diff changeset
    58
69343
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    59
* Fonts for the text area, gutter, GUI elements etc. use the "Isabelle
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    60
DejaVu" collection by default, which provides uniform rendering quality
69377
81ae5893c556 use Isabelle fonts for all GUI look-and-feels;
wenzelm
parents: 69343
diff changeset
    61
with the usual Isabelle symbols. Line spacing no longer needs to be
81ae5893c556 use Isabelle fonts for all GUI look-and-feels;
wenzelm
parents: 69343
diff changeset
    62
adjusted: properties for the old IsabelleText font had "Global Options /
81ae5893c556 use Isabelle fonts for all GUI look-and-feels;
wenzelm
parents: 69343
diff changeset
    63
Text Area / Extra vertical line spacing (in pixels): -2", now it
81ae5893c556 use Isabelle fonts for all GUI look-and-feels;
wenzelm
parents: 69343
diff changeset
    64
defaults to 0.
69343
395c4fb15ea2 use "Isabelle DejaVu" fonts uniformly: Text Area, GUI elements, HTML output etc.;
wenzelm
parents: 69316
diff changeset
    65
69189
wenzelm
parents: 69183
diff changeset
    66
* Improved sub-pixel font rendering (especially on Linux), thanks to
wenzelm
parents: 69183
diff changeset
    67
OpenJDK 11.
wenzelm
parents: 69183
diff changeset
    68
69273
wenzelm
parents: 69269
diff changeset
    69
* Support for user-defined file-formats via class isabelle.File_Format
69277
258bef08b31e support for user-defined Isabelle/Scala command-line tools;
wenzelm
parents: 69273
diff changeset
    70
in Isabelle/Scala (e.g. see isabelle.Bibtex.File_Format), configured via
258bef08b31e support for user-defined Isabelle/Scala command-line tools;
wenzelm
parents: 69273
diff changeset
    71
the shell function "isabelle_file_format" in etc/settings (e.g. of an
258bef08b31e support for user-defined Isabelle/Scala command-line tools;
wenzelm
parents: 69273
diff changeset
    72
Isabelle component).
69273
wenzelm
parents: 69269
diff changeset
    73
69189
wenzelm
parents: 69183
diff changeset
    74
68879
wenzelm
parents: 68848
diff changeset
    75
*** Isar ***
wenzelm
parents: 68848
diff changeset
    76
wenzelm
parents: 68848
diff changeset
    77
* More robust treatment of structural errors: begin/end blocks take
wenzelm
parents: 68848
diff changeset
    78
precedence over goal/proof.
wenzelm
parents: 68848
diff changeset
    79
69045
8c240fdeffcb discontinued old-style goal cases;
wenzelm
parents: 69044
diff changeset
    80
* Implicit cases goal1, goal2, goal3, etc. have been discontinued
8c240fdeffcb discontinued old-style goal cases;
wenzelm
parents: 69044
diff changeset
    81
(legacy feature since Isabelle2016).
8c240fdeffcb discontinued old-style goal cases;
wenzelm
parents: 69044
diff changeset
    82
8c240fdeffcb discontinued old-style goal cases;
wenzelm
parents: 69044
diff changeset
    83
68796
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
    84
*** HOL ***
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
    85
69746
7404f5b91e56 changed precedence of big operators: now like any other function symbol
nipkow
parents: 69743
diff changeset
    86
* the functions \<Union>, \<Inter>, \<Squnion>, \<Sqinter>
7404f5b91e56 changed precedence of big operators: now like any other function symbol
nipkow
parents: 69743
diff changeset
    87
(not the corresponding binding operators) now have the same precedence
7404f5b91e56 changed precedence of big operators: now like any other function symbol
nipkow
parents: 69743
diff changeset
    88
as any other prefix function symbol.
7404f5b91e56 changed precedence of big operators: now like any other function symbol
nipkow
parents: 69743
diff changeset
    89
69733
6d158fd15b85 more appropriate section
haftmann
parents: 69709
diff changeset
    90
* Slightly more conventional naming schema in structure Inductive.
6d158fd15b85 more appropriate section
haftmann
parents: 69709
diff changeset
    91
Minor INCOMPATIBILITY.
6d158fd15b85 more appropriate section
haftmann
parents: 69709
diff changeset
    92
69624
e02bdf853a4c optional code export as theory export
haftmann
parents: 69609
diff changeset
    93
* Code generation: command 'export_code' without file keyword exports
69649
e61b0b819d28 information with hyperlink to "isabelle-export:";
wenzelm
parents: 69643
diff changeset
    94
code as regular theory export, which can be materialized using the
69672
wenzelm
parents: 69649
diff changeset
    95
command-line tool "isabelle export" or 'export_files' in the session
wenzelm
parents: 69649
diff changeset
    96
ROOT, or browsed in Isabelle/jEdit via the "isabelle-export:"
wenzelm
parents: 69649
diff changeset
    97
file-system. To get generated code dumped into output, use "file \<open>\<close>".
wenzelm
parents: 69649
diff changeset
    98
Minor INCOMPATIBILITY.
69624
e02bdf853a4c optional code export as theory export
haftmann
parents: 69609
diff changeset
    99
69743
6a9a8ef5e4c6 prefer proper strings in OCaml
haftmann
parents: 69733
diff changeset
   100
* Code generation for OCaml: proper strings are used for literals.
6a9a8ef5e4c6 prefer proper strings in OCaml
haftmann
parents: 69733
diff changeset
   101
Minor INCOMPATIBILITY.
6a9a8ef5e4c6 prefer proper strings in OCaml
haftmann
parents: 69733
diff changeset
   102
69690
1fb204399d8d self-contained code modules for Haskell
haftmann
parents: 69672
diff changeset
   103
* Code generation for Haskell: code includes for Haskell must contain
1fb204399d8d self-contained code modules for Haskell
haftmann
parents: 69672
diff changeset
   104
proper module frame, nothing is added magically any longer.
1fb204399d8d self-contained code modules for Haskell
haftmann
parents: 69672
diff changeset
   105
INCOMPATIBILITY.
1fb204399d8d self-contained code modules for Haskell
haftmann
parents: 69672
diff changeset
   106
69697
4d95261fab5a more conventional syntax for code_stmts antiquotation
haftmann
parents: 69690
diff changeset
   107
* Code generation: slightly more conventional syntax for
4d95261fab5a more conventional syntax for code_stmts antiquotation
haftmann
parents: 69690
diff changeset
   108
'code_stmts' antiquotation.  Minor INCOMPATIBILITY.
4d95261fab5a more conventional syntax for code_stmts antiquotation
haftmann
parents: 69690
diff changeset
   109
68796
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
   110
* Simplified syntax setup for big operators under image. In rare
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
   111
situations, type conversions are not inserted implicitly any longer
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
   112
and need to be given explicitly. Auxiliary abbreviations INFIMUM,
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
   113
SUPREMUM, UNION, INTER should now rarely occur in output and are just
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
   114
retained as migration auxiliary. INCOMPATIBILITY.
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
   115
69094
nipkow
parents: 69066
diff changeset
   116
* Theory List: the precedence of the list_update operator has changed:
nipkow
parents: 69066
diff changeset
   117
"f a [n := x]" now needs to be written "(f a)[n := x]".
nipkow
parents: 69066
diff changeset
   118
nipkow
parents: 69066
diff changeset
   119
* Theory "HOL-Library.Multiset": the <Union># operator now has the same
nipkow
parents: 69066
diff changeset
   120
precedence as any other prefix function symbol.
68848
8825efd1c2cf updated URL to remote TPTP, following heads-up from Geoff Sutcliffe
blanchet
parents: 68824
diff changeset
   121
69316
248696d0a05f Retired lemma card_Union_image; use the simpler card_UN_disjoint instead.
nipkow
parents: 69282
diff changeset
   122
* Retired lemma card_Union_image; use the simpler card_UN_disjoint instead.
248696d0a05f Retired lemma card_Union_image; use the simpler card_UN_disjoint instead.
nipkow
parents: 69282
diff changeset
   123
68938
a0b19a163f5e left-over rename from 3f9bb52082c4
haftmann
parents: 68883
diff changeset
   124
* Facts sum_mset.commute and prod_mset.commute renamed to sum_mset.swap
a0b19a163f5e left-over rename from 3f9bb52082c4
haftmann
parents: 68883
diff changeset
   125
and prod_mset.swap, similarly to sum.swap and prod.swap.
a0b19a163f5e left-over rename from 3f9bb52082c4
haftmann
parents: 68883
diff changeset
   126
INCOMPATIBILITY.
a0b19a163f5e left-over rename from 3f9bb52082c4
haftmann
parents: 68883
diff changeset
   127
69164
74f1b0f10b2b uniform naming of strong congruence rules
nipkow
parents: 69155
diff changeset
   128
* Strong congruence rules (with =simp=> in the premises) for constant f
69546
27dae626822b prefer naming convention from datatype package for strong congruence rules
haftmann
parents: 69506
diff changeset
   129
are now uniformly called f_cong_simp, in accordance with congruence
27dae626822b prefer naming convention from datatype package for strong congruence rules
haftmann
parents: 69506
diff changeset
   130
rules produced for mappers by the datatype package. INCOMPATIBILITY.
69164
74f1b0f10b2b uniform naming of strong congruence rules
nipkow
parents: 69155
diff changeset
   131
69707
920fe0a2fd22 updated news
blanchet
parents: 69697
diff changeset
   132
* Sledgehammer:
920fe0a2fd22 updated news
blanchet
parents: 69697
diff changeset
   133
  - The URL for SystemOnTPTP, which is used by remote provers, has
920fe0a2fd22 updated news
blanchet
parents: 69697
diff changeset
   134
    been updated.
920fe0a2fd22 updated news
blanchet
parents: 69697
diff changeset
   135
  - The machine-learning-based filter MaSh has been optimized to take
920fe0a2fd22 updated news
blanchet
parents: 69697
diff changeset
   136
    less time (in most cases).
69037
nipkow
parents: 68938
diff changeset
   137
69205
8050734eee3e add reconstruction by veriT in method smt
fleury <Mathias.Fleury@mpi-inf.mpg.de>
parents: 69189
diff changeset
   138
* SMT: reconstruction is now possible using the SMT solver veriT.
8050734eee3e add reconstruction by veriT in method smt
fleury <Mathias.Fleury@mpi-inf.mpg.de>
parents: 69189
diff changeset
   139
69568
de09a7261120 new implementation for case_of_simps based on Code_Lazy's pattern matching elimination algorithm
Andreas Lochbihler
parents: 69506
diff changeset
   140
* HOL-Library.Simps_Case_Conv: case_of_simps now supports overlapping 
de09a7261120 new implementation for case_of_simps based on Code_Lazy's pattern matching elimination algorithm
Andreas Lochbihler
parents: 69506
diff changeset
   141
and non-exhaustive patterns and handles arbitrarily nested patterns.
de09a7261120 new implementation for case_of_simps based on Code_Lazy's pattern matching elimination algorithm
Andreas Lochbihler
parents: 69506
diff changeset
   142
It uses on the same algorithm as HOL-Library.Code_Lazy, which assumes
de09a7261120 new implementation for case_of_simps based on Code_Lazy's pattern matching elimination algorithm
Andreas Lochbihler
parents: 69506
diff changeset
   143
sequential left-to-right pattern matching. The generated
de09a7261120 new implementation for case_of_simps based on Code_Lazy's pattern matching elimination algorithm
Andreas Lochbihler
parents: 69506
diff changeset
   144
equation no longer tuples the arguments on the right-hand side.
de09a7261120 new implementation for case_of_simps based on Code_Lazy's pattern matching elimination algorithm
Andreas Lochbihler
parents: 69506
diff changeset
   145
INCOMPATIBILITY.
de09a7261120 new implementation for case_of_simps based on Code_Lazy's pattern matching elimination algorithm
Andreas Lochbihler
parents: 69506
diff changeset
   146
69099
d44cb8a3e5e0 HOL-SPARK .prv files are no longer written to the file-system;
wenzelm
parents: 69094
diff changeset
   147
* Session HOL-SPARK: .prv files are no longer written to the
d44cb8a3e5e0 HOL-SPARK .prv files are no longer written to the file-system;
wenzelm
parents: 69094
diff changeset
   148
file-system, but exported to the session database. Results may be
d44cb8a3e5e0 HOL-SPARK .prv files are no longer written to the file-system;
wenzelm
parents: 69094
diff changeset
   149
retrieved with the "isabelle export" command-line tool like this:
d44cb8a3e5e0 HOL-SPARK .prv files are no longer written to the file-system;
wenzelm
parents: 69094
diff changeset
   150
d44cb8a3e5e0 HOL-SPARK .prv files are no longer written to the file-system;
wenzelm
parents: 69094
diff changeset
   151
  isabelle export -x "*:**.prv" HOL-SPARK-Examples
d44cb8a3e5e0 HOL-SPARK .prv files are no longer written to the file-system;
wenzelm
parents: 69094
diff changeset
   152
68796
9ca183045102 simplified syntax setup for big operators under image, retaining input abbreviations for backward compatibility
haftmann
parents: 68770
diff changeset
   153
68803
169bf32b35dd retain original PolyML.pointerEq;
wenzelm
parents: 68796
diff changeset
   154
*** ML ***
169bf32b35dd retain original PolyML.pointerEq;
wenzelm
parents: 68796
diff changeset
   155
69708
1c201e4792cb Local_Theory.reset only required for toplevel interaction, attempt to withhold it from user space
haftmann
parents: 69707
diff changeset
   156
* Local_Theory.reset is no longer available in user space. Regular
1c201e4792cb Local_Theory.reset only required for toplevel interaction, attempt to withhold it from user space
haftmann
parents: 69707
diff changeset
   157
definitional packages should use balanced blocks of
1c201e4792cb Local_Theory.reset only required for toplevel interaction, attempt to withhold it from user space
haftmann
parents: 69707
diff changeset
   158
Local_Theory.open_target versus Local_Theory.close_target instead,
1c201e4792cb Local_Theory.reset only required for toplevel interaction, attempt to withhold it from user space
haftmann
parents: 69707
diff changeset
   159
or the Local_Theory.subtarget(_result) combinator. Rare INCOMPATIBILITY.
1c201e4792cb Local_Theory.reset only required for toplevel interaction, attempt to withhold it from user space
haftmann
parents: 69707
diff changeset
   160
68803
169bf32b35dd retain original PolyML.pointerEq;
wenzelm
parents: 68796
diff changeset
   161
* Original PolyML.pointerEq is retained as a convenience for tools that
169bf32b35dd retain original PolyML.pointerEq;
wenzelm
parents: 68796
diff changeset
   162
don't use Isabelle/ML (where this is called "pointer_eq").
169bf32b35dd retain original PolyML.pointerEq;
wenzelm
parents: 68796
diff changeset
   163
68824
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   164
* ML evaluation (notably via commands 'ML' and 'ML_file') is subject to
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   165
option ML_environment to select a named environment, such as "Isabelle"
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   166
for Isabelle/ML, or "SML" for official Standard ML. It is also possible
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   167
to move toplevel bindings between environments, using a notation with
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   168
">" as separator. For example:
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   169
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   170
  declare [[ML_environment = "Isabelle>SML"]]
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   171
  ML \<open>val println = writeln\<close>
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   172
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   173
  declare [[ML_environment = "SML"]]
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   174
  ML \<open>println "test"\<close>
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   175
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   176
  declare [[ML_environment = "Isabelle"]]
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   177
  ML \<open>println\<close>  \<comment> \<open>not present\<close>
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   178
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   179
The Isabelle/ML function ML_Env.setup defines new ML environments. This
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   180
is useful to incorporate big SML projects in an isolated name space, and
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   181
potentially with variations on ML syntax (existing ML_Env.SML_operations
7414ce0256e1 some NEWS (instead of proper documentation);
wenzelm
parents: 68803
diff changeset
   182
observes the official standard).
68803
169bf32b35dd retain original PolyML.pointerEq;
wenzelm
parents: 68796
diff changeset
   183
69381
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   184
* ML antiquotation @{master_dir} refers to the master directory of the
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   185
underlying theory, i.e. the directory of the theory file.
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   186
69470
c8c3285f1294 more ML antiquotations;
wenzelm
parents: 69381
diff changeset
   187
* ML antiquotation @{verbatim} inlines its argument as string literal,
c8c3285f1294 more ML antiquotations;
wenzelm
parents: 69381
diff changeset
   188
preserving newlines literally. The short form \<^verbatim>\<open>abc\<close> is particularly
c8c3285f1294 more ML antiquotations;
wenzelm
parents: 69381
diff changeset
   189
useful.
c8c3285f1294 more ML antiquotations;
wenzelm
parents: 69381
diff changeset
   190
69381
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   191
* Command 'generate_file' allows to produce sources for other languages,
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   192
with antiquotations in the Isabelle context (only the control-cartouche
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   193
form). The default "cartouche" antiquotation evaluates an ML expression
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   194
of type string and inlines the result as a string literal of the target
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   195
language. For example, this works for Haskell as follows:
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   196
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   197
  generate_file "Pure.hs" = \<open>
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   198
  module Isabelle.Pure where
69211
7062639cfdaa added GHC.read_source: read Haskell source text with antiquotations;
wenzelm
parents: 69189
diff changeset
   199
    allConst, impConst, eqConst :: String
7062639cfdaa added GHC.read_source: read Haskell source text with antiquotations;
wenzelm
parents: 69189
diff changeset
   200
    allConst = \<open>\<^const_name>\<open>Pure.all\<close>\<close>
7062639cfdaa added GHC.read_source: read Haskell source text with antiquotations;
wenzelm
parents: 69189
diff changeset
   201
    impConst = \<open>\<^const_name>\<open>Pure.imp\<close>\<close>
7062639cfdaa added GHC.read_source: read Haskell source text with antiquotations;
wenzelm
parents: 69189
diff changeset
   202
    eqConst = \<open>\<^const_name>\<open>Pure.eq\<close>\<close>
7062639cfdaa added GHC.read_source: read Haskell source text with antiquotations;
wenzelm
parents: 69189
diff changeset
   203
  \<close>
69381
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   204
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   205
The ML function Generate_File.generate writes all generated files from a
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   206
given theory to the file-system, e.g. a temporary directory where some
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   207
external compiler is applied.
4c9b4e2c5460 more general command 'generate_file' for registered file types, notably Haskell;
wenzelm
parents: 69377
diff changeset
   208
69282
94fa3376ba33 added ML antiquotation @{master_dir};
wenzelm
parents: 69277
diff changeset
   209
68883
3653b3ad729e clarified Thy_Resources.Session.use_theories: "terminated" node status is sufficient;
wenzelm
parents: 68879
diff changeset
   210
*** System ***
3653b3ad729e clarified Thy_Resources.Session.use_theories: "terminated" node status is sufficient;
wenzelm
parents: 68879
diff changeset
   211
69585
wenzelm
parents: 69580
diff changeset
   212
* The command-line tool "isabelle update" uses Isabelle/PIDE in
wenzelm
parents: 69580
diff changeset
   213
batch-mode to update theory sources based on semantic markup produced in
69609
wenzelm
parents: 69592
diff changeset
   214
Isabelle/ML. Actual updates depend on system options that may be enabled
69588
wenzelm
parents: 69586
diff changeset
   215
via "-u OPT" (for "update_OPT"), see also $ISABELLE_HOME/etc/options
wenzelm
parents: 69586
diff changeset
   216
section "Theory update". Theory sessions are specified as in "isabelle
69585
wenzelm
parents: 69580
diff changeset
   217
dump".
wenzelm
parents: 69580
diff changeset
   218
69592
a80d8ec6c998 support for isabelle update -u control_cartouches;
wenzelm
parents: 69588
diff changeset
   219
* The command-line tool "isabelle update -u control_cartouches" changes
a80d8ec6c998 support for isabelle update -u control_cartouches;
wenzelm
parents: 69588
diff changeset
   220
antiquotations into control-symbol format (where possible): @{NAME}
a80d8ec6c998 support for isabelle update -u control_cartouches;
wenzelm
parents: 69588
diff changeset
   221
becomes \<^NAME> and @{NAME ARG} becomes \<^NAME>\<open>ARG\<close>.
a80d8ec6c998 support for isabelle update -u control_cartouches;
wenzelm
parents: 69588
diff changeset
   222
69277
258bef08b31e support for user-defined Isabelle/Scala command-line tools;
wenzelm
parents: 69273
diff changeset
   223
* Support for Isabelle command-line tools defined in Isabelle/Scala.
258bef08b31e support for user-defined Isabelle/Scala command-line tools;
wenzelm
parents: 69273
diff changeset
   224
Instances of class Isabelle_Scala_Tools may be configured via the shell
258bef08b31e support for user-defined Isabelle/Scala command-line tools;
wenzelm
parents: 69273
diff changeset
   225
function "isabelle_scala_tools" in etc/settings (e.g. of an Isabelle
258bef08b31e support for user-defined Isabelle/Scala command-line tools;
wenzelm
parents: 69273
diff changeset
   226
component).
258bef08b31e support for user-defined Isabelle/Scala command-line tools;
wenzelm
parents: 69273
diff changeset
   227
69230
wenzelm
parents: 69216
diff changeset
   228
* Session directory $ISABELLE_HOME/src/Tools/Haskell provides some
wenzelm
parents: 69216
diff changeset
   229
source modules for Isabelle tools implemented in Haskell, notably for
wenzelm
parents: 69216
diff changeset
   230
Isabelle/PIDE.
wenzelm
parents: 69216
diff changeset
   231
69044
wenzelm
parents: 69042
diff changeset
   232
* Isabelle server command "use_theories" supports "nodes_status_delay"
wenzelm
parents: 69042
diff changeset
   233
for continuous output of node status information. The time interval is
wenzelm
parents: 69042
diff changeset
   234
specified in seconds; a negative value means it is disabled (default).
wenzelm
parents: 69042
diff changeset
   235
wenzelm
parents: 69042
diff changeset
   236
* Isabelle Server command "use_theories" terminates more robustly in the
68883
3653b3ad729e clarified Thy_Resources.Session.use_theories: "terminated" node status is sufficient;
wenzelm
parents: 68879
diff changeset
   237
presence of structurally broken sources: full consolidation of theories
3653b3ad729e clarified Thy_Resources.Session.use_theories: "terminated" node status is sufficient;
wenzelm
parents: 68879
diff changeset
   238
is no longer required.
3653b3ad729e clarified Thy_Resources.Session.use_theories: "terminated" node status is sufficient;
wenzelm
parents: 68879
diff changeset
   239
69268
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   240
* Support for managed installations of Glasgow Haskell Compiler and
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   241
OCaml via the following command-line tools:
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   242
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   243
  isabelle ghc_setup
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   244
  isabelle ghc_stack
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   245
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   246
  isabelle ocaml_setup
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   247
  isabelle ocaml_opam
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   248
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   249
The global installation state is determined by the following settings
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   250
(and corresponding directory contents):
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   251
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   252
  ISABELLE_STACK_ROOT
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   253
  ISABELLE_STACK_RESOLVER
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   254
  ISABELLE_GHC_VERSION
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   255
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   256
  ISABELLE_OPAM_ROOT
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   257
  ISABELLE_OCAML_VERSION
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   258
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   259
After setup, the following Isabelle settings are automatically
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   260
redirected (overriding existing user settings):
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   261
69269
1bee990d443c tuned whitespace;
wenzelm
parents: 69268
diff changeset
   262
  ISABELLE_GHC
1bee990d443c tuned whitespace;
wenzelm
parents: 69268
diff changeset
   263
1bee990d443c tuned whitespace;
wenzelm
parents: 69268
diff changeset
   264
  ISABELLE_OCAML
1bee990d443c tuned whitespace;
wenzelm
parents: 69268
diff changeset
   265
  ISABELLE_OCAMLC
69268
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   266
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   267
The old meaning of these settings as locally installed executables may
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   268
be recovered by purging the directories ISABELLE_STACK_ROOT /
c1a27fce2076 clarified tool setup for GHC / OCaml: discontinued "isabelle ghc", "isabelle ocaml", "isabelle ocamlc" to avoid confusion with traditional settings variables for executables (these are still required in existing applications, notably in session options [condition = ISABELLE_GHC] etc. and codegen setup;
wenzelm
parents: 69230
diff changeset
   269
ISABELLE_OPAM_ROOT.
69189
wenzelm
parents: 69183
diff changeset
   270
wenzelm
parents: 69183
diff changeset
   271
* Update to Java 11: the latest long-term support version of OpenJDK.
69151
b310bc57f55f support for GHC via command-line tools;
wenzelm
parents: 69135
diff changeset
   272
69755
2fc85ce1f557 discontinued obsolete option "checkpoint";
wenzelm
parents: 69747
diff changeset
   273
* System option "checkpoint" has been discontinued: obsolete thanks to
2fc85ce1f557 discontinued obsolete option "checkpoint";
wenzelm
parents: 69747
diff changeset
   274
improved memory management in Poly/ML.
68883
3653b3ad729e clarified Thy_Resources.Session.use_theories: "terminated" node status is sufficient;
wenzelm
parents: 68879
diff changeset
   275
3653b3ad729e clarified Thy_Resources.Session.use_theories: "terminated" node status is sufficient;
wenzelm
parents: 68879
diff changeset
   276
68391
9b4f60bdad54 updated for release;
wenzelm
parents: 68373
diff changeset
   277
New in Isabelle2018 (August 2018)
9b4f60bdad54 updated for release;
wenzelm
parents: 68373
diff changeset
   278
---------------------------------
66651
435cb8d69e27 back to post-release mode -- after fork point;
wenzelm
parents: 66650
diff changeset
   279
66712
4c98c929a12a session-qualified theory names are mandatory;
wenzelm
parents: 66688
diff changeset
   280
*** General ***
4c98c929a12a session-qualified theory names are mandatory;
wenzelm
parents: 66688
diff changeset
   281
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   282
* Session-qualified theory names are mandatory: it is no longer possible
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   283
to refer to unqualified theories from the parent session.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   284
INCOMPATIBILITY for old developments that have not been updated to
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   285
Isabelle2017 yet (using the "isabelle imports" tool).
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   286
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   287
* Only the most fundamental theory names are global, usually the entry
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   288
points to major logic sessions: Pure, Main, Complex_Main, HOLCF, IFOL,
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   289
FOL, ZF, ZFC etc. INCOMPATIBILITY, need to use qualified names for
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   290
formerly global "HOL-Probability.Probability" and "HOL-SPARK.SPARK".
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   291
68558
7aae213d9e69 discontinued pending_shyps: too much complication due to lazy facts;
wenzelm
parents: 68548
diff changeset
   292
* Global facts need to be closed: no free variables and no hypotheses.
7aae213d9e69 discontinued pending_shyps: too much complication due to lazy facts;
wenzelm
parents: 68548
diff changeset
   293
Rare INCOMPATIBILITY.
68540
000a0e062529 disallow pending hyps;
wenzelm
parents: 68523
diff changeset
   294
68661
5820f0f379ae added system option "strict_facts";
wenzelm
parents: 68647
diff changeset
   295
* Facts stemming from locale interpretation are subject to lazy
5820f0f379ae added system option "strict_facts";
wenzelm
parents: 68647
diff changeset
   296
evaluation for improved performance. Rare INCOMPATIBILITY: errors
5820f0f379ae added system option "strict_facts";
wenzelm
parents: 68647
diff changeset
   297
stemming from interpretation morphisms might be deferred and thus
5820f0f379ae added system option "strict_facts";
wenzelm
parents: 68647
diff changeset
   298
difficult to locate; enable system option "strict_facts" temporarily to
5820f0f379ae added system option "strict_facts";
wenzelm
parents: 68647
diff changeset
   299
avoid this.
5820f0f379ae added system option "strict_facts";
wenzelm
parents: 68647
diff changeset
   300
67446
1f4d167b6ac9 discontinued old form of marginal comments;
wenzelm
parents: 67433
diff changeset
   301
* Marginal comments need to be written exclusively in the new-style form
1f4d167b6ac9 discontinued old form of marginal comments;
wenzelm
parents: 67433
diff changeset
   302
"\<comment> \<open>text\<close>", old ASCII variants like "-- {* ... *}" are no longer
1f4d167b6ac9 discontinued old form of marginal comments;
wenzelm
parents: 67433
diff changeset
   303
supported. INCOMPATIBILITY, use the command-line tool "isabelle
1f4d167b6ac9 discontinued old form of marginal comments;
wenzelm
parents: 67433
diff changeset
   304
update_comments" to update existing theory files.
1f4d167b6ac9 discontinued old form of marginal comments;
wenzelm
parents: 67433
diff changeset
   305
67507
5db077cfe1b2 old-style inner comments are legacy;
wenzelm
parents: 67448
diff changeset
   306
* Old-style inner comments (* ... *) within the term language are legacy
5db077cfe1b2 old-style inner comments are legacy;
wenzelm
parents: 67448
diff changeset
   307
and will be discontinued soon: use formal comments "\<comment> \<open>...\<close>" or "\<^cancel>\<open>...\<close>"
5db077cfe1b2 old-style inner comments are legacy;
wenzelm
parents: 67448
diff changeset
   308
instead.
5db077cfe1b2 old-style inner comments are legacy;
wenzelm
parents: 67448
diff changeset
   309
67402
nipkow
parents: 67400
diff changeset
   310
* The "op <infix-op>" syntax for infix operators has been replaced by
67400
nipkow
parents: 67398
diff changeset
   311
"(<infix-op>)". If <infix-op> begins or ends with a "*", there needs to
nipkow
parents: 67398
diff changeset
   312
be a space between the "*" and the corresponding parenthesis.
68543
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   313
INCOMPATIBILITY, use the command-line tool "isabelle update_op" to
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   314
convert theory and ML files to the new syntax. Because it is based on
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   315
regular expression matching, the result may need a bit of manual
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   316
postprocessing. Invoking "isabelle update_op" converts all files in the
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   317
current directory (recursively). In case you want to exclude conversion
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   318
of ML files (because the tool frequently also converts ML's "op"
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   319
syntax), use option "-m".
67398
5eb932e604a2 Manual updates towards conversion of "op" syntax
nipkow
parents: 67395
diff changeset
   320
67013
335a7dce7cb3 more uniform header syntax, in contrast to the former etc/abbrevs file-format (see 73939a9b70a3);
wenzelm
parents: 66994
diff changeset
   321
* Theory header 'abbrevs' specifications need to be separated by 'and'.
335a7dce7cb3 more uniform header syntax, in contrast to the former etc/abbrevs file-format (see 73939a9b70a3);
wenzelm
parents: 66994
diff changeset
   322
INCOMPATIBILITY.
335a7dce7cb3 more uniform header syntax, in contrast to the former etc/abbrevs file-format (see 73939a9b70a3);
wenzelm
parents: 66994
diff changeset
   323
66757
e32750d7acb4 added command 'external_file';
wenzelm
parents: 66745
diff changeset
   324
* Command 'external_file' declares the formal dependency on the given
e32750d7acb4 added command 'external_file';
wenzelm
parents: 66745
diff changeset
   325
file name, such that the Isabelle build process knows about it, but
e32750d7acb4 added command 'external_file';
wenzelm
parents: 66745
diff changeset
   326
without specific Prover IDE management.
e32750d7acb4 added command 'external_file';
wenzelm
parents: 66745
diff changeset
   327
66759
918f15c9367a discontinued obsolete 'files' in session ROOT;
wenzelm
parents: 66757
diff changeset
   328
* Session ROOT entries no longer allow specification of 'files'. Rare
918f15c9367a discontinued obsolete 'files' in session ROOT;
wenzelm
parents: 66757
diff changeset
   329
INCOMPATIBILITY, use command 'external_file' within a proper theory
918f15c9367a discontinued obsolete 'files' in session ROOT;
wenzelm
parents: 66757
diff changeset
   330
context.
918f15c9367a discontinued obsolete 'files' in session ROOT;
wenzelm
parents: 66757
diff changeset
   331
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   332
* Session root directories may be specified multiple times: each
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   333
accessible ROOT file is processed only once. This facilitates
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   334
specification of $ISABELLE_HOME_USER/ROOTS or command-line options like
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   335
-d or -D for "isabelle build" and "isabelle jedit". Example:
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   336
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   337
  isabelle build -D '~~/src/ZF'
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   338
67263
449a989f42cd discontinued 'display_drafts' command;
wenzelm
parents: 67262
diff changeset
   339
* The command 'display_drafts' has been discontinued. INCOMPATIBILITY,
449a989f42cd discontinued 'display_drafts' command;
wenzelm
parents: 67262
diff changeset
   340
use action "isabelle.draft" (or "print") in Isabelle/jEdit instead.
449a989f42cd discontinued 'display_drafts' command;
wenzelm
parents: 67262
diff changeset
   341
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   342
* In HTML output, the Isabelle symbol "\<hyphen>" is rendered as explicit
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   343
Unicode hyphen U+2010, to avoid unclear meaning of the old "soft hyphen"
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   344
U+00AD. Rare INCOMPATIBILITY, e.g. copy-paste of historic Isabelle HTML
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   345
output.
67305
ecb74607063f more robust hyphen (see also "Soft hyphen (SHY) – a hard problem?" http://jkorpela.fi/shy.html);
wenzelm
parents: 67304
diff changeset
   346
66712
4c98c929a12a session-qualified theory names are mandatory;
wenzelm
parents: 66688
diff changeset
   347
67261
wenzelm
parents: 67248
diff changeset
   348
*** Isabelle/jEdit Prover IDE ***
66768
f27488f47a47 completion supports theory header imports;
wenzelm
parents: 66764
diff changeset
   349
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   350
* The command-line tool "isabelle jedit" provides more flexible options
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   351
for session management:
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   352
68472
581a1bfec8ad clarified documentation;
wenzelm
parents: 68469
diff changeset
   353
  - option -R builds an auxiliary logic image with all theories from
581a1bfec8ad clarified documentation;
wenzelm
parents: 68469
diff changeset
   354
    other sessions that are not already present in its parent
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   355
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   356
  - option -S is like -R, with a focus on the selected session and its
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   357
    descendants (this reduces startup time for big projects like AFP)
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   358
68472
581a1bfec8ad clarified documentation;
wenzelm
parents: 68469
diff changeset
   359
  - option -A specifies an alternative ancestor session for options -R
581a1bfec8ad clarified documentation;
wenzelm
parents: 68469
diff changeset
   360
    and -S
581a1bfec8ad clarified documentation;
wenzelm
parents: 68469
diff changeset
   361
68541
12b4b3bc585d command-line option for include_sessions;
wenzelm
parents: 68540
diff changeset
   362
  - option -i includes additional sessions into the name-space of
12b4b3bc585d command-line option for include_sessions;
wenzelm
parents: 68540
diff changeset
   363
    theories
12b4b3bc585d command-line option for include_sessions;
wenzelm
parents: 68540
diff changeset
   364
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   365
  Examples:
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   366
    isabelle jedit -R HOL-Number_Theory
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   367
    isabelle jedit -R HOL-Number_Theory -A HOL
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   368
    isabelle jedit -d '$AFP' -S Formal_SSA -A HOL
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   369
    isabelle jedit -d '$AFP' -S Formal_SSA -A HOL-Analysis
68541
12b4b3bc585d command-line option for include_sessions;
wenzelm
parents: 68540
diff changeset
   370
    isabelle jedit -d '$AFP' -S Formal_SSA -A HOL-Analysis -i CryptHOL
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   371
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   372
* PIDE markup for session ROOT files: allows to complete session names,
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   373
follow links to theories and document files etc.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   374
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   375
* Completion supports theory header imports, using theory base name.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   376
E.g. "Prob" may be completed to "HOL-Probability.Probability".
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   377
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   378
* Named control symbols (without special Unicode rendering) are shown as
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   379
bold-italic keyword. This is particularly useful for the short form of
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   380
antiquotations with control symbol: \<^name>\<open>argument\<close>. The action
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   381
"isabelle.antiquoted_cartouche" turns an antiquotation with 0 or 1
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   382
arguments into this format.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   383
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   384
* Completion provides templates for named symbols with arguments,
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   385
e.g. "\<comment> \<open>ARGUMENT\<close>" or "\<^emph>\<open>ARGUMENT\<close>".
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   386
68368
wenzelm
parents: 68364
diff changeset
   387
* Slightly more parallel checking, notably for high priority print
wenzelm
parents: 68364
diff changeset
   388
functions (e.g. State output).
wenzelm
parents: 68364
diff changeset
   389
68080
17f79ae49401 set view title dynamically;
wenzelm
parents: 68073
diff changeset
   390
* The view title is set dynamically, according to the Isabelle
17f79ae49401 set view title dynamically;
wenzelm
parents: 68073
diff changeset
   391
distribution and the logic session name. The user can override this via
17f79ae49401 set view title dynamically;
wenzelm
parents: 68073
diff changeset
   392
set-view-title (stored persistently in $JEDIT_SETTINGS/perspective.xml).
17f79ae49401 set view title dynamically;
wenzelm
parents: 68073
diff changeset
   393
67395
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67381
diff changeset
   394
* System options "spell_checker_include" and "spell_checker_exclude"
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67381
diff changeset
   395
supersede former "spell_checker_elements" to determine regions of text
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67381
diff changeset
   396
that are subject to spell-checking. Minor INCOMPATIBILITY.
b39d596b77ce more accurate spell-checking for nested quotations / antiquotations, notably in formal comments;
wenzelm
parents: 67381
diff changeset
   397
67248
68177abb2988 isabelle.preview presents bibtex database files as well;
wenzelm
parents: 67246
diff changeset
   398
* Action "isabelle.preview" is able to present more file formats,
67266
wenzelm
parents: 67263
diff changeset
   399
notably bibtex database files and ML files.
67246
4cedf44f2af1 isabelle.preview presents auxiliary text files as well;
wenzelm
parents: 67224
diff changeset
   400
67262
46540a2ead4b action "isabelle.draft" for plain-text preview;
wenzelm
parents: 67261
diff changeset
   401
* Action "isabelle.draft" is similar to "isabelle.preview", but shows a
68067
b91c4acc1aaf clarified menu actions;
wenzelm
parents: 68033
diff changeset
   402
plain-text document draft. Both are available via the menu "Plugins /
b91c4acc1aaf clarified menu actions;
wenzelm
parents: 68033
diff changeset
   403
Isabelle".
67262
46540a2ead4b action "isabelle.draft" for plain-text preview;
wenzelm
parents: 67261
diff changeset
   404
67304
3cf05d7cf174 more robust treatment of conflicts with existing Unicode text;
wenzelm
parents: 67303
diff changeset
   405
* When loading text files, the Isabelle symbols encoding UTF-8-Isabelle
3cf05d7cf174 more robust treatment of conflicts with existing Unicode text;
wenzelm
parents: 67303
diff changeset
   406
is only used if there is no conflict with existing Unicode sequences in
3cf05d7cf174 more robust treatment of conflicts with existing Unicode text;
wenzelm
parents: 67303
diff changeset
   407
the file. Otherwise, the fallback encoding is plain UTF-8 and Isabelle
3cf05d7cf174 more robust treatment of conflicts with existing Unicode text;
wenzelm
parents: 67303
diff changeset
   408
symbols remain in literal \<symbol> form. This avoids accidental loss of
3cf05d7cf174 more robust treatment of conflicts with existing Unicode text;
wenzelm
parents: 67303
diff changeset
   409
Unicode content when saving the file.
3cf05d7cf174 more robust treatment of conflicts with existing Unicode text;
wenzelm
parents: 67303
diff changeset
   410
68545
7922992c99ea misc tuning and updates for release;
wenzelm
parents: 68543
diff changeset
   411
* Bibtex database files (.bib) are semantically checked.
7922992c99ea misc tuning and updates for release;
wenzelm
parents: 68543
diff changeset
   412
67993
wenzelm
parents: 67928
diff changeset
   413
* Update to jedit-5.5.0, the latest release.
wenzelm
parents: 67928
diff changeset
   414
67246
4cedf44f2af1 isabelle.preview presents auxiliary text files as well;
wenzelm
parents: 67224
diff changeset
   415
67261
wenzelm
parents: 67248
diff changeset
   416
*** Isabelle/VSCode Prover IDE ***
wenzelm
parents: 67248
diff changeset
   417
wenzelm
parents: 67248
diff changeset
   418
* HTML preview of theories and other file-formats similar to
wenzelm
parents: 67248
diff changeset
   419
Isabelle/jEdit.
wenzelm
parents: 67248
diff changeset
   420
68690
354c04092cd0 more flexible session selection as in "isabelle jedit";
wenzelm
parents: 68681
diff changeset
   421
* Command-line tool "isabelle vscode_server" accepts the same options
354c04092cd0 more flexible session selection as in "isabelle jedit";
wenzelm
parents: 68681
diff changeset
   422
-A, -R, -S, -i for session selection as "isabelle jedit". This is
354c04092cd0 more flexible session selection as in "isabelle jedit";
wenzelm
parents: 68681
diff changeset
   423
relevant for isabelle.args configuration settings in VSCode. The former
354c04092cd0 more flexible session selection as in "isabelle jedit";
wenzelm
parents: 68681
diff changeset
   424
option -A (explore all known session files) has been discontinued: it is
354c04092cd0 more flexible session selection as in "isabelle jedit";
wenzelm
parents: 68681
diff changeset
   425
enabled by default, unless option -S is used to focus on a particular
354c04092cd0 more flexible session selection as in "isabelle jedit";
wenzelm
parents: 68681
diff changeset
   426
spot in the session structure. INCOMPATIBILITY.
354c04092cd0 more flexible session selection as in "isabelle jedit";
wenzelm
parents: 68681
diff changeset
   427
66768
f27488f47a47 completion supports theory header imports;
wenzelm
parents: 66764
diff changeset
   428
67140
386a31d6d17a more documentation;
wenzelm
parents: 67133
diff changeset
   429
*** Document preparation ***
386a31d6d17a more documentation;
wenzelm
parents: 67133
diff changeset
   430
67448
dbb1f02e667d more documentation;
wenzelm
parents: 67446
diff changeset
   431
* Formal comments work uniformly in outer syntax, inner syntax (term
dbb1f02e667d more documentation;
wenzelm
parents: 67446
diff changeset
   432
language), Isabelle/ML and some other embedded languages of Isabelle.
dbb1f02e667d more documentation;
wenzelm
parents: 67446
diff changeset
   433
See also "Document comments" in the isar-ref manual. The following forms
dbb1f02e667d more documentation;
wenzelm
parents: 67446
diff changeset
   434
are supported:
dbb1f02e667d more documentation;
wenzelm
parents: 67446
diff changeset
   435
dbb1f02e667d more documentation;
wenzelm
parents: 67446
diff changeset
   436
  - marginal text comment: \<comment> \<open>\<dots>\<close>
dbb1f02e667d more documentation;
wenzelm
parents: 67446
diff changeset
   437
  - canceled source: \<^cancel>\<open>\<dots>\<close>
dbb1f02e667d more documentation;
wenzelm
parents: 67446
diff changeset
   438
  - raw LaTeX: \<^latex>\<open>\<dots>\<close>
67413
2555713586c8 added \<^cancel> operator for unused text;
wenzelm
parents: 67402
diff changeset
   439
67381
146757999c8d theory Pure is default presentation context;
wenzelm
parents: 67368
diff changeset
   440
* Outside of the inner theory body, the default presentation context is
146757999c8d theory Pure is default presentation context;
wenzelm
parents: 67368
diff changeset
   441
theory Pure. Thus elementary antiquotations may be used in markup
146757999c8d theory Pure is default presentation context;
wenzelm
parents: 67368
diff changeset
   442
commands (e.g. 'chapter', 'section', 'text') and formal comments.
146757999c8d theory Pure is default presentation context;
wenzelm
parents: 67368
diff changeset
   443
68513
88b0e63d58a5 updated documentation;
wenzelm
parents: 68484
diff changeset
   444
* System option "document_tags" specifies alternative command tags. This
88b0e63d58a5 updated documentation;
wenzelm
parents: 68484
diff changeset
   445
is occasionally useful to control the global visibility of commands via
88b0e63d58a5 updated documentation;
wenzelm
parents: 68484
diff changeset
   446
session options (e.g. in ROOT).
67140
386a31d6d17a more documentation;
wenzelm
parents: 67133
diff changeset
   447
386a31d6d17a more documentation;
wenzelm
parents: 67133
diff changeset
   448
* Document markup commands ('section', 'text' etc.) are implicitly
386a31d6d17a more documentation;
wenzelm
parents: 67133
diff changeset
   449
tagged as "document" and visible by default. This avoids the application
386a31d6d17a more documentation;
wenzelm
parents: 67133
diff changeset
   450
of option "document_tags" to these commands.
386a31d6d17a more documentation;
wenzelm
parents: 67133
diff changeset
   451
67145
e77c5bfca9aa name mangling for Latex macros;
wenzelm
parents: 67140
diff changeset
   452
* Isabelle names are mangled into LaTeX macro names to allow the full
e77c5bfca9aa name mangling for Latex macros;
wenzelm
parents: 67140
diff changeset
   453
identifier syntax with underscore, prime, digits. This is relevant for
e77c5bfca9aa name mangling for Latex macros;
wenzelm
parents: 67140
diff changeset
   454
antiquotations in control symbol notation, e.g. \<^const_name> becomes
e77c5bfca9aa name mangling for Latex macros;
wenzelm
parents: 67140
diff changeset
   455
\isactrlconstUNDERSCOREname.
e77c5bfca9aa name mangling for Latex macros;
wenzelm
parents: 67140
diff changeset
   456
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   457
* Document preparation with skip_proofs option now preserves the content
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   458
more accurately: only terminal proof steps ('by' etc.) are skipped.
67297
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67295
diff changeset
   459
68484
59793df7f853 clarified document antiquotation @{theory};
wenzelm
parents: 68472
diff changeset
   460
* Document antiquotation @{theory name} requires the long
59793df7f853 clarified document antiquotation @{theory};
wenzelm
parents: 68472
diff changeset
   461
session-qualified theory name: this is what users reading the text
59793df7f853 clarified document antiquotation @{theory};
wenzelm
parents: 68472
diff changeset
   462
normally need to import.
59793df7f853 clarified document antiquotation @{theory};
wenzelm
parents: 68472
diff changeset
   463
67219
81e9804b2014 added document antiquotation @{session name};
wenzelm
parents: 67215
diff changeset
   464
* Document antiquotation @{session name} checks and prints the given
81e9804b2014 added document antiquotation @{session name};
wenzelm
parents: 67215
diff changeset
   465
session name verbatim.
81e9804b2014 added document antiquotation @{session name};
wenzelm
parents: 67215
diff changeset
   466
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   467
* Document antiquotation @{cite} now checks the given Bibtex entries
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   468
against the Bibtex database files -- only in batch-mode session builds.
67157
d0657c8b7616 clarified document preparation vs. skip_proofs;
wenzelm
parents: 67145
diff changeset
   469
67176
13b5c3ff1954 re-implemented "isabelle document" in Isabelle/Scala, include latex_errors here;
wenzelm
parents: 67173
diff changeset
   470
* Command-line tool "isabelle document" has been re-implemented in
67194
1c0a6a957114 positions as postlude: avoid intrusion of odd %-forms into main tex source;
wenzelm
parents: 67191
diff changeset
   471
Isabelle/Scala, with simplified arguments and explicit errors from the
67203
85784e16bec8 expose bibtex errors;
wenzelm
parents: 67199
diff changeset
   472
latex and bibtex process. Minor INCOMPATIBILITY.
67173
e746db6db903 more explicit latex errors;
wenzelm
parents: 67157
diff changeset
   473
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   474
* Session ROOT entry: empty 'document_files' means there is no document
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   475
for this session. There is no need to specify options [document = false]
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   476
anymore.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   477
67140
386a31d6d17a more documentation;
wenzelm
parents: 67133
diff changeset
   478
67702
2d9918f5b33c command 'interpret' no longer exposes resulting theorems as literal facts;
wenzelm
parents: 67616
diff changeset
   479
*** Isar ***
2d9918f5b33c command 'interpret' no longer exposes resulting theorems as literal facts;
wenzelm
parents: 67616
diff changeset
   480
2d9918f5b33c command 'interpret' no longer exposes resulting theorems as literal facts;
wenzelm
parents: 67616
diff changeset
   481
* Command 'interpret' no longer exposes resulting theorems as literal
2d9918f5b33c command 'interpret' no longer exposes resulting theorems as literal facts;
wenzelm
parents: 67616
diff changeset
   482
facts, notably for the \<open>prop\<close> notation or the "fact" proof method. This
2d9918f5b33c command 'interpret' no longer exposes resulting theorems as literal facts;
wenzelm
parents: 67616
diff changeset
   483
improves modularity of proofs and scalability of locale interpretation.
2d9918f5b33c command 'interpret' no longer exposes resulting theorems as literal facts;
wenzelm
parents: 67616
diff changeset
   484
Rare INCOMPATIBILITY, need to refer to explicitly named facts instead
2d9918f5b33c command 'interpret' no longer exposes resulting theorems as literal facts;
wenzelm
parents: 67616
diff changeset
   485
(e.g. use 'find_theorems' or 'try' to figure this out).
2d9918f5b33c command 'interpret' no longer exposes resulting theorems as literal facts;
wenzelm
parents: 67616
diff changeset
   486
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   487
* The old 'def' command has been discontinued (legacy since
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   488
Isbelle2016-1). INCOMPATIBILITY, use 'define' instead -- usually with
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   489
object-logic equality or equivalence.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   490
68543
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   491
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   492
*** Pure ***
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   493
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   494
* The inner syntax category "sort" now includes notation "_" for the
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   495
dummy sort: it is effectively ignored in type-inference.
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   496
67740
b6ce18784872 Proper rewrite morphisms in locale instances.
ballarin
parents: 67718
diff changeset
   497
* Rewrites clauses (keyword 'rewrites') were moved into the locale
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   498
expression syntax, where they are part of locale instances. In
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   499
interpretation commands rewrites clauses now need to occur before 'for'
68469
aad109fde9ec In interpretation commands, clarify what to do with definitions immediately subject to rewriting.
ballarin
parents: 68466
diff changeset
   500
and 'defines'. Rare INCOMPATIBILITY; definitions immediately subject to
aad109fde9ec In interpretation commands, clarify what to do with definitions immediately subject to rewriting.
ballarin
parents: 68466
diff changeset
   501
rewriting may need to be pulled up into the surrounding theory.
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   502
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   503
* For 'rewrites' clauses, if activating a locale instance fails, fall
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   504
back to reading the clause first. This helps avoid qualification of
67764
0f8cb5568b63 Drop rewrites after defines in interpretations.
ballarin
parents: 67741
diff changeset
   505
locale instances where the qualifier's sole purpose is avoiding
0f8cb5568b63 Drop rewrites after defines in interpretations.
ballarin
parents: 67741
diff changeset
   506
duplicate constant declarations.
67741
d5a7f2c54655 Fall back to reading rewrite morphism first if activation fails without it.
ballarin
parents: 67740
diff changeset
   507
68543
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   508
* Proof method "simp" now supports a new modifier "flip:" followed by a
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   509
list of theorems. Each of these theorems is removed from the simpset
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   510
(without warning if it is not there) and the symmetric version of the
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   511
theorem (i.e. lhs and rhs exchanged) is added to the simpset. For "auto"
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   512
and friends the modifier is "simp flip:".
67718
17874d43d3b3 notation for dummy sort;
wenzelm
parents: 67702
diff changeset
   513
17874d43d3b3 notation for dummy sort;
wenzelm
parents: 67702
diff changeset
   514
66661
fdab65297bd6 real oracle
blanchet
parents: 66651
diff changeset
   515
*** HOL ***
fdab65297bd6 real oracle
blanchet
parents: 66651
diff changeset
   516
68568
cf01d04e94d7 more NEWS;
wenzelm
parents: 68558
diff changeset
   517
* Sledgehammer: bundled version of "vampire" (for non-commercial users)
cf01d04e94d7 more NEWS;
wenzelm
parents: 68558
diff changeset
   518
helps to avoid fragility of "remote_vampire" service.
cf01d04e94d7 more NEWS;
wenzelm
parents: 68558
diff changeset
   519
68028
1f9f973eed2a proper datatype for 8-bit characters
haftmann
parents: 68027
diff changeset
   520
* Clarified relationship of characters, strings and code generation:
1f9f973eed2a proper datatype for 8-bit characters
haftmann
parents: 68027
diff changeset
   521
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   522
  - Type "char" is now a proper datatype of 8-bit values.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   523
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   524
  - Conversions "nat_of_char" and "char_of_nat" are gone; use more
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   525
    general conversions "of_char" and "char_of" with suitable type
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   526
    constraints instead.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   527
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   528
  - The zero character is just written "CHR 0x00", not "0" any longer.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   529
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   530
  - Type "String.literal" (for code generation) is now isomorphic to
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   531
    lists of 7-bit (ASCII) values; concrete values can be written as
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   532
    "STR ''...''" for sequences of printable characters and "STR 0x..."
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   533
    for one single ASCII code point given as hexadecimal numeral.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   534
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   535
  - Type "String.literal" supports concatenation "... + ..." for all
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   536
    standard target languages.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   537
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   538
  - Theory HOL-Library.Code_Char is gone; study the explanations
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   539
    concerning "String.literal" in the tutorial on code generation to
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   540
    get an idea how target-language string literals can be converted to
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   541
    HOL string values and vice versa.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   542
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   543
  - Session Imperative-HOL: operation "raise" directly takes a value of
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   544
    type "String.literal" as argument, not type "string".
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   545
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   546
INCOMPATIBILITY.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   547
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   548
* Code generation: Code generation takes an explicit option
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   549
"case_insensitive" to accomodate case-insensitive file systems.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   550
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   551
* Abstract bit operations as part of Main: push_bit, take_bit, drop_bit.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   552
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   553
* New, more general, axiomatization of complete_distrib_lattice. The
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   554
former axioms:
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   555
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   556
  "sup x (Inf X) = Inf (sup x ` X)" and "inf x (Sup X) = Sup (inf x ` X)"
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   557
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   558
are replaced by:
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   559
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   560
  "Inf (Sup ` A) <= Sup (Inf ` {f ` A | f . (! Y \<in> A . f Y \<in> Y)})"
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   561
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   562
The instantiations of sets and functions as complete_distrib_lattice are
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   563
moved to Hilbert_Choice.thy because their proofs need the Hilbert choice
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   564
operator. The dual of this property is also proved in theory
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   565
HOL.Hilbert_Choice.
67831
07f5588f2735 Removed stray 'sledgehammer' invocation
Manuel Eberl <eberlm@in.tum.de>
parents: 67830
diff changeset
   566
67999
1b05f74f2e5f tidying up including contributions from Paulo Emílio de Vilhena
paulson <lp15@cam.ac.uk>
parents: 67993
diff changeset
   567
* New syntax for the minimum/maximum of a function over a finite set:
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   568
MIN x\<in>A. B and even MIN x. B (only useful for finite types), also MAX.
67999
1b05f74f2e5f tidying up including contributions from Paulo Emílio de Vilhena
paulson <lp15@cam.ac.uk>
parents: 67993
diff changeset
   569
67525
5d04d7bcd5f6 avoid concrete (anti)mono in theorem names since it could be the other way round
haftmann
parents: 67510
diff changeset
   570
* Clarifed theorem names:
5d04d7bcd5f6 avoid concrete (anti)mono in theorem names since it could be the other way round
haftmann
parents: 67510
diff changeset
   571
5d04d7bcd5f6 avoid concrete (anti)mono in theorem names since it could be the other way round
haftmann
parents: 67510
diff changeset
   572
  Min.antimono ~> Min.subset_imp
5d04d7bcd5f6 avoid concrete (anti)mono in theorem names since it could be the other way round
haftmann
parents: 67510
diff changeset
   573
  Max.antimono ~> Max.subset_imp
5d04d7bcd5f6 avoid concrete (anti)mono in theorem names since it could be the other way round
haftmann
parents: 67510
diff changeset
   574
5d04d7bcd5f6 avoid concrete (anti)mono in theorem names since it could be the other way round
haftmann
parents: 67510
diff changeset
   575
Minor INCOMPATIBILITY.
5d04d7bcd5f6 avoid concrete (anti)mono in theorem names since it could be the other way round
haftmann
parents: 67510
diff changeset
   576
66661
fdab65297bd6 real oracle
blanchet
parents: 66651
diff changeset
   577
* SMT module:
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   578
66661
fdab65297bd6 real oracle
blanchet
parents: 66651
diff changeset
   579
  - The 'smt_oracle' option is now necessary when using the 'smt' method
66662
4b10fa05423b document incompatibility
blanchet
parents: 66661
diff changeset
   580
    with a solver other than Z3. INCOMPATIBILITY.
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   581
66844
0746d4781674 tuned whitespace;
wenzelm
parents: 66843
diff changeset
   582
  - The encoding to first-order logic is now more complete in the
0746d4781674 tuned whitespace;
wenzelm
parents: 66843
diff changeset
   583
    presence of higher-order quantifiers. An 'smt_explicit_application'
0746d4781674 tuned whitespace;
wenzelm
parents: 66843
diff changeset
   584
    option has been added to control this. INCOMPATIBILITY.
0746d4781674 tuned whitespace;
wenzelm
parents: 66843
diff changeset
   585
66804
3f9bb52082c4 avoid name clashes on interpretation of abstract locales
haftmann
parents: 66803
diff changeset
   586
* Facts sum.commute(_restrict) and prod.commute(_restrict) renamed to
66844
0746d4781674 tuned whitespace;
wenzelm
parents: 66843
diff changeset
   587
sum.swap(_restrict) and prod.swap(_restrict), to avoid name clashes on
0746d4781674 tuned whitespace;
wenzelm
parents: 66843
diff changeset
   588
interpretation of abstract locales. INCOMPATIBILITY.
66804
3f9bb52082c4 avoid name clashes on interpretation of abstract locales
haftmann
parents: 66803
diff changeset
   589
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   590
* Predicate coprime is now a real definition, not a mere abbreviation.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   591
INCOMPATIBILITY.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   592
66803
dd8922885a68 avoid trivial definition
haftmann
parents: 66801
diff changeset
   593
* Predicate pairwise_coprime abolished, use "pairwise coprime" instead.
dd8922885a68 avoid trivial definition
haftmann
parents: 66801
diff changeset
   594
INCOMPATIBILITY.
dd8922885a68 avoid trivial definition
haftmann
parents: 66801
diff changeset
   595
68373
f254e383bfe9 NEWS: infinite products
paulson <lp15@cam.ac.uk>
parents: 68370
diff changeset
   596
* The relator rel_filter on filters has been strengthened to its
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   597
canonical categorical definition with better properties.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   598
INCOMPATIBILITY.
67616
1d005f514417 strengthen filter relator to canonical categorical definition with better properties
Andreas Lochbihler
parents: 67591
diff changeset
   599
68072
493b818e8e10 added Johannes' generalizations Modules.thy and Vector_Spaces.thy; adapted HOL and HOL-Analysis accordingly
immler
parents: 67999
diff changeset
   600
* Generalized linear algebra involving linear, span, dependent, dim
493b818e8e10 added Johannes' generalizations Modules.thy and Vector_Spaces.thy; adapted HOL and HOL-Analysis accordingly
immler
parents: 67999
diff changeset
   601
from type class real_vector to locales module and vector_space.
493b818e8e10 added Johannes' generalizations Modules.thy and Vector_Spaces.thy; adapted HOL and HOL-Analysis accordingly
immler
parents: 67999
diff changeset
   602
Renamed:
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   603
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   604
  span_inc ~> span_superset
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   605
  span_superset ~> span_base
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   606
  span_eq ~> span_eq_iff
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   607
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   608
INCOMPATIBILITY.
66844
0746d4781674 tuned whitespace;
wenzelm
parents: 66843
diff changeset
   609
66937
a1a4a5e2933a rule out pathologic instances
haftmann
parents: 66909
diff changeset
   610
* Class linordered_semiring_1 covers zero_less_one also, ruling out
a1a4a5e2933a rule out pathologic instances
haftmann
parents: 66909
diff changeset
   611
pathologic instances. Minor INCOMPATIBILITY.
a1a4a5e2933a rule out pathologic instances
haftmann
parents: 66909
diff changeset
   612
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   613
* Theory HOL.List: functions "sorted_wrt" and "sorted" now compare every
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   614
element in a list to all following elements, not just the next one.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   615
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   616
* Theory HOL.List syntax:
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   617
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   618
  - filter-syntax "[x <- xs. P]" is no longer output syntax, but only
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   619
    input syntax
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   620
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   621
  - list comprehension syntax now supports tuple patterns in "pat <- xs"
68249
949d93804740 First step to remove nonstandard "[x <- xs. P]" syntax: only input
nipkow
parents: 68246
diff changeset
   622
68450
41de07c7a0f3 Map.empty now qualified to avoid name clashes
nipkow
parents: 68404
diff changeset
   623
* Theory Map: "empty" must now be qualified as "Map.empty".
41de07c7a0f3 Map.empty now qualified to avoid name clashes
nipkow
parents: 68404
diff changeset
   624
67051
e7e54a0b9197 dedicated definition for coprimality
haftmann
parents: 67043
diff changeset
   625
* Removed nat-int transfer machinery. Rare INCOMPATIBILITY.
e7e54a0b9197 dedicated definition for coprimality
haftmann
parents: 67043
diff changeset
   626
68100
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   627
* Fact mod_mult_self4 (on nat) renamed to Suc_mod_mult_self3, to avoid
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   628
clash with fact mod_mult_self4 (on more generic semirings).
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   629
INCOMPATIBILITY.
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   630
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   631
* Eliminated some theorem aliasses:
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   632
  even_times_iff ~> even_mult_iff
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   633
  mod_2_not_eq_zero_eq_one_nat ~> not_mod_2_eq_0_eq_1
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   634
  even_of_nat ~> even_int_iff
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   635
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   636
INCOMPATIBILITY.
b2d84b1114fa removed some lemma duplicates
haftmann
parents: 68080
diff changeset
   637
68157
057d5b4ce47e removed some non-essential rules
haftmann
parents: 68125
diff changeset
   638
* Eliminated some theorem duplicate variations:
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   639
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   640
  - dvd_eq_mod_eq_0_numeral can be replaced by dvd_eq_mod_eq_0
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   641
  - mod_Suc_eq_Suc_mod can be replaced by mod_Suc
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   642
  - mod_Suc_eq_Suc_mod [symmetrict] can be replaced by mod_simps
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   643
  - mod_eq_0_iff can be replaced by mod_eq_0_iff_dvd and dvd_def
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   644
  - the witness of mod_eqD can be given directly as "_ div _"
68157
057d5b4ce47e removed some non-essential rules
haftmann
parents: 68125
diff changeset
   645
057d5b4ce47e removed some non-essential rules
haftmann
parents: 68125
diff changeset
   646
INCOMPATIBILITY.
057d5b4ce47e removed some non-essential rules
haftmann
parents: 68125
diff changeset
   647
68260
61188c781cdd avoid overaggressive classical rule
haftmann
parents: 68249
diff changeset
   648
* Classical setup: Assumption "m mod d = 0" (for m d :: nat) is no
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   649
longer aggresively destroyed to "\<exists>q. m = d * q". INCOMPATIBILITY, adding
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   650
"elim!: dvd" to classical proof methods in most situations restores
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   651
broken proofs.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   652
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   653
* Theory HOL-Library.Conditional_Parametricity provides command
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   654
'parametric_constant' for proving parametricity of non-recursive
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   655
definitions. For constants that are not fully parametric the command
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   656
will infer conditions on relations (e.g., bi_unique, bi_total, or type
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   657
class conditions such as "respects 0") sufficient for parametricity. See
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   658
theory HOL-ex.Conditional_Parametricity_Examples for some examples.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   659
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   660
* Theory HOL-Library.Code_Lazy provides a new preprocessor for the code
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   661
generator to generate code for algebraic types with lazy evaluation
68639
357fca99a65a more examples for Code_Lazy
Andreas Lochbihler
parents: 68568
diff changeset
   662
semantics even in call-by-value target languages. See the theories
68647
wenzelm
parents: 68640
diff changeset
   663
HOL-ex.Code_Lazy_Demo and HOL-Codegenerator_Test.Code_Lazy_Test for some
wenzelm
parents: 68640
diff changeset
   664
examples.
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   665
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   666
* Theory HOL-Library.Landau_Symbols has been moved here from AFP.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   667
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   668
* Theory HOL-Library.Old_Datatype no longer provides the legacy command
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   669
'old_datatype'. INCOMPATIBILITY.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   670
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   671
* Theory HOL-Computational_Algebra.Polynomial_Factorial does not provide
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   672
instances of rat, real, complex as factorial rings etc. Import
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   673
HOL-Computational_Algebra.Field_as_Ring explicitly in case of need.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   674
INCOMPATIBILITY.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   675
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   676
* Session HOL-Algebra: renamed (^) to [^] to avoid conflict with new
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   677
infix/prefix notation.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   678
68543
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   679
* Session HOL-Algebra: revamped with much new material. The set of
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   680
isomorphisms between two groups is now denoted iso rather than iso_set.
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   681
INCOMPATIBILITY.
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   682
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   683
* Session HOL-Analysis: the Arg function now respects the same interval
c87e1adb91af misc tuning for release;
wenzelm
parents: 68541
diff changeset
   684
as Ln, namely (-pi,pi]; the old Arg function has been renamed Arg2pi.
68499
d4312962161a Rationalisation of complex transcendentals, esp the Arg function
paulson <lp15@cam.ac.uk>
parents: 68484
diff changeset
   685
INCOMPATIBILITY.
d4312962161a Rationalisation of complex transcendentals, esp the Arg function
paulson <lp15@cam.ac.uk>
parents: 68484
diff changeset
   686
68548
wenzelm
parents: 68547
diff changeset
   687
* Session HOL-Analysis: the functions zorder, zer_poly, porder and
wenzelm
parents: 68547
diff changeset
   688
pol_poly have been redefined. All related lemmas have been reworked.
68531
7c6f812afdc4 NEWS and CONTRIBUTORS
Wenda Li <wl302@cam.ac.uk>
parents: 68523
diff changeset
   689
INCOMPATIBILITY.
7c6f812afdc4 NEWS and CONTRIBUTORS
Wenda Li <wl302@cam.ac.uk>
parents: 68523
diff changeset
   690
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   691
* Session HOL-Analysis: infinite products, Moebius functions, the
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   692
Riemann mapping theorem, the Vitali covering theorem,
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   693
change-of-variables results for integration and measures.
68260
61188c781cdd avoid overaggressive classical rule
haftmann
parents: 68249
diff changeset
   694
68647
wenzelm
parents: 68640
diff changeset
   695
* Session HOL-Real_Asymp: proof method "real_asymp" proves asymptotics
wenzelm
parents: 68640
diff changeset
   696
or real-valued functions (limits, "Big-O", etc.) automatically.
68681
wenzelm
parents: 68661
diff changeset
   697
See also ~~/src/HOL/Real_Asymp/Manual for some documentation.
68647
wenzelm
parents: 68640
diff changeset
   698
68545
7922992c99ea misc tuning and updates for release;
wenzelm
parents: 68543
diff changeset
   699
* Session HOL-Types_To_Sets: more tool support (unoverload_type combines
7922992c99ea misc tuning and updates for release;
wenzelm
parents: 68543
diff changeset
   700
internalize_sorts and unoverload) and larger experimental application
7922992c99ea misc tuning and updates for release;
wenzelm
parents: 68543
diff changeset
   701
(type based linear algebra transferred to linear algebra on subspaces).
68522
d9cbc1e8644d example for Types_To_Sets: transfer from type-based linear algebra to subspaces
immler
parents: 68515
diff changeset
   702
66651
435cb8d69e27 back to post-release mode -- after fork point;
wenzelm
parents: 66650
diff changeset
   703
68116
ac82ee617a75 command-line tool "isabelle export";
wenzelm
parents: 68100
diff changeset
   704
*** ML ***
ac82ee617a75 command-line tool "isabelle export";
wenzelm
parents: 68100
diff changeset
   705
ac82ee617a75 command-line tool "isabelle export";
wenzelm
parents: 68100
diff changeset
   706
* Operation Export.export emits theory exports (arbitrary blobs), which
ac82ee617a75 command-line tool "isabelle export";
wenzelm
parents: 68100
diff changeset
   707
are stored persistently in the session build database.
ac82ee617a75 command-line tool "isabelle export";
wenzelm
parents: 68100
diff changeset
   708
68276
cbee43ff4ceb added command 'ML_export';
wenzelm
parents: 68260
diff changeset
   709
* Command 'ML_export' exports ML toplevel bindings to the global
cbee43ff4ceb added command 'ML_export';
wenzelm
parents: 68260
diff changeset
   710
bootstrap environment of the ML process. This allows ML evaluation
cbee43ff4ceb added command 'ML_export';
wenzelm
parents: 68260
diff changeset
   711
without a formal theory context, e.g. in command-line tools like
cbee43ff4ceb added command 'ML_export';
wenzelm
parents: 68260
diff changeset
   712
"isabelle process".
cbee43ff4ceb added command 'ML_export';
wenzelm
parents: 68260
diff changeset
   713
68116
ac82ee617a75 command-line tool "isabelle export";
wenzelm
parents: 68100
diff changeset
   714
66729
wenzelm
parents: 66712
diff changeset
   715
*** System ***
wenzelm
parents: 66712
diff changeset
   716
67088
89e82aed7813 Mac OS X 10.10 Yosemite is baseline;
wenzelm
parents: 67069
diff changeset
   717
* Mac OS X 10.10 Yosemite is now the baseline version; Mavericks is no
89e82aed7813 Mac OS X 10.10 Yosemite is baseline;
wenzelm
parents: 67069
diff changeset
   718
longer supported.
89e82aed7813 Mac OS X 10.10 Yosemite is baseline;
wenzelm
parents: 67069
diff changeset
   719
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   720
* Linux and Windows/Cygwin is for x86_64 only, old 32bit platform
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   721
support has been discontinued.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   722
66906
03a96b8c7c06 updated to jdk-8u152, which is for x86_64 only;
wenzelm
parents: 66851
diff changeset
   723
* Java runtime is for x86_64 only. Corresponding Isabelle settings have
03a96b8c7c06 updated to jdk-8u152, which is for x86_64 only;
wenzelm
parents: 66851
diff changeset
   724
been renamed to ISABELLE_TOOL_JAVA_OPTIONS and JEDIT_JAVA_OPTIONS,
03a96b8c7c06 updated to jdk-8u152, which is for x86_64 only;
wenzelm
parents: 66851
diff changeset
   725
instead of former 32/64 variants. INCOMPATIBILITY.
03a96b8c7c06 updated to jdk-8u152, which is for x86_64 only;
wenzelm
parents: 66851
diff changeset
   726
68003
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   727
* Old settings ISABELLE_PLATFORM and ISABELLE_WINDOWS_PLATFORM should be
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   728
phased out due to unclear preference of 32bit vs. 64bit architecture.
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   729
Explicit GNU bash expressions are now preferred, for example (with
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   730
quotes):
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   731
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   732
  #Posix executables (Unix or Cygwin), with preference for 64bit
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   733
  "${ISABELLE_PLATFORM64:-$ISABELLE_PLATFORM32}"
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   734
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   735
  #native Windows or Unix executables, with preference for 64bit
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   736
  "${ISABELLE_WINDOWS_PLATFORM64:-${ISABELLE_WINDOWS_PLATFORM32:-${ISABELLE_PLATFORM64:-$ISABELLE_PLATFORM32}}}"
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   737
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   738
  #native Windows (32bit) or Unix executables (preference for 64bit)
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   739
  "${ISABELLE_WINDOWS_PLATFORM32:-${ISABELLE_PLATFORM64:-$ISABELLE_PLATFORM32}}"
9b89d831dc80 prefer explicit 32/64 bit platform settings;
wenzelm
parents: 67999
diff changeset
   740
66745
e7ac579b883c option -S for "isabelle build";
wenzelm
parents: 66739
diff changeset
   741
* Command-line tool "isabelle build" supports new options:
e7ac579b883c option -S for "isabelle build";
wenzelm
parents: 66739
diff changeset
   742
  - option -B NAME: include session NAME and all descendants
e7ac579b883c option -S for "isabelle build";
wenzelm
parents: 66739
diff changeset
   743
  - option -S: only observe changes of sources, not heap images
66841
5c32a072ca8b added isablle build option -f;
wenzelm
parents: 66826
diff changeset
   744
  - option -f: forces a fresh build
66737
2edc0c42c883 option -B for "isabelle build" and "isabelle imports";
wenzelm
parents: 66729
diff changeset
   745
68734
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68690
diff changeset
   746
* Command-line tool "isabelle build" options -c -x -B refer to
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68690
diff changeset
   747
descendants wrt. the session parent or import graph. Subtle
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68690
diff changeset
   748
INCOMPATIBILITY: options -c -x used to refer to the session parent graph
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68690
diff changeset
   749
only.
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68690
diff changeset
   750
66843
be08a7691c62 clarified meta_digest;
wenzelm
parents: 66841
diff changeset
   751
* Command-line tool "isabelle build" takes "condition" options with the
be08a7691c62 clarified meta_digest;
wenzelm
parents: 66841
diff changeset
   752
corresponding environment values into account, when determining the
be08a7691c62 clarified meta_digest;
wenzelm
parents: 66841
diff changeset
   753
up-to-date status of a session.
be08a7691c62 clarified meta_digest;
wenzelm
parents: 66841
diff changeset
   754
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   755
* The command-line tool "dump" dumps information from the cumulative
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   756
PIDE session database: many sessions may be loaded into a given logic
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   757
image, results from all loaded theories are written to the output
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   758
directory.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   759
66851
c75769065548 more informative Imports.Report with actual session imports (minimized);
wenzelm
parents: 66844
diff changeset
   760
* Command-line tool "isabelle imports -I" also reports actual session
c75769065548 more informative Imports.Report with actual session imports (minimized);
wenzelm
parents: 66844
diff changeset
   761
imports. This helps to minimize the session dependency graph.
c75769065548 more informative Imports.Report with actual session imports (minimized);
wenzelm
parents: 66844
diff changeset
   762
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   763
* The command-line tool "export" and 'export_files' in session ROOT
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   764
entries retrieve theory exports from the session build database.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   765
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   766
* The command-line tools "isabelle server" and "isabelle client" provide
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   767
access to the Isabelle Server: it supports responsive session management
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   768
and concurrent use of theories, based on Isabelle/PIDE infrastructure.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   769
See also the "system" manual.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   770
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   771
* The command-line tool "isabelle update_comments" normalizes formal
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   772
comments in outer syntax as follows: \<comment> \<open>text\<close> (whith a single space to
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   773
approximate the appearance in document output). This is more specific
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   774
than former "isabelle update_cartouches -c": the latter tool option has
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   775
been discontinued.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   776
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   777
* The command-line tool "isabelle mkroot" now always produces a document
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   778
outline: its options have been adapted accordingly. INCOMPATIBILITY.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   779
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   780
* The command-line tool "isabelle mkroot -I" initializes a Mercurial
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   781
repository for the generated session files.
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   782
68523
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68522
diff changeset
   783
* Settings ISABELLE_HEAPS + ISABELLE_BROWSER_INFO (or
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68522
diff changeset
   784
ISABELLE_HEAPS_SYSTEM + ISABELLE_BROWSER_INFO_SYSTEM in "system build
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68522
diff changeset
   785
mode") determine the directory locations of the main build artefacts --
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68522
diff changeset
   786
instead of hard-wired directories in ISABELLE_HOME_USER (or
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68522
diff changeset
   787
ISABELLE_HOME).
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68522
diff changeset
   788
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   789
* Settings ISABELLE_PATH and ISABELLE_OUTPUT have been discontinued:
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   790
heap images and session databases are always stored in
68523
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68522
diff changeset
   791
$ISABELLE_HEAPS/$ML_IDENTIFIER (command-line default) or
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68522
diff changeset
   792
$ISABELLE_HEAPS_SYSTEM/$ML_IDENTIFIER (main Isabelle application or
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   793
"isabelle jedit -s" or "isabelle build -s").
67099
3345d53e7c58 updated to official release of polyml-5.7.1;
wenzelm
parents: 67088
diff changeset
   794
67199
wenzelm
parents: 67194
diff changeset
   795
* ISABELLE_LATEX and ISABELLE_PDFLATEX now include platform-specific
wenzelm
parents: 67194
diff changeset
   796
options for improved error reporting. Potential INCOMPATIBILITY with
wenzelm
parents: 67194
diff changeset
   797
unusual LaTeX installations, may have to adapt these settings.
wenzelm
parents: 67194
diff changeset
   798
68393
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   799
* Update to Poly/ML 5.7.1 with slightly improved performance and PIDE
b9989df11c78 misc tuning and updates for release;
wenzelm
parents: 68391
diff changeset
   800
markup for identifier bindings. It now uses The GNU Multiple Precision
67591
wenzelm
parents: 67525
diff changeset
   801
Arithmetic Library (libgmp) on all platforms, notably Mac OS X with
wenzelm
parents: 67525
diff changeset
   802
32/64 bit.
wenzelm
parents: 67525
diff changeset
   803
67099
3345d53e7c58 updated to official release of polyml-5.7.1;
wenzelm
parents: 67088
diff changeset
   804
66729
wenzelm
parents: 66712
diff changeset
   805
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   806
New in Isabelle2017 (October 2017)
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   807
----------------------------------
64439
2bafda87b524 back to post-release mode -- after fork point;
wenzelm
parents: 64391
diff changeset
   808
64986
b81a048960a3 more uniform use of Reconstruct.clean_proof_of;
wenzelm
parents: 64917
diff changeset
   809
*** General ***
b81a048960a3 more uniform use of Reconstruct.clean_proof_of;
wenzelm
parents: 64917
diff changeset
   810
66238
wenzelm
parents: 66181
diff changeset
   811
* Experimental support for Visual Studio Code (VSCode) as alternative
wenzelm
parents: 66181
diff changeset
   812
Isabelle/PIDE front-end, see also
66599
34b20f7236ea proper URL;
wenzelm
parents: 66574
diff changeset
   813
https://marketplace.visualstudio.com/items?itemName=makarius.Isabelle2017
66238
wenzelm
parents: 66181
diff changeset
   814
wenzelm
parents: 66181
diff changeset
   815
VSCode is a new type of application that continues the concepts of
wenzelm
parents: 66181
diff changeset
   816
"programmer's editor" and "integrated development environment" towards
wenzelm
parents: 66181
diff changeset
   817
fully semantic editing and debugging -- in a relatively light-weight
wenzelm
parents: 66181
diff changeset
   818
manner. Thus it fits nicely on top of the Isabelle/PIDE infrastructure.
wenzelm
parents: 66181
diff changeset
   819
Technically, VSCode is based on the Electron application framework
wenzelm
parents: 66181
diff changeset
   820
(Node.js + Chromium browser + V8), which is implemented in JavaScript
wenzelm
parents: 66181
diff changeset
   821
and TypeScript, while Isabelle/VSCode mainly consists of Isabelle/Scala
wenzelm
parents: 66181
diff changeset
   822
modules around a Language Server implementation.
wenzelm
parents: 66181
diff changeset
   823
65504
b80477da30eb some documentation;
wenzelm
parents: 65465
diff changeset
   824
* Theory names are qualified by the session name that they belong to.
66454
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   825
This affects imports, but not the theory name space prefix (which is
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   826
just the theory base name as before).
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   827
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   828
In order to import theories from other sessions, the ROOT file format
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   829
provides a new 'sessions' keyword. In contrast, a theory that is
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   830
imported in the old-fashioned manner via an explicit file-system path
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   831
belongs to the current session, and might cause theory name conflicts
66454
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   832
later on. Theories that are imported from other sessions are excluded
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   833
from the current session document. The command-line tool "isabelle
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   834
imports" helps to update theory imports.
1a73ad1c06dd more NEWS;
wenzelm
parents: 66450
diff changeset
   835
65451
wenzelm
parents: 65448
diff changeset
   836
* The main theory entry points for some non-HOL sessions have changed,
wenzelm
parents: 65448
diff changeset
   837
to avoid confusion with the global name "Main" of the session HOL. This
wenzelm
parents: 65448
diff changeset
   838
leads to the follow renamings:
wenzelm
parents: 65448
diff changeset
   839
wenzelm
parents: 65448
diff changeset
   840
  CTT/Main.thy    ~>  CTT/CTT.thy
wenzelm
parents: 65448
diff changeset
   841
  ZF/Main.thy     ~>  ZF/ZF.thy
wenzelm
parents: 65448
diff changeset
   842
  ZF/Main_ZF.thy  ~>  ZF/ZF.thy
wenzelm
parents: 65448
diff changeset
   843
  ZF/Main_ZFC.thy ~>  ZF/ZFC.thy
wenzelm
parents: 65448
diff changeset
   844
  ZF/ZF.thy       ~>  ZF/ZF_Base.thy
wenzelm
parents: 65448
diff changeset
   845
wenzelm
parents: 65448
diff changeset
   846
INCOMPATIBILITY.
wenzelm
parents: 65448
diff changeset
   847
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   848
* Commands 'alias' and 'type_alias' introduce aliases for constants and
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   849
type constructors, respectively. This allows adhoc changes to name-space
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   850
accesses within global or local theory contexts, e.g. within a 'bundle'.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   851
64986
b81a048960a3 more uniform use of Reconstruct.clean_proof_of;
wenzelm
parents: 64917
diff changeset
   852
* Document antiquotations @{prf} and @{full_prf} output proof terms
b81a048960a3 more uniform use of Reconstruct.clean_proof_of;
wenzelm
parents: 64917
diff changeset
   853
(again) in the same way as commands 'prf' and 'full_prf'.
b81a048960a3 more uniform use of Reconstruct.clean_proof_of;
wenzelm
parents: 64917
diff changeset
   854
65055
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   855
* Computations generated by the code generator can be embedded directly
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   856
into ML, alongside with @{code} antiquotations, using the following
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   857
antiquotations:
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   858
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   859
  @{computation ... terms: ... datatypes: ...} :
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   860
    ((term -> term) -> 'ml option -> 'a) -> Proof.context -> term -> 'a
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   861
  @{computation_conv ... terms: ... datatypes: ...} :
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   862
    (Proof.context -> 'ml -> conv) -> Proof.context -> conv
65045
b69ef432438d avoid Unicode that conflicts with Isabelle symbol rendering;
wenzelm
parents: 65042
diff changeset
   863
  @{computation_check terms: ... datatypes: ...} : Proof.context -> conv
65041
2525e680f94f basic documentation for computations
haftmann
parents: 65027
diff changeset
   864
65055
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   865
See src/HOL/ex/Computations.thy,
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   866
src/HOL/Decision_Procs/Commutative_Ring.thy and
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   867
src/HOL/Decision_Procs/Reflective_Field.thy for examples and the
12189e86c49d tuned whitespace;
wenzelm
parents: 65050
diff changeset
   868
tutorial on code generation.
65041
2525e680f94f basic documentation for computations
haftmann
parents: 65027
diff changeset
   869
64986
b81a048960a3 more uniform use of Reconstruct.clean_proof_of;
wenzelm
parents: 64917
diff changeset
   870
64602
8edca3465758 added isabelle jedit -R;
wenzelm
parents: 64593
diff changeset
   871
*** Prover IDE -- Isabelle/Scala/jEdit ***
8edca3465758 added isabelle jedit -R;
wenzelm
parents: 64593
diff changeset
   872
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   873
* Session-qualified theory imports allow the Prover IDE to process
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   874
arbitrary theory hierarchies independently of the underlying logic
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   875
session image (e.g. option "isabelle jedit -l"), but the directory
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   876
structure needs to be known in advance (e.g. option "isabelle jedit -d"
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   877
or a line in the file $ISABELLE_HOME_USER/ROOTS).
64602
8edca3465758 added isabelle jedit -R;
wenzelm
parents: 64593
diff changeset
   878
64842
9c69b495c05d more documentation;
wenzelm
parents: 64787
diff changeset
   879
* The PIDE document model maintains file content independently of the
9c69b495c05d more documentation;
wenzelm
parents: 64787
diff changeset
   880
status of jEdit editor buffers. Reloading jEdit buffers no longer causes
9c69b495c05d more documentation;
wenzelm
parents: 64787
diff changeset
   881
changes of formal document content. Theory dependencies are always
9c69b495c05d more documentation;
wenzelm
parents: 64787
diff changeset
   882
resolved internally, without the need for corresponding editor buffers.
9c69b495c05d more documentation;
wenzelm
parents: 64787
diff changeset
   883
The system option "jedit_auto_load" has been discontinued: it is
9c69b495c05d more documentation;
wenzelm
parents: 64787
diff changeset
   884
effectively always enabled.
9c69b495c05d more documentation;
wenzelm
parents: 64787
diff changeset
   885
64867
e7220f4de11f support "purge" operation on document model;
wenzelm
parents: 64846
diff changeset
   886
* The Theories dockable provides a "Purge" button, in order to restrict
e7220f4de11f support "purge" operation on document model;
wenzelm
parents: 64846
diff changeset
   887
the document model to theories that are required for open editor
e7220f4de11f support "purge" operation on document model;
wenzelm
parents: 64846
diff changeset
   888
buffers.
e7220f4de11f support "purge" operation on document model;
wenzelm
parents: 64846
diff changeset
   889
66424
wenzelm
parents: 66345
diff changeset
   890
* The Theories dockable indicates the overall status of checking of each
wenzelm
parents: 66345
diff changeset
   891
entry. When all forked tasks of a theory are finished, the border is
wenzelm
parents: 66345
diff changeset
   892
painted with thick lines; remaining errors in this situation are
wenzelm
parents: 66345
diff changeset
   893
represented by a different border color.
wenzelm
parents: 66345
diff changeset
   894
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   895
* Automatic indentation is more careful to avoid redundant spaces in
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   896
intermediate situations. Keywords are indented after input (via typed
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   897
characters or completion); see also option "jedit_indent_input".
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   898
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   899
* Action "isabelle.preview" opens an HTML preview of the current theory
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   900
document in the default web browser.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   901
66574
e16b27bd3f76 reverted 6acb28e5ba41: permissiveness of 1e5ae735e026 should be sufficient;
wenzelm
parents: 66563
diff changeset
   902
* Command-line invocation "isabelle jedit -R -l LOGIC" opens the ROOT
e16b27bd3f76 reverted 6acb28e5ba41: permissiveness of 1e5ae735e026 should be sufficient;
wenzelm
parents: 66563
diff changeset
   903
entry of the specified logic session in the editor, while its parent is
e16b27bd3f76 reverted 6acb28e5ba41: permissiveness of 1e5ae735e026 should be sufficient;
wenzelm
parents: 66563
diff changeset
   904
used for formal checking.
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   905
66462
0a8277e9cfd6 officially allow restart of Isabelle plugin;
wenzelm
parents: 66455
diff changeset
   906
* The main Isabelle/jEdit plugin may be restarted manually (using the
0a8277e9cfd6 officially allow restart of Isabelle plugin;
wenzelm
parents: 66455
diff changeset
   907
jEdit Plugin Manager), as long as the "Isabelle Base" plugin remains
0a8277e9cfd6 officially allow restart of Isabelle plugin;
wenzelm
parents: 66455
diff changeset
   908
enabled at all times.
0a8277e9cfd6 officially allow restart of Isabelle plugin;
wenzelm
parents: 66455
diff changeset
   909
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   910
* Update to current jedit-5.4.0.
65329
4f3da52cec02 updated to jedit-5.4.0;
wenzelm
parents: 65170
diff changeset
   911
64602
8edca3465758 added isabelle jedit -R;
wenzelm
parents: 64593
diff changeset
   912
66149
4bf16fb7c14d deleting a code equation never leads to unimplemented function
haftmann
parents: 66135
diff changeset
   913
*** Pure ***
4bf16fb7c14d deleting a code equation never leads to unimplemented function
haftmann
parents: 66135
diff changeset
   914
4bf16fb7c14d deleting a code equation never leads to unimplemented function
haftmann
parents: 66135
diff changeset
   915
* Deleting the last code equations for a particular function using
4bf16fb7c14d deleting a code equation never leads to unimplemented function
haftmann
parents: 66135
diff changeset
   916
[code del] results in function with no equations (runtime abort) rather
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   917
than an unimplemented function (generation time abort). Use explicit
66665
ec78c84bfc44 spelling
haftmann
parents: 66650
diff changeset
   918
[[code drop:]] to enforce the latter. Minor INCOMPATIBILITY.
66149
4bf16fb7c14d deleting a code equation never leads to unimplemented function
haftmann
parents: 66135
diff changeset
   919
66310
e8d2862ec203 simplified function specification history: each pending function specification is historized at the end of a theory, without additional bookkeeping;
haftmann
parents: 66298
diff changeset
   920
* Proper concept of code declarations in code.ML:
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   921
  - Regular code declarations act only on the global theory level, being
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   922
    ignored with warnings if syntactically malformed.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   923
  - Explicitly global code declarations yield errors if syntactically
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   924
    malformed.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   925
  - Default code declarations are silently ignored if syntactically
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   926
    malformed.
66310
e8d2862ec203 simplified function specification history: each pending function specification is historized at the end of a theory, without additional bookkeeping;
haftmann
parents: 66298
diff changeset
   927
Minor INCOMPATIBILITY.
e8d2862ec203 simplified function specification history: each pending function specification is historized at the end of a theory, without additional bookkeeping;
haftmann
parents: 66298
diff changeset
   928
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   929
* Clarified and standardized internal data bookkeeping of code
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   930
declarations: history of serials allows to track potentially
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   931
non-monotonous declarations appropriately. Minor INCOMPATIBILITY.
66310
e8d2862ec203 simplified function specification history: each pending function specification is historized at the end of a theory, without additional bookkeeping;
haftmann
parents: 66298
diff changeset
   932
66149
4bf16fb7c14d deleting a code equation never leads to unimplemented function
haftmann
parents: 66135
diff changeset
   933
64593
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   934
*** HOL ***
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   935
66614
1f1c5d85d232 moved Nunchaku to Main; the goal is to move Nitpick out in the next 1-2 years
blanchet
parents: 66599
diff changeset
   936
* The Nunchaku model finder is now part of "Main".
1f1c5d85d232 moved Nunchaku to Main; the goal is to move Nitpick out in the next 1-2 years
blanchet
parents: 66599
diff changeset
   937
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   938
* SMT module:
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   939
  - A new option, 'smt_nat_as_int', has been added to translate 'nat' to
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   940
    'int' and benefit from the SMT solver's theory reasoning. It is
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   941
    disabled by default.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   942
  - The legacy module "src/HOL/Library/Old_SMT.thy" has been removed.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   943
  - Several small issues have been rectified in the 'smt' command.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   944
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   945
* (Co)datatype package: The 'size_gen_o_map' lemma is no longer
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   946
generated for datatypes with type class annotations. As a result, the
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   947
tactic that derives it no longer fails on nested datatypes. Slight
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   948
INCOMPATIBILITY.
66450
a8299195ed82 NEWS: Removed constant subseq; subsumed by strict_mono
eberlm <eberlm@in.tum.de>
parents: 66449
diff changeset
   949
66345
882abe912da9 do not fall back on nbe if plain evaluation fails
haftmann
parents: 66310
diff changeset
   950
* Command and antiquotation "value" with modified default strategy:
882abe912da9 do not fall back on nbe if plain evaluation fails
haftmann
parents: 66310
diff changeset
   951
terms without free variables are always evaluated using plain evaluation
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   952
only, with no fallback on normalization by evaluation. Minor
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   953
INCOMPATIBILITY.
65956
639eb3617a86 reorganised material on sublists
eberlm <eberlm@in.tum.de>
parents: 65841
diff changeset
   954
65552
f533820e7248 theories "GCD" and "Binomial" are already included in "Main": this avoids improper imports in applications;
wenzelm
parents: 65544
diff changeset
   955
* Theories "GCD" and "Binomial" are already included in "Main" (instead
65575
wenzelm
parents: 65572
diff changeset
   956
of "Complex_Main").
65552
f533820e7248 theories "GCD" and "Binomial" are already included in "Main": this avoids improper imports in applications;
wenzelm
parents: 65544
diff changeset
   957
65170
53675f36820d restored surj as output abbreviation, amending 6af79184bef3
haftmann
parents: 65099
diff changeset
   958
* Constant "surj" is a full input/output abbreviation (again).
53675f36820d restored surj as output abbreviation, amending 6af79184bef3
haftmann
parents: 65099
diff changeset
   959
Minor INCOMPATIBILITY.
53675f36820d restored surj as output abbreviation, amending 6af79184bef3
haftmann
parents: 65099
diff changeset
   960
64632
9df24b8b6c0a dropped aliasses
haftmann
parents: 64603
diff changeset
   961
* Dropped aliasses RangeP, DomainP for Rangep, Domainp respectively.
9df24b8b6c0a dropped aliasses
haftmann
parents: 64603
diff changeset
   962
INCOMPATIBILITY.
9df24b8b6c0a dropped aliasses
haftmann
parents: 64603
diff changeset
   963
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   964
* Renamed ii to imaginary_unit in order to free up ii as a variable
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   965
name. The syntax \<i> remains available. INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   966
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   967
* Dropped abbreviations transP, antisymP, single_valuedP; use constants
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   968
transp, antisymp, single_valuedp instead. INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   969
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   970
* Constant "subseq" in Topological_Spaces has been removed -- it is
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   971
subsumed by "strict_mono". Some basic lemmas specific to "subseq" have
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   972
been renamed accordingly, e.g. "subseq_o" -> "strict_mono_o" etc.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   973
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   974
* Theory List: "sublist" renamed to "nths" in analogy with "nth", and
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   975
"sublisteq" renamed to "subseq". Minor INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   976
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   977
* Theory List: new generic function "sorted_wrt".
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   978
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   979
* Named theorems mod_simps covers various congruence rules concerning
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   980
mod, replacing former zmod_simps. INCOMPATIBILITY.
64787
067cacdd1117 tuned NEWS
haftmann
parents: 64786
diff changeset
   981
64593
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   982
* Swapped orientation of congruence rules mod_add_left_eq,
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   983
mod_add_right_eq, mod_add_eq, mod_mult_left_eq, mod_mult_right_eq,
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   984
mod_mult_eq, mod_minus_eq, mod_diff_left_eq, mod_diff_right_eq,
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   985
mod_diff_eq. INCOMPATIBILITY.
64593
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   986
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   987
* Generalized some facts:
64876
65a247444100 generalized types in lemmas
blanchet
parents: 64867
diff changeset
   988
    measure_induct_rule
65a247444100 generalized types in lemmas
blanchet
parents: 64867
diff changeset
   989
    measure_induct
64593
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   990
    zminus_zmod ~> mod_minus_eq
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   991
    zdiff_zmod_left ~> mod_diff_left_eq
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   992
    zdiff_zmod_right ~> mod_diff_right_eq
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   993
    zmod_eq_dvd_iff ~> mod_eq_dvd_iff
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   994
INCOMPATIBILITY.
50c715579715 reoriented congruence rules in non-explosive direction
haftmann
parents: 64555
diff changeset
   995
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   996
* Algebraic type class hierarchy of euclidean (semi)rings in HOL:
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   997
euclidean_(semi)ring, euclidean_(semi)ring_cancel,
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   998
unique_euclidean_(semi)ring; instantiation requires provision of a
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
   999
euclidean size.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1000
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1001
* Theory "HOL-Number_Theory.Euclidean_Algorithm" has been reworked:
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1002
  - Euclidean induction is available as rule eucl_induct.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1003
  - Constants Euclidean_Algorithm.gcd, Euclidean_Algorithm.lcm,
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1004
    Euclidean_Algorithm.Gcd and Euclidean_Algorithm.Lcm allow
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1005
    easy instantiation of euclidean (semi)rings as GCD (semi)rings.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1006
  - Coefficients obtained by extended euclidean algorithm are
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1007
    available as "bezout_coefficients".
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1008
INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1009
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1010
* Theory "Number_Theory.Totient" introduces basic notions about Euler's
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1011
totient function previously hidden as solitary example in theory
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1012
Residues. Definition changed so that "totient 1 = 1" in agreement with
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1013
the literature. Minor INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1014
66542
075bbb78d33c proper theory name;
wenzelm
parents: 66541
diff changeset
  1015
* New styles in theory "HOL-Library.LaTeXsugar":
66541
nipkow
parents: 66488
diff changeset
  1016
  - "dummy_pats" for printing equations with "_" on the lhs;
nipkow
parents: 66488
diff changeset
  1017
  - "eta_expand" for printing eta-expanded terms.
nipkow
parents: 66488
diff changeset
  1018
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1019
* Theory "HOL-Library.Permutations": theorem bij_swap_ompose_bij has
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1020
been renamed to bij_swap_compose_bij. INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1021
66643
f7e38b8583a0 Correction of typos and a bit of streamlining
paulson <lp15@cam.ac.uk>
parents: 66641
diff changeset
  1022
* New theory "HOL-Library.Going_To_Filter" providing the "f going_to F"
66488
9d83e8fe3de3 HOL-Library: going_to filter
Manuel Eberl <eberlm@in.tum.de>
parents: 66481
diff changeset
  1023
filter for describing points x such that f(x) is in the filter F.
9d83e8fe3de3 HOL-Library: going_to filter
Manuel Eberl <eberlm@in.tum.de>
parents: 66481
diff changeset
  1024
66480
4b8d1df8933b HOL-Analysis: Convergent FPS and infinite sums
Manuel Eberl <eberlm@in.tum.de>
parents: 66474
diff changeset
  1025
* Theory "HOL-Library.Formal_Power_Series": constants X/E/L/F have been
4b8d1df8933b HOL-Analysis: Convergent FPS and infinite sums
Manuel Eberl <eberlm@in.tum.de>
parents: 66474
diff changeset
  1026
renamed to fps_X/fps_exp/fps_ln/fps_hypergeo to avoid polluting the name
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1027
space. INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1028
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1029
* Theory "HOL-Library.FinFun" has been moved to AFP (again).
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1030
INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1031
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1032
* Theory "HOL-Library.FuncSet": some old and rarely used ASCII
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1033
replacement syntax has been removed. INCOMPATIBILITY, standard syntax
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1034
with symbols should be used instead. The subsequent commands help to
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1035
reproduce the old forms, e.g. to simplify porting old theories:
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1036
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1037
syntax (ASCII)
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1038
  "_PiE" :: "pttrn \<Rightarrow> 'a set \<Rightarrow> 'b set \<Rightarrow> ('a \<Rightarrow> 'b) set"  ("(3PIE _:_./ _)" 10)
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1039
  "_Pi"  :: "pttrn \<Rightarrow> 'a set \<Rightarrow> 'b set \<Rightarrow> ('a \<Rightarrow> 'b) set"  ("(3PI _:_./ _)" 10)
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1040
  "_lam" :: "pttrn \<Rightarrow> 'a set \<Rightarrow> 'a \<Rightarrow> 'b \<Rightarrow> ('a \<Rightarrow> 'b)"  ("(3%_:_./ _)" [0,0,3] 3)
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1041
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1042
* Theory "HOL-Library.Multiset": the simprocs on subsets operators of
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1043
multisets have been renamed:
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1044
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1045
  msetless_cancel_numerals ~> msetsubset_cancel
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1046
  msetle_cancel_numerals ~> msetsubset_eq_cancel
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1047
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1048
INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1049
66481
d35f7a9f92e2 output syntax for pattern aliases
Lars Hupel <lars.hupel@mytum.de>
parents: 66480
diff changeset
  1050
* Theory "HOL-Library.Pattern_Aliases" provides input and output syntax
d35f7a9f92e2 output syntax for pattern aliases
Lars Hupel <lars.hupel@mytum.de>
parents: 66480
diff changeset
  1051
for pattern aliases as known from Haskell, Scala and ML.
65515
f595b7532dc9 removed Old_SMT legacy module
blanchet
parents: 65511
diff changeset
  1052
66563
87b9eb69d5ba add type of unordered pairs
Andreas Lochbihler
parents: 66542
diff changeset
  1053
* Theory "HOL-Library.Uprod" formalizes the type of unordered pairs.
87b9eb69d5ba add type of unordered pairs
Andreas Lochbihler
parents: 66542
diff changeset
  1054
64898
49aa13b1b592 tuned whitespace;
wenzelm
parents: 64876
diff changeset
  1055
* Session HOL-Analysis: more material involving arcs, paths, covering
66650
wenzelm
parents: 66643
diff changeset
  1056
spaces, innessential maps, retracts, infinite products, simplicial
wenzelm
parents: 66643
diff changeset
  1057
complexes. Baire Category theorem. Major results include the Jordan
wenzelm
parents: 66643
diff changeset
  1058
Curve Theorem and the Great Picard Theorem.
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1059
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1060
* Session HOL-Algebra has been extended by additional lattice theory:
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1061
the Knaster-Tarski fixed point theorem and Galois Connections.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1062
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1063
* Sessions HOL-Computational_Algebra and HOL-Number_Theory: new notions
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1064
of squarefreeness, n-th powers, and prime powers.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1065
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1066
* Session "HOL-Computional_Algebra" covers many previously scattered
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1067
theories, notably Euclidean_Algorithm, Factorial_Ring,
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1068
Formal_Power_Series, Fraction_Field, Fundamental_Theorem_Algebra,
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1069
Normalized_Fraction, Polynomial_FPS, Polynomial, Primes. Minor
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1070
INCOMPATIBILITY.
65027
2b8583507891 renaming multiset simprocs
fleury <Mathias.Fleury@mpi-inf.mpg.de>
parents: 64986
diff changeset
  1071
60331
f215fd466e30 discontinued legacy;
wenzelm
parents: 60310
diff changeset
  1072
64844
bb70dc05cd38 NEWS for VSCode;
wenzelm
parents: 64842
diff changeset
  1073
*** System ***
bb70dc05cd38 NEWS for VSCode;
wenzelm
parents: 64842
diff changeset
  1074
66474
wenzelm
parents: 66473
diff changeset
  1075
* Isabelle/Scala: the SQL module supports access to relational
wenzelm
parents: 66473
diff changeset
  1076
databases, either as plain file (SQLite) or full-scale server
wenzelm
parents: 66473
diff changeset
  1077
(PostgreSQL via local port or remote ssh connection).
wenzelm
parents: 66473
diff changeset
  1078
wenzelm
parents: 66473
diff changeset
  1079
* Results of "isabelle build" are recorded as SQLite database (i.e.
wenzelm
parents: 66473
diff changeset
  1080
"Application File Format" in the sense of
wenzelm
parents: 66473
diff changeset
  1081
https://www.sqlite.org/appfileformat.html). This allows systematic
wenzelm
parents: 66473
diff changeset
  1082
access via operations from module Sessions.Store in Isabelle/Scala.
wenzelm
parents: 66473
diff changeset
  1083
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1084
* System option "parallel_proofs" is 1 by default (instead of more
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1085
aggressive 2). This requires less heap space and avoids burning parallel
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1086
CPU cycles, while full subproof parallelization is enabled for repeated
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1087
builds (according to parallel_subproofs_threshold).
65072
36c650d1a90d more detailed platform information;
wenzelm
parents: 65064
diff changeset
  1088
65448
9bc3b57c1fa7 added system option record_proofs, which allows to build HOL-Proofs without special Proofs.thy;
wenzelm
parents: 65417
diff changeset
  1089
* System option "record_proofs" allows to change the global
9bc3b57c1fa7 added system option record_proofs, which allows to build HOL-Proofs without special Proofs.thy;
wenzelm
parents: 65417
diff changeset
  1090
Proofterm.proofs variable for a session. Regular values are are 0, 1, 2;
9bc3b57c1fa7 added system option record_proofs, which allows to build HOL-Proofs without special Proofs.thy;
wenzelm
parents: 65417
diff changeset
  1091
a negative value means the current state in the ML heap image remains
9bc3b57c1fa7 added system option record_proofs, which allows to build HOL-Proofs without special Proofs.thy;
wenzelm
parents: 65417
diff changeset
  1092
unchanged.
9bc3b57c1fa7 added system option record_proofs, which allows to build HOL-Proofs without special Proofs.thy;
wenzelm
parents: 65417
diff changeset
  1093
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1094
* Isabelle settings variable ISABELLE_SCALA_BUILD_OPTIONS has been
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1095
renamed to ISABELLE_SCALAC_OPTIONS. Rare INCOMPATIBILITY.
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1096
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1097
* Isabelle settings variables ISABELLE_WINDOWS_PLATFORM,
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1098
ISABELLE_WINDOWS_PLATFORM32, ISABELLE_WINDOWS_PLATFORM64 indicate the
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1099
native Windows platform (independently of the Cygwin installation). This
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1100
is analogous to ISABELLE_PLATFORM, ISABELLE_PLATFORM32,
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1101
ISABELLE_PLATFORM64.
65557
29c69a599743 clarified tool name -- more official status;
wenzelm
parents: 65552
diff changeset
  1102
66786
61617dafcd60 more NEWS;
wenzelm
parents: 66671
diff changeset
  1103
* Command-line tool "isabelle build_docker" builds a Docker image from
61617dafcd60 more NEWS;
wenzelm
parents: 66671
diff changeset
  1104
the Isabelle application bundle for Linux. See also
61617dafcd60 more NEWS;
wenzelm
parents: 66671
diff changeset
  1105
https://hub.docker.com/r/makarius/isabelle
61617dafcd60 more NEWS;
wenzelm
parents: 66671
diff changeset
  1106
66473
wenzelm
parents: 66472
diff changeset
  1107
* Command-line tool "isabelle vscode_server" provides a Language Server
wenzelm
parents: 66472
diff changeset
  1108
Protocol implementation, e.g. for the Visual Studio Code editor. It
wenzelm
parents: 66472
diff changeset
  1109
serves as example for alternative PIDE front-ends.
wenzelm
parents: 66472
diff changeset
  1110
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1111
* Command-line tool "isabelle imports" helps to maintain theory imports
66671
41b64e53b6a1 more documentation;
wenzelm
parents: 66665
diff changeset
  1112
wrt. session structure. Examples for the main Isabelle distribution:
66472
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1113
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1114
  isabelle imports -I -a
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1115
  isabelle imports -U -a
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1116
  isabelle imports -U -i -a
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1117
  isabelle imports -M -a -d '~~/src/Benchmarks'
1b7d66d62035 misc tuning and updates for release;
wenzelm
parents: 66462
diff changeset
  1118
64844
bb70dc05cd38 NEWS for VSCode;
wenzelm
parents: 64842
diff changeset
  1119
67099
3345d53e7c58 updated to official release of polyml-5.7.1;
wenzelm
parents: 67088
diff changeset
  1120
64072
9f96e4da3064 updated for release;
wenzelm
parents: 64013
diff changeset
  1121
New in Isabelle2016-1 (December 2016)
9f96e4da3064 updated for release;
wenzelm
parents: 64013
diff changeset
  1122
-------------------------------------
62216
5fb86150a579 back to post-release mode -- after fork point;
wenzelm
parents: 62209
diff changeset
  1123
62440
31fa592761da symbol interpretation for \<circle>;
wenzelm
parents: 62430
diff changeset
  1124
*** General ***
31fa592761da symbol interpretation for \<circle>;
wenzelm
parents: 62430
diff changeset
  1125
64390
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1126
* Splitter in proof methods "simp", "auto" and friends:
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1127
  - The syntax "split add" has been discontinued, use plain "split",
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1128
    INCOMPATIBILITY.
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1129
  - For situations with many conditional or case expressions, there is
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1130
    an alternative splitting strategy that can be much faster. It is
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1131
    selected by writing "split!" instead of "split". It applies safe
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1132
    introduction and elimination rules after each split rule. As a
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1133
    result the subgoal may be split into several subgoals.
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1134
63273
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1135
* Command 'bundle' provides a local theory target to define a bundle
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1136
from the body of specification commands (such as 'declare',
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1137
'declaration', 'notation', 'lemmas', 'lemma'). For example:
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1138
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1139
bundle foo
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1140
begin
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1141
  declare a [simp]
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1142
  declare b [intro]
302daf918966 prefer hybrid 'bundle' command;
wenzelm
parents: 63272
diff changeset
  1143
end
63272
6d8a67a77bad documentation;
wenzelm
parents: 63260
diff changeset
  1144
63282
7c509ddf29a5 added command 'unbundle';
wenzelm
parents: 63273
diff changeset
  1145
* Command 'unbundle' is like 'include', but works within a local theory
7c509ddf29a5 added command 'unbundle';
wenzelm
parents: 63273
diff changeset
  1146
context. Unlike "context includes ... begin", the effect of 'unbundle'
7c509ddf29a5 added command 'unbundle';
wenzelm
parents: 63273
diff changeset
  1147
on the target context persists, until different declarations are given.
7c509ddf29a5 added command 'unbundle';
wenzelm
parents: 63273
diff changeset
  1148
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1149
* Simplified outer syntax: uniform category "name" includes long
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1150
identifiers. Former "xname" / "nameref" / "name reference" has been
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1151
discontinued.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1152
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1153
* Embedded content (e.g. the inner syntax of types, terms, props) may be
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1154
delimited uniformly via cartouches. This works better than old-fashioned
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1155
quotes when sub-languages are nested.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1156
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1157
* Mixfix annotations support general block properties, with syntax
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1158
"(\<open>x=a y=b z \<dots>\<close>". Notable property names are "indent", "consistent",
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1159
"unbreakable", "markup". The existing notation "(DIGITS" is equivalent
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1160
to "(\<open>indent=DIGITS\<close>". The former notation "(00" for unbreakable blocks
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1161
is superseded by "(\<open>unbreabable\<close>" --- rare INCOMPATIBILITY.
63650
50cadecbe5bc "split add" -> "split".
nipkow
parents: 63635
diff changeset
  1162
63383
wenzelm
parents: 63354
diff changeset
  1163
* Proof method "blast" is more robust wrt. corner cases of Pure
wenzelm
parents: 63354
diff changeset
  1164
statements without object-logic judgment.
wenzelm
parents: 63354
diff changeset
  1165
63624
994d1a1105ef more informative 'prf' and 'full_prf', based on HOL/Proofs/ex/XML_Data.thy;
wenzelm
parents: 63610
diff changeset
  1166
* Commands 'prf' and 'full_prf' are somewhat more informative (again):
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1167
proof terms are reconstructed and cleaned from administrative thm nodes.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1168
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1169
* Code generator: config option "code_timing" triggers measurements of
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1170
different phases of code generation. See src/HOL/ex/Code_Timing.thy for
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1171
examples.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1172
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1173
* Code generator: implicits in Scala (stemming from type class
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1174
instances) are generated into companion object of corresponding type
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1175
class, to resolve some situations where ambiguities may occur.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1176
64390
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1177
* Solve direct: option "solve_direct_strict_warnings" gives explicit
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1178
warnings for lemma statements with trivial proofs.
64013
048b7dbfdfa3 option to report results of solve_direct as explicit warnings
haftmann
parents: 63995
diff changeset
  1179
64602
8edca3465758 added isabelle jedit -R;
wenzelm
parents: 64593
diff changeset
  1180
62904
wenzelm
parents: 62886
diff changeset
  1181
*** Prover IDE -- Isabelle/Scala/jEdit ***
wenzelm
parents: 62886
diff changeset
  1182
64527
49708cffb98d NEWS for e6a3c55b929b;
wenzelm
parents: 64523
diff changeset
  1183
* More aggressive flushing of machine-generated input, according to
49708cffb98d NEWS for e6a3c55b929b;
wenzelm
parents: 64523
diff changeset
  1184
system option editor_generated_input_delay (in addition to existing
49708cffb98d NEWS for e6a3c55b929b;
wenzelm
parents: 64523
diff changeset
  1185
editor_input_delay for regular user edits). This may affect overall PIDE
49708cffb98d NEWS for e6a3c55b929b;
wenzelm
parents: 64523
diff changeset
  1186
reactivity and CPU usage.
49708cffb98d NEWS for e6a3c55b929b;
wenzelm
parents: 64523
diff changeset
  1187
64390
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1188
* Syntactic indentation according to Isabelle outer syntax. Action
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1189
"indent-lines" (shortcut C+i) indents the current line according to
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1190
command keywords and some command substructure. Action
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1191
"isabelle.newline" (shortcut ENTER) indents the old and the new line
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1192
according to command keywords only; see also option
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1193
"jedit_indent_newline".
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1194
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1195
* Semantic indentation for unstructured proof scripts ('apply' etc.) via
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1196
number of subgoals. This requires information of ongoing document
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1197
processing and may thus lag behind, when the user is editing too
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1198
quickly; see also option "jedit_script_indent" and
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1199
"jedit_script_indent_limit".
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1200
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1201
* Refined folding mode "isabelle" based on Isar syntax: 'next' and 'qed'
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1202
are treated as delimiters for fold structure; 'begin' and 'end'
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1203
structure of theory specifications is treated as well.
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1204
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1205
* Command 'proof' provides information about proof outline with cases,
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1206
e.g. for proof methods "cases", "induct", "goal_cases".
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1207
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1208
* Completion templates for commands involving "begin ... end" blocks,
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1209
e.g. 'context', 'notepad'.
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1210
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1211
* Sidekick parser "isabelle-context" shows nesting of context blocks
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1212
according to 'begin' and 'end' structure.
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1213
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1214
* Highlighting of entity def/ref positions wrt. cursor.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1215
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1216
* Action "isabelle.select-entity" (shortcut CS+ENTER) selects all
64514
27914a4f8c70 more on "Formal scopes and semantic selection";
wenzelm
parents: 64457
diff changeset
  1217
occurrences of the formal entity at the caret position. This facilitates
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1218
systematic renaming.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1219
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1220
* PIDE document markup works across multiple Isar commands, e.g. the
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1221
results established at the end of a proof are properly identified in the
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1222
theorem statement.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1223
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1224
* Cartouche abbreviations work both for " and ` to accomodate typical
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1225
situations where old ASCII notation may be updated.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1226
63875
wenzelm
parents: 63871
diff changeset
  1227
* Dockable window "Symbols" also provides access to 'abbrevs' from the
wenzelm
parents: 63871
diff changeset
  1228
outer syntax of the current theory buffer. This provides clickable
wenzelm
parents: 63871
diff changeset
  1229
syntax templates, including entries with empty abbrevs name (which are
wenzelm
parents: 63871
diff changeset
  1230
inaccessible via keyboard completion).
wenzelm
parents: 63871
diff changeset
  1231
63022
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1232
* IDE support for the Isabelle/Pure bootstrap process, with the
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1233
following independent stages:
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1234
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1235
  src/Pure/ROOT0.ML
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1236
  src/Pure/ROOT.ML
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1237
  src/Pure/Pure.thy
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1238
  src/Pure/ML_Bootstrap.thy
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1239
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1240
The ML ROOT files act like quasi-theories in the context of theory
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1241
ML_Bootstrap: this allows continuous checking of all loaded ML files.
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1242
The theory files are presented with a modified header to import Pure
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1243
from the running Isabelle instance. Results from changed versions of
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1244
each stage are *not* propagated to the next stage, and isolated from the
785a59235a15 more IDE support for Isabelle/Pure bootstrap;
wenzelm
parents: 62994
diff changeset
  1245
actual Isabelle/Pure that runs the IDE itself. The sequential
63307
wenzelm
parents: 63303
diff changeset
  1246
dependencies of the above files are only observed for batch build.
62904
wenzelm
parents: 62886
diff changeset
  1247
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1248
* Isabelle/ML and Standard ML files are presented in Sidekick with the
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1249
tree structure of section headings: this special comment format is
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1250
described in "implementation" chapter 0, e.g. (*** section ***).
63461
wenzelm
parents: 63455
diff changeset
  1251
63581
wenzelm
parents: 63579
diff changeset
  1252
* Additional abbreviations for syntactic completion may be specified
63871
f745c6e683b7 discontinued global etc/abbrevs;
wenzelm
parents: 63855
diff changeset
  1253
within the theory header as 'abbrevs'. The theory syntax for 'keywords'
f745c6e683b7 discontinued global etc/abbrevs;
wenzelm
parents: 63855
diff changeset
  1254
has been simplified accordingly: optional abbrevs need to go into the
f745c6e683b7 discontinued global etc/abbrevs;
wenzelm
parents: 63855
diff changeset
  1255
new 'abbrevs' section.
f745c6e683b7 discontinued global etc/abbrevs;
wenzelm
parents: 63855
diff changeset
  1256
f745c6e683b7 discontinued global etc/abbrevs;
wenzelm
parents: 63855
diff changeset
  1257
* Global abbreviations via $ISABELLE_HOME/etc/abbrevs and
f745c6e683b7 discontinued global etc/abbrevs;
wenzelm
parents: 63855
diff changeset
  1258
$ISABELLE_HOME_USER/etc/abbrevs are no longer supported. Minor
f745c6e683b7 discontinued global etc/abbrevs;
wenzelm
parents: 63855
diff changeset
  1259
INCOMPATIBILITY, use 'abbrevs' within theory header instead.
63579
73939a9b70a3 support 'abbrevs' within theory header;
wenzelm
parents: 63560
diff changeset
  1260
64390
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1261
* Action "isabelle.keymap-merge" asks the user to resolve pending
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1262
Isabelle keymap changes that are in conflict with the current jEdit
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1263
keymap; non-conflicting changes are always applied implicitly. This
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1264
action is automatically invoked on Isabelle/jEdit startup and thus
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1265
increases chances that users see new keyboard shortcuts when re-using
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1266
old keymaps.
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1267
63675
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1268
* ML and document antiquotations for file-systems paths are more uniform
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1269
and diverse:
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1270
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1271
  @{path NAME}   -- no file-system check
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1272
  @{file NAME}   -- check for plain file
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1273
  @{dir NAME}    -- check for directory
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1274
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1275
Minor INCOMPATIBILITY, former uses of @{file} and @{file_unchecked} may
e217525d6b64 uniform ML and document antiquotations;
wenzelm
parents: 63669
diff changeset
  1276
have to be changed.
63669
256fc20716f2 clarified antiquotations;
wenzelm
parents: 63656
diff changeset
  1277
256fc20716f2 clarified antiquotations;
wenzelm
parents: 63656
diff changeset
  1278
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1279
*** Document preparation ***
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1280
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1281
* New symbol \<circle>, e.g. for temporal operator.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1282
64073
cffd5f537206 moved to proper release (cf. 4a72b37ac4b8);
wenzelm
parents: 64072
diff changeset
  1283
* New document and ML antiquotation @{locale} for locales, similar to
cffd5f537206 moved to proper release (cf. 4a72b37ac4b8);
wenzelm
parents: 64072
diff changeset
  1284
existing antiquotation @{class}.
cffd5f537206 moved to proper release (cf. 4a72b37ac4b8);
wenzelm
parents: 64072
diff changeset
  1285
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1286
* Mixfix annotations support delimiters like \<^control>\<open>cartouche\<close> --
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1287
this allows special forms of document output.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1288
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1289
* Raw LaTeX output now works via \<^latex>\<open>...\<close> instead of raw control
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1290
symbol \<^raw:...>. INCOMPATIBILITY, notably for LaTeXsugar.thy and its
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1291
derivatives.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1292
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1293
* \<^raw:...> symbols are no longer supported.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1294
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1295
* Old 'header' command is no longer supported (legacy since
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1296
Isabelle2015).
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1297
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1298
62312
5e5a881ebc12 command '\<proof>' is an alias for 'sorry', with different typesetting;
wenzelm
parents: 62284
diff changeset
  1299
*** Isar ***
5e5a881ebc12 command '\<proof>' is an alias for 'sorry', with different typesetting;
wenzelm
parents: 62284
diff changeset
  1300
63180
ddfd021884b4 clarified check_open_spec / read_open_spec;
wenzelm
parents: 63178
diff changeset
  1301
* Many specification elements support structured statements with 'if' /
ddfd021884b4 clarified check_open_spec / read_open_spec;
wenzelm
parents: 63178
diff changeset
  1302
'for' eigen-context, e.g. 'axiomatization', 'abbreviation',
ddfd021884b4 clarified check_open_spec / read_open_spec;
wenzelm
parents: 63178
diff changeset
  1303
'definition', 'inductive', 'function'.
ddfd021884b4 clarified check_open_spec / read_open_spec;
wenzelm
parents: 63178
diff changeset
  1304
63094
056ea294c256 toplevel theorem statements support 'if'/'for' eigen-context;
wenzelm
parents: 63078
diff changeset
  1305
* Toplevel theorem statements support eigen-context notation with 'if' /
63284
c20946f5b6fb spelling;
wenzelm
parents: 63283
diff changeset
  1306
'for' (in postfix), which corresponds to 'assumes' / 'fixes' in the
63094
056ea294c256 toplevel theorem statements support 'if'/'for' eigen-context;
wenzelm
parents: 63078
diff changeset
  1307
traditional long statement form (in prefix). Local premises are called
056ea294c256 toplevel theorem statements support 'if'/'for' eigen-context;
wenzelm
parents: 63078
diff changeset
  1308
"that" or "assms", respectively. Empty premises are *not* bound in the
056ea294c256 toplevel theorem statements support 'if'/'for' eigen-context;
wenzelm
parents: 63078
diff changeset
  1309
context: INCOMPATIBILITY.
056ea294c256 toplevel theorem statements support 'if'/'for' eigen-context;
wenzelm
parents: 63078
diff changeset
  1310
63039
1a20fd9cf281 added Isar command 'define';
wenzelm
parents: 63032
diff changeset
  1311
* Command 'define' introduces a local (non-polymorphic) definition, with
1a20fd9cf281 added Isar command 'define';
wenzelm
parents: 63032
diff changeset
  1312
optional abstraction over local parameters. The syntax resembles
63043
df83a961d3a8 old 'def' is legacy;
wenzelm
parents: 63039
diff changeset
  1313
'definition' and 'obtain'. It fits better into the Isar language than
df83a961d3a8 old 'def' is legacy;
wenzelm
parents: 63039
diff changeset
  1314
old 'def', which is now a legacy feature.
63039
1a20fd9cf281 added Isar command 'define';
wenzelm
parents: 63032
diff changeset
  1315
63059
3f577308551e 'obtain' supports structured statements (similar to 'define');
wenzelm
parents: 63043
diff changeset
  1316
* Command 'obtain' supports structured statements with 'if' / 'for'
3f577308551e 'obtain' supports structured statements (similar to 'define');
wenzelm
parents: 63043
diff changeset
  1317
context.
3f577308551e 'obtain' supports structured statements (similar to 'define');
wenzelm
parents: 63043
diff changeset
  1318
62312
5e5a881ebc12 command '\<proof>' is an alias for 'sorry', with different typesetting;
wenzelm
parents: 62284
diff changeset
  1319
* Command '\<proof>' is an alias for 'sorry', with different
5e5a881ebc12 command '\<proof>' is an alias for 'sorry', with different typesetting;
wenzelm
parents: 62284
diff changeset
  1320
typesetting. E.g. to produce proof holes in examples and documentation.
62216
5fb86150a579 back to post-release mode -- after fork point;
wenzelm
parents: 62209
diff changeset
  1321
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1322
* The defining position of a literal fact \<open>prop\<close> is maintained more
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1323
carefully, and made accessible as hyperlink in the Prover IDE.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1324
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1325
* Commands 'finally' and 'ultimately' used to expose the result as
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1326
literal fact: this accidental behaviour has been discontinued. Rare
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1327
INCOMPATIBILITY, use more explicit means to refer to facts in Isar.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1328
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1329
* Command 'axiomatization' has become more restrictive to correspond
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1330
better to internal axioms as singleton facts with mandatory name. Minor
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1331
INCOMPATIBILITY.
62939
ef8d840f39fb removed old proof method "default";
wenzelm
parents: 62932
diff changeset
  1332
63259
wenzelm
parents: 63237
diff changeset
  1333
* Proof methods may refer to the main facts via the dynamic fact
wenzelm
parents: 63237
diff changeset
  1334
"method_facts". This is particularly useful for Eisbach method
wenzelm
parents: 63237
diff changeset
  1335
definitions.
wenzelm
parents: 63237
diff changeset
  1336
63527
59eff6e56d81 moved method "use" to Pure;
wenzelm
parents: 63513
diff changeset
  1337
* Proof method "use" allows to modify the main facts of a given method
59eff6e56d81 moved method "use" to Pure;
wenzelm
parents: 63513
diff changeset
  1338
expression, e.g.
63259
wenzelm
parents: 63237
diff changeset
  1339
wenzelm
parents: 63237
diff changeset
  1340
  (use facts in simp)
wenzelm
parents: 63237
diff changeset
  1341
  (use facts in \<open>simp add: ...\<close>)
wenzelm
parents: 63237
diff changeset
  1342
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1343
* The old proof method "default" has been removed (legacy since
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1344
Isabelle2016). INCOMPATIBILITY, use "standard" instead.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1345
62216
5fb86150a579 back to post-release mode -- after fork point;
wenzelm
parents: 62209
diff changeset
  1346
63165
c12845e8e80a examples and documentation for code generator time measurements
haftmann
parents: 63161
diff changeset
  1347
*** Pure ***
c12845e8e80a examples and documentation for code generator time measurements
haftmann
parents: 63161
diff changeset
  1348
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1349
* Pure provides basic versions of proof methods "simp" and "simp_all"
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1350
that only know about meta-equality (==). Potential INCOMPATIBILITY in
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1351
theory imports that merge Pure with e.g. Main of Isabelle/HOL: the order
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1352
is relevant to avoid confusion of Pure.simp vs. HOL.simp.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1353
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1354
* The command 'unfolding' and proof method "unfold" include a second
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1355
stage where given equations are passed through the attribute "abs_def"
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1356
before rewriting. This ensures that definitions are fully expanded,
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1357
regardless of the actual parameters that are provided. Rare
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1358
INCOMPATIBILITY in some corner cases: use proof method (simp only:)
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1359
instead, or declare [[unfold_abs_def = false]] in the proof context.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1360
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1361
* Type-inference improves sorts of newly introduced type variables for
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1362
the object-logic, using its base sort (i.e. HOL.type for Isabelle/HOL).
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1363
Thus terms like "f x" or "\<And>x. P x" without any further syntactic context
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1364
produce x::'a::type in HOL instead of x::'a::{} in Pure. Rare
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1365
INCOMPATIBILITY, need to provide explicit type constraints for Pure
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1366
types where this is really intended.
63350
705229ed856e compiling implicit instances into companion objects for classes avoids ambiguities
haftmann
parents: 63343
diff changeset
  1367
63165
c12845e8e80a examples and documentation for code generator time measurements
haftmann
parents: 63161
diff changeset
  1368
62327
112eefe85ff0 document new 'primrec' feature
blanchet
parents: 62312
diff changeset
  1369
*** HOL ***
112eefe85ff0 document new 'primrec' feature
blanchet
parents: 62312
diff changeset
  1370
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1371
* New proof method "argo" using the built-in Argo solver based on SMT
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1372
technology. The method can be used to prove goals of quantifier-free
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1373
propositional logic, goals based on a combination of quantifier-free
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1374
propositional logic with equality, and goals based on a combination of
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1375
quantifier-free propositional logic with linear real arithmetic
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1376
including min/max/abs. See HOL/ex/Argo_Examples.thy for examples.
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1377
66614
1f1c5d85d232 moved Nunchaku to Main; the goal is to move Nitpick out in the next 1-2 years
blanchet
parents: 66599
diff changeset
  1378
* The new "nunchaku" command integrates the Nunchaku model finder. The
64390
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1379
tool is experimental. See ~~/src/HOL/Nunchaku/Nunchaku.thy for details.
ad2c5f37f659 misc tuning for release;
wenzelm
parents: 64389
diff changeset
  1380
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1381
* Metis: The problem encoding has changed very slightly. This might
63785
c882ba741244 added warning
blanchet
parents: 63751
diff changeset
  1382
break existing proofs. INCOMPATIBILITY.
c882ba741244 added warning
blanchet
parents: 63751
diff changeset
  1383
63116
32492105b015 generate Vampire 4.0 compatible output
blanchet
parents: 63113
diff changeset
  1384
* Sledgehammer:
63967
2aa42596edc3 new material on paths, etc. Also rationalisation
paulson <lp15@cam.ac.uk>
parents: 63963
diff changeset
  1385
  - The MaSh relevance filter is now faster than before.
63116
32492105b015 generate Vampire 4.0 compatible output
blanchet
parents: 63113
diff changeset
  1386
  - Produce syntactically correct Vampire 4.0 problem files.
32492105b015 generate Vampire 4.0 compatible output
blanchet
parents: 63113
diff changeset
  1387
62327
112eefe85ff0 document new 'primrec' feature
blanchet
parents: 62312
diff changeset
  1388
* (Co)datatype package:
62693
0ae225877b68 document addition of 'corec'
blanchet
parents: 62678
diff changeset
  1389
  - New commands for defining corecursive functions and reasoning about
0ae225877b68 document addition of 'corec'
blanchet
parents: 62678
diff changeset
  1390
    them in "~~/src/HOL/Library/BNF_Corec.thy": 'corec', 'corecursive',
0ae225877b68 document addition of 'corec'
blanchet
parents: 62678
diff changeset
  1391
    'friend_of_corec', and 'corecursion_upto'; and 'corec_unique' proof
62842
db9f95ca2a8f added reference from NEWS to docs
blanchet
parents: 62840
diff changeset
  1392
    method. See 'isabelle doc corec'.
63977
ec0fb01c6d50 misc tuning for release;
wenzelm
parents: 63967
diff changeset
  1393
  - The predicator :: ('a \<Rightarrow> bool) \<Rightarrow> 'a F \<Rightarrow> bool is now a first-class
63855
blanchet
parents: 63830
diff changeset
  1394
    citizen in bounded natural functors.
62693
0ae225877b68 document addition of 'corec'
blanchet
parents: 62678
diff changeset
  1395
  - 'primrec' now allows nested calls through the predicator in addition
62327
112eefe85ff0 document new 'primrec' feature
blanchet
parents: 62312
diff changeset
  1396
    to the map function.
63855
blanchet
parents: 63830
diff changeset
  1397
  - 'bnf' automatically discharges reflexive proof obligations.