NEWS
author wenzelm
Thu Apr 11 16:43:02 2019 +0200 (5 months ago)
changeset 70122 a0b21b4b7a4a
parent 70121 61e26527480e
child 70127 538d9854ca2f
permissions -rw-r--r--
strip cartouches from arguments of "embedded" document antiquotations, corresponding to automated update via "isabelle update -u control_cartouches" -- e.g. relevant for documents with thy_output_source (e.g. doc "isar-ref", "jedit", "system");
wenzelm@57491
     1
Isabelle NEWS -- history of user-relevant changes
wenzelm@57491
     2
=================================================
wenzelm@2553
     3
wenzelm@62114
     4
(Note: Isabelle/jEdit shows a tree-view of the NEWS file in Sidekick.)
wenzelm@60006
     5
wenzelm@64603
     6
wenzelm@70023
     7
New in Isabelle2019 (June 2019)
wenzelm@70023
     8
-------------------------------
wenzelm@68683
     9
wenzelm@69042
    10
*** General ***
wenzelm@69042
    11
wenzelm@70032
    12
* The font collection "Isabelle DejaVu" is systematically derived from
wenzelm@70032
    13
the existing "DejaVu" fonts, with variants "Sans Mono", "Sans", "Serif"
wenzelm@69343
    14
and styles "Normal", "Bold", "Italic/Oblique", "Bold-Italic/Oblique".
wenzelm@69343
    15
The DejaVu base fonts are retricted to well-defined Unicode ranges and
wenzelm@69343
    16
augmented by special Isabelle symbols, taken from the former
wenzelm@69343
    17
"IsabelleText" font (which is no longer provided separately). The line
wenzelm@69343
    18
metrics and overall rendering quality is closer to original DejaVu.
wenzelm@69343
    19
INCOMPATIBILITY with display configuration expecting the old
wenzelm@69343
    20
"IsabelleText" font: use e.g. "Isabelle DejaVu Sans Mono" instead.
wenzelm@69343
    21
wenzelm@69343
    22
* The Isabelle fonts render "\<inverse>" properly as superscript "-1".
wenzelm@69343
    23
wenzelm@69042
    24
* Old-style inner comments (* ... *) within the term language are no
wenzelm@69042
    25
longer supported (legacy feature in Isabelle2018).
wenzelm@69042
    26
wenzelm@70023
    27
* Old-style {* verbatim *} tokens are explicitly marked as legacy
wenzelm@70023
    28
feature and will be removed soon. Use \<open>cartouche\<close> syntax instead, e.g.
wenzelm@70023
    29
via "isabelle update_cartouches -t" (available since Isabelle2015).
wenzelm@70023
    30
nipkow@69066
    31
* Infix operators that begin or end with a "*" can now be paranthesized
wenzelm@70023
    32
without additional spaces, eg "(*)" instead of "( * )". Minor
wenzelm@70023
    33
INCOMPATIBILITY.
nipkow@69066
    34
wenzelm@69580
    35
* Mixfix annotations may use cartouches instead of old-style double
wenzelm@69586
    36
quotes, e.g. (infixl \<open>+\<close> 60). The command-line tool "isabelle update -u
wenzelm@69586
    37
mixfix_cartouches" allows to update existing theory sources
wenzelm@69586
    38
automatically.
wenzelm@69580
    39
wenzelm@69216
    40
* ML setup commands (e.g. 'setup', 'method_setup', 'parse_translation')
wenzelm@69216
    41
need to provide a closed expression -- without trailing semicolon. Minor
wenzelm@69216
    42
INCOMPATIBILITY.
wenzelm@69216
    43
wenzelm@70057
    44
* Commands 'generate_file', 'export_generated_files', and
wenzelm@70057
    45
'compile_generated_files' support a stateless (PIDE-conformant) model
wenzelm@70057
    46
for generated sources and compiled binaries of other languages. The
wenzelm@70060
    47
compilation process is managed in Isabelle/ML, and results exported to
wenzelm@70057
    48
the session database for further use (e.g. with "isabelle export" or
wenzelm@70057
    49
"isabelle build -e").
wenzelm@70057
    50
wenzelm@69042
    51
wenzelm@69189
    52
*** Isabelle/jEdit Prover IDE ***
wenzelm@69189
    53
wenzelm@70023
    54
* Fonts for the text area, gutter, GUI elements etc. use the "Isabelle
wenzelm@70023
    55
DejaVu" collection by default, which provides uniform rendering quality
wenzelm@70023
    56
with the usual Isabelle symbols. Line spacing no longer needs to be
wenzelm@70023
    57
adjusted: properties for the old IsabelleText font had "Global Options /
wenzelm@70069
    58
Text Area / Extra vertical line spacing (in pixels): -2", it now
wenzelm@70069
    59
defaults to 1, but 0 works as well.
wenzelm@70023
    60
wenzelm@69780
    61
* The jEdit File Browser is more prominent in the default GUI layout of
wenzelm@69780
    62
Isabelle/jEdit: various virtual file-systems provide access to Isabelle
wenzelm@69780
    63
resources, notably via "favorites:" (or "Edit Favorites").
wenzelm@69780
    64
wenzelm@70061
    65
* Further markup and rendering for "plain text" (e.g. informal prose)
wenzelm@70061
    66
and "raw text" (e.g. verbatim sources). This improves the visual
wenzelm@70061
    67
appearance of formal comments inside the term language, or in general
wenzelm@70061
    68
for repeated alternation of formal and informal text.
wenzelm@70061
    69
wenzelm@69643
    70
* Action "isabelle-export-browser" points the File Browser to the theory
wenzelm@69764
    71
exports of the current buffer, based on the "isabelle-export:" virtual
wenzelm@69764
    72
file-system. The directory view needs to be reloaded manually to follow
wenzelm@69764
    73
ongoing document processing.
wenzelm@69764
    74
wenzelm@69764
    75
* Action "isabelle-session-browser" points the File Browser to session
wenzelm@69764
    76
information, based on the "isabelle-session:" virtual file-system. Its
wenzelm@69764
    77
entries are structured according to chapter / session names, the open
wenzelm@69764
    78
operation is redirected to the session ROOT file.
wenzelm@69643
    79
wenzelm@69273
    80
* Support for user-defined file-formats via class isabelle.File_Format
wenzelm@69277
    81
in Isabelle/Scala (e.g. see isabelle.Bibtex.File_Format), configured via
wenzelm@69277
    82
the shell function "isabelle_file_format" in etc/settings (e.g. of an
wenzelm@69277
    83
Isabelle component).
wenzelm@69273
    84
wenzelm@70023
    85
* System option "jedit_text_overview" allows to disable the text
wenzelm@70023
    86
overview column.
wenzelm@70023
    87
wenzelm@69854
    88
* Command-line options "-s" and "-u" of "isabelle jedit" override the
wenzelm@69854
    89
default for system option "system_heaps" that determines the heap
wenzelm@69854
    90
storage directory for "isabelle build". Option "-n" is now clearly
wenzelm@69854
    91
separated from option "-s".
wenzelm@69854
    92
wenzelm@70105
    93
* The Isabelle/jEdit desktop application uses the same options as
wenzelm@70105
    94
"isabelle jedit" for its internal "isabelle build" process: the implicit
wenzelm@70105
    95
option "-o system_heaps" (or "-s") has been discontinued. This reduces
wenzelm@70105
    96
the potential for surprise wrt. command-line tools.
wenzelm@70105
    97
wenzelm@70105
    98
* The official download of the Isabelle/jEdit application already
wenzelm@70105
    99
contains heap images for Isabelle/HOL within its main directory: thus
wenzelm@70105
   100
the first encounter becomes faster and more robust (e.g. when run from a
wenzelm@70105
   101
read-only directory).
wenzelm@70105
   102
wenzelm@70072
   103
* Isabelle DejaVu fonts are available with hinting by default, which is
wenzelm@70072
   104
relevant for low-resolution displays. This may be disabled via system
wenzelm@70072
   105
option "isabelle_fonts_hinted = false" in
wenzelm@70075
   106
$ISABELLE_HOME_USER/etc/preferences -- it occasionally yields better
wenzelm@70072
   107
results.
wenzelm@70072
   108
wenzelm@70031
   109
* OpenJDK 11 has quite different font rendering, with better glyph
wenzelm@70031
   110
shapes and improved sub-pixel anti-aliasing. In some situations results
wenzelm@70072
   111
might be *worse* than Oracle Java 8, though -- a proper HiDPI / UHD
wenzelm@70072
   112
display is recommended.
wenzelm@70023
   113
wenzelm@69189
   114
wenzelm@69962
   115
*** Document preparation ***
wenzelm@69962
   116
wenzelm@69962
   117
* Document markers are formal comments of the form \<^marker>\<open>marker_body\<close> that
wenzelm@69962
   118
are stripped from document output: the effect is to modify the semantic
wenzelm@69962
   119
presentation context or to emit markup to the PIDE document. Some
wenzelm@69962
   120
predefined markers are taken from the Dublin Core Metadata Initiative,
wenzelm@69962
   121
e.g. \<^marker>\<open>contributor arg\<close> or \<^marker>\<open>license arg\<close> and produce PIDE markup that
wenzelm@69962
   122
can retrieved from the document database.
wenzelm@69962
   123
wenzelm@69962
   124
* Old-style command tags %name are re-interpreted as markers \<^marker>\<open>tag name\<close>
wenzelm@69962
   125
and produce LaTeX environments as before. Potential INCOMPATIBILITY:
wenzelm@69962
   126
multiple markers are composed in canonical order, resulting in a
wenzelm@69962
   127
reversed list of tags in the presentation context.
wenzelm@69962
   128
wenzelm@70121
   129
* Document antiquotation option "cartouche" indicates if the output
wenzelm@70121
   130
should be delimited as cartouche; this takes precedence over the
wenzelm@70121
   131
analogous option "quotes".
wenzelm@70121
   132
wenzelm@70122
   133
* Many document antiquotations are internally categorized as "embedded"
wenzelm@70122
   134
and expect one cartouche argument, which is typically used with the
wenzelm@70122
   135
\<^control>\<open>cartouche\<close> notation (e.g. \<^term>\<open>\<lambda>x y. x\<close>). The cartouche
wenzelm@70122
   136
delimiters are stripped in output of the source (antiquotation option
wenzelm@70122
   137
"source"), but it is possible to enforce delimiters via option
wenzelm@70122
   138
"source_cartouche", e.g. @{term [source_cartouche] \<open>\<lambda>x y. x\<close>}.
wenzelm@70122
   139
wenzelm@69962
   140
wenzelm@68879
   141
*** Isar ***
wenzelm@68879
   142
wenzelm@69045
   143
* Implicit cases goal1, goal2, goal3, etc. have been discontinued
wenzelm@69045
   144
(legacy feature since Isabelle2016).
wenzelm@69045
   145
wenzelm@70023
   146
* More robust treatment of structural errors: begin/end blocks take
wenzelm@70023
   147
precedence over goal/proof. This is particularly relevant for the
wenzelm@70023
   148
headless PIDE session and server.
wenzelm@70023
   149
wenzelm@70023
   150
* Command keywords of kind thy_decl / thy_goal may be more specifically
wenzelm@70023
   151
fit into the traditional document model of "definition-statement-proof"
wenzelm@70023
   152
via thy_defn / thy_stmt / thy_goal_defn / thy_goal_stmt.
wenzelm@70023
   153
wenzelm@69045
   154
haftmann@68796
   155
*** HOL ***
haftmann@68796
   156
wenzelm@70009
   157
* Command 'export_code' produces output as logical files within the
wenzelm@70011
   158
theory context, as well as formal session exports that can be
wenzelm@70011
   159
materialized via command-line tools "isabelle export" or "isabelle build
wenzelm@70011
   160
-e" (with 'export_files' in the session ROOT). Isabelle/jEdit also
wenzelm@70011
   161
provides a virtual file-system "isabelle-export:" that can be explored
wenzelm@70011
   162
in the regular file-browser. A 'file_prefix' argument allows to specify
wenzelm@70011
   163
an explicit name prefix for the target file (SML, OCaml, Scala) or
wenzelm@70011
   164
directory (Haskell); the default is "export" with a consecutive number
wenzelm@70011
   165
within each theory.
wenzelm@70009
   166
wenzelm@70009
   167
* Command 'export_code': the 'file' argument is now legacy and will be
wenzelm@70009
   168
removed soon: writing to the physical file-system is not well-defined in
wenzelm@70011
   169
a reactive/parallel application like Isabelle. The empty 'file' argument
wenzelm@70011
   170
has been discontinued already: it is superseded by the file-browser in
wenzelm@70011
   171
Isabelle/jEdit on "isabelle-export:". Minor INCOMPATIBILITY.
haftmann@69624
   172
wenzelm@70022
   173
* Command 'code_reflect' no longer supports the 'file' argument: it has
wenzelm@70022
   174
been superseded by 'file_prefix' for stateless file management as in
wenzelm@70022
   175
'export_code'. Minor INCOMPATIBILITY.
wenzelm@70022
   176
haftmann@69743
   177
* Code generation for OCaml: proper strings are used for literals.
haftmann@69743
   178
Minor INCOMPATIBILITY.
haftmann@69743
   179
wenzelm@69926
   180
* Code generation for OCaml: Zarith supersedes Nums as library for
wenzelm@69926
   181
proper integer arithmetic. The library is located via standard
wenzelm@69926
   182
invocations of "ocamlfind" (via ISABELLE_OCAMLFIND settings variable).
wenzelm@69926
   183
The environment provided by "isabelle ocaml_setup" already contains this
wenzelm@69926
   184
tool and the required packages. Minor INCOMPATIBILITY.
haftmann@69906
   185
haftmann@69690
   186
* Code generation for Haskell: code includes for Haskell must contain
haftmann@69690
   187
proper module frame, nothing is added magically any longer.
haftmann@69690
   188
INCOMPATIBILITY.
haftmann@69690
   189
wenzelm@70023
   190
* Code generation: slightly more conventional syntax for 'code_stmts'
wenzelm@70023
   191
antiquotation. Minor INCOMPATIBILITY.
wenzelm@70023
   192
wenzelm@70023
   193
* Theory List: the precedence of the list_update operator has changed:
wenzelm@70023
   194
"f a [n := x]" now needs to be written "(f a)[n := x]".
wenzelm@70023
   195
wenzelm@70023
   196
* The functions \<Union>, \<Inter>, \<Squnion>, \<Sqinter> (not the corresponding binding operators)
wenzelm@70023
   197
now have the same precedence as any other prefix function symbol. Minor
wenzelm@70023
   198
INCOMPATIBILITY.
haftmann@69861
   199
haftmann@68796
   200
* Simplified syntax setup for big operators under image. In rare
haftmann@68796
   201
situations, type conversions are not inserted implicitly any longer
haftmann@68796
   202
and need to be given explicitly. Auxiliary abbreviations INFIMUM,
haftmann@68796
   203
SUPREMUM, UNION, INTER should now rarely occur in output and are just
haftmann@68796
   204
retained as migration auxiliary. INCOMPATIBILITY.
haftmann@68796
   205
wenzelm@70023
   206
* The simplifier uses image_cong_simp as a congruence rule. The historic
wenzelm@70023
   207
and not really well-formed congruence rules INF_cong*, SUP_cong*, are
wenzelm@70023
   208
not used by default any longer. INCOMPATIBILITY; consider using declare
wenzelm@70023
   209
image_cong_simp [cong del] in extreme situations.
wenzelm@70023
   210
wenzelm@70023
   211
* INF_image and SUP_image are no default simp rules any longer.
wenzelm@70023
   212
INCOMPATIBILITY, prefer image_comp as simp rule if needed.
haftmann@68938
   213
nipkow@69164
   214
* Strong congruence rules (with =simp=> in the premises) for constant f
haftmann@69546
   215
are now uniformly called f_cong_simp, in accordance with congruence
haftmann@69546
   216
rules produced for mappers by the datatype package. INCOMPATIBILITY.
nipkow@69164
   217
wenzelm@70023
   218
* Retired lemma card_Union_image; use the simpler card_UN_disjoint
wenzelm@70023
   219
instead. INCOMPATIBILITY.
wenzelm@70023
   220
wenzelm@70023
   221
* Facts sum_mset.commute and prod_mset.commute have been renamed to
wenzelm@70023
   222
sum_mset.swap and prod_mset.swap, similarly to sum.swap and prod.swap.
wenzelm@70023
   223
INCOMPATIBILITY.
wenzelm@70023
   224
wenzelm@70023
   225
* ML structure Inductive: slightly more conventional naming schema.
wenzelm@70023
   226
Minor INCOMPATIBILITY.
wenzelm@70023
   227
wenzelm@70023
   228
* ML: Various _global variants of specification tools have been removed.
wenzelm@70023
   229
Minor INCOMPATIBILITY, prefer combinators
wenzelm@70023
   230
Named_Target.theory_map[_result] to lift specifications to the global
wenzelm@70023
   231
theory level.
wenzelm@70023
   232
wenzelm@70023
   233
* Theory HOL-Library.Simps_Case_Conv: 'case_of_simps' now supports
wenzelm@70023
   234
overlapping and non-exhaustive patterns and handles arbitrarily nested
wenzelm@70023
   235
patterns. It uses on the same algorithm as HOL-Library.Code_Lazy, which
wenzelm@70023
   236
assumes sequential left-to-right pattern matching. The generated
Andreas@69568
   237
equation no longer tuples the arguments on the right-hand side.
Andreas@69568
   238
INCOMPATIBILITY.
Andreas@69568
   239
wenzelm@70023
   240
* Theory HOL-Library.Multiset: the <Union># operator now has the same
wenzelm@70023
   241
precedence as any other prefix function symbol.
wenzelm@70023
   242
traytel@70080
   243
* Theory HOL-Library.Cardinal_Notations has been discontinued in favor
traytel@70080
   244
of the bundle cardinal_syntax (available in Main).
traytel@70080
   245
Minor INCOMPATIBILITY.
traytel@70080
   246
wenzelm@70023
   247
* Session HOL-Library and HOL-Number_Theory: Exponentiation by squaring,
wenzelm@70023
   248
used for computing powers in class "monoid_mult" and modular
wenzelm@70023
   249
exponentiation.
wenzelm@70023
   250
wenzelm@70023
   251
* Session HOL-Computational_Algebra: Formal Laurent series and overhaul
wenzelm@70023
   252
of Formal power series.
wenzelm@70023
   253
wenzelm@70023
   254
* Session HOL-Number_Theory: More material on residue rings in
wenzelm@70023
   255
Carmichael's function, primitive roots, more properties for "ord".
wenzelm@70023
   256
lp15@70087
   257
* Session HOL-Analysis: Better organization and much more material,
lp15@70087
   258
including algebraic topology.
lp15@70087
   259
lp15@70087
   260
* Session HOL-Algebra: Much more material on group theory.
wenzelm@70032
   261
wenzelm@69099
   262
* Session HOL-SPARK: .prv files are no longer written to the
wenzelm@69099
   263
file-system, but exported to the session database. Results may be
wenzelm@70026
   264
retrieved via "isabelle build -e HOL-SPARK-Examples" on the
wenzelm@70026
   265
command-line.
wenzelm@69099
   266
wenzelm@70023
   267
* Sledgehammer:
wenzelm@70023
   268
  - The URL for SystemOnTPTP, which is used by remote provers, has been
wenzelm@70023
   269
    updated.
wenzelm@70023
   270
  - The machine-learning-based filter MaSh has been optimized to take
wenzelm@70023
   271
    less time (in most cases).
wenzelm@70023
   272
wenzelm@70023
   273
* SMT: reconstruction is now possible using the SMT solver veriT.
wenzelm@70023
   274
haftmann@68796
   275
wenzelm@68803
   276
*** ML ***
wenzelm@68803
   277
wenzelm@70023
   278
* Command 'generate_file' allows to produce sources for other languages,
wenzelm@70023
   279
with antiquotations in the Isabelle context (only the control-cartouche
wenzelm@70023
   280
form). The default "cartouche" antiquotation evaluates an ML expression
wenzelm@70023
   281
of type string and inlines the result as a string literal of the target
wenzelm@70023
   282
language. For example, this works for Haskell as follows:
wenzelm@70023
   283
wenzelm@70023
   284
  generate_file "Pure.hs" = \<open>
wenzelm@70023
   285
  module Isabelle.Pure where
wenzelm@70023
   286
    allConst, impConst, eqConst :: String
wenzelm@70023
   287
    allConst = \<open>\<^const_name>\<open>Pure.all\<close>\<close>
wenzelm@70023
   288
    impConst = \<open>\<^const_name>\<open>Pure.imp\<close>\<close>
wenzelm@70023
   289
    eqConst = \<open>\<^const_name>\<open>Pure.eq\<close>\<close>
wenzelm@70023
   290
  \<close>
wenzelm@70023
   291
wenzelm@70082
   292
See also commands 'export_generated_files' and 'compile_generated_files'
wenzelm@70082
   293
to use the results.
wenzelm@68803
   294
wenzelm@68824
   295
* ML evaluation (notably via commands 'ML' and 'ML_file') is subject to
wenzelm@68824
   296
option ML_environment to select a named environment, such as "Isabelle"
wenzelm@68824
   297
for Isabelle/ML, or "SML" for official Standard ML. It is also possible
wenzelm@68824
   298
to move toplevel bindings between environments, using a notation with
wenzelm@68824
   299
">" as separator. For example:
wenzelm@68824
   300
wenzelm@68824
   301
  declare [[ML_environment = "Isabelle>SML"]]
wenzelm@68824
   302
  ML \<open>val println = writeln\<close>
wenzelm@68824
   303
wenzelm@68824
   304
  declare [[ML_environment = "SML"]]
wenzelm@68824
   305
  ML \<open>println "test"\<close>
wenzelm@68824
   306
wenzelm@68824
   307
  declare [[ML_environment = "Isabelle"]]
wenzelm@68824
   308
  ML \<open>println\<close>  \<comment> \<open>not present\<close>
wenzelm@68824
   309
wenzelm@68824
   310
The Isabelle/ML function ML_Env.setup defines new ML environments. This
wenzelm@68824
   311
is useful to incorporate big SML projects in an isolated name space, and
wenzelm@68824
   312
potentially with variations on ML syntax (existing ML_Env.SML_operations
wenzelm@68824
   313
observes the official standard).
wenzelm@68803
   314
wenzelm@69381
   315
* ML antiquotation @{master_dir} refers to the master directory of the
wenzelm@69381
   316
underlying theory, i.e. the directory of the theory file.
wenzelm@69381
   317
wenzelm@69470
   318
* ML antiquotation @{verbatim} inlines its argument as string literal,
wenzelm@69470
   319
preserving newlines literally. The short form \<^verbatim>\<open>abc\<close> is particularly
wenzelm@69470
   320
useful.
wenzelm@69470
   321
wenzelm@70023
   322
* Local_Theory.reset is no longer available in user space. Regular
wenzelm@70023
   323
definitional packages should use balanced blocks of
wenzelm@70023
   324
Local_Theory.open_target versus Local_Theory.close_target instead, or
wenzelm@70023
   325
the Local_Theory.subtarget(_result) combinator. Rare INCOMPATIBILITY.
wenzelm@70023
   326
wenzelm@70023
   327
* Original PolyML.pointerEq is retained as a convenience for tools that
wenzelm@70023
   328
don't use Isabelle/ML (where this is called "pointer_eq").
wenzelm@69381
   329
wenzelm@69282
   330
wenzelm@68883
   331
*** System ***
wenzelm@68883
   332
wenzelm@70031
   333
* Update to OpenJDK 11: the current long-term support version of Java.
wenzelm@70023
   334
wenzelm@70023
   335
* Update to Poly/ML 5.8 allows to use the native x86_64 platform without
wenzelm@70023
   336
the full overhead of 64-bit values everywhere. This special x86_64_32
wenzelm@70023
   337
mode provides up to 16GB ML heap, while program code and stacks are
wenzelm@70023
   338
allocated elsewhere. Thus approx. 5 times more memory is available for
wenzelm@70023
   339
applications compared to old x86 mode (which is no longer used by
wenzelm@70023
   340
Isabelle). The switch to the x86_64 CPU architecture also avoids
wenzelm@70023
   341
compatibility problems with Linux and macOS, where 32-bit applications
wenzelm@70023
   342
are gradually phased out.
wenzelm@70023
   343
wenzelm@70023
   344
* System option "checkpoint" has been discontinued: obsolete thanks to
wenzelm@70023
   345
improved memory management in Poly/ML.
wenzelm@70023
   346
wenzelm@70023
   347
* System option "system_heaps" determines where to store the session
wenzelm@69854
   348
image of "isabelle build" (and other tools using that internally).
wenzelm@69854
   349
Former option "-s" is superseded by option "-o system_heaps".
wenzelm@69854
   350
INCOMPATIBILITY in command-line syntax.
wenzelm@69854
   351
wenzelm@70023
   352
* Session directory $ISABELLE_HOME/src/Tools/Haskell provides some
wenzelm@70023
   353
source modules for Isabelle tools implemented in Haskell, notably for
wenzelm@70023
   354
Isabelle/PIDE.
wenzelm@70023
   355
wenzelm@70023
   356
* The command-line tool "isabelle build -e" retrieves theory exports
wenzelm@70023
   357
from the session build database, using 'export_files' in session ROOT
wenzelm@70023
   358
entries.
wenzelm@70023
   359
wenzelm@69585
   360
* The command-line tool "isabelle update" uses Isabelle/PIDE in
wenzelm@69585
   361
batch-mode to update theory sources based on semantic markup produced in
wenzelm@69609
   362
Isabelle/ML. Actual updates depend on system options that may be enabled
wenzelm@69588
   363
via "-u OPT" (for "update_OPT"), see also $ISABELLE_HOME/etc/options
wenzelm@69588
   364
section "Theory update". Theory sessions are specified as in "isabelle
wenzelm@69585
   365
dump".
wenzelm@69585
   366
wenzelm@69592
   367
* The command-line tool "isabelle update -u control_cartouches" changes
wenzelm@69592
   368
antiquotations into control-symbol format (where possible): @{NAME}
wenzelm@69592
   369
becomes \<^NAME> and @{NAME ARG} becomes \<^NAME>\<open>ARG\<close>.
wenzelm@69592
   370
wenzelm@69277
   371
* Support for Isabelle command-line tools defined in Isabelle/Scala.
wenzelm@69277
   372
Instances of class Isabelle_Scala_Tools may be configured via the shell
wenzelm@69277
   373
function "isabelle_scala_tools" in etc/settings (e.g. of an Isabelle
wenzelm@69277
   374
component).
wenzelm@69277
   375
wenzelm@70023
   376
* Isabelle Server command "use_theories" supports "nodes_status_delay"
wenzelm@69044
   377
for continuous output of node status information. The time interval is
wenzelm@69044
   378
specified in seconds; a negative value means it is disabled (default).
wenzelm@69044
   379
wenzelm@69044
   380
* Isabelle Server command "use_theories" terminates more robustly in the
wenzelm@68883
   381
presence of structurally broken sources: full consolidation of theories
wenzelm@68883
   382
is no longer required.
wenzelm@68883
   383
wenzelm@69926
   384
* OCaml tools and libraries are now accesed via ISABELLE_OCAMLFIND,
wenzelm@69926
   385
which needs to point to a suitable version of "ocamlfind" (e.g. via
wenzelm@69926
   386
OPAM, see below). INCOMPATIBILITY: settings variables ISABELLE_OCAML and
wenzelm@69926
   387
ISABELLE_OCAMLC are no longer supported.
wenzelm@69926
   388
wenzelm@69268
   389
* Support for managed installations of Glasgow Haskell Compiler and
wenzelm@69268
   390
OCaml via the following command-line tools:
wenzelm@69268
   391
wenzelm@69268
   392
  isabelle ghc_setup
wenzelm@69268
   393
  isabelle ghc_stack
wenzelm@69268
   394
wenzelm@69268
   395
  isabelle ocaml_setup
wenzelm@69268
   396
  isabelle ocaml_opam
wenzelm@69268
   397
wenzelm@69268
   398
The global installation state is determined by the following settings
wenzelm@69268
   399
(and corresponding directory contents):
wenzelm@69268
   400
wenzelm@69268
   401
  ISABELLE_STACK_ROOT
wenzelm@69268
   402
  ISABELLE_STACK_RESOLVER
wenzelm@69268
   403
  ISABELLE_GHC_VERSION
wenzelm@69268
   404
wenzelm@69268
   405
  ISABELLE_OPAM_ROOT
wenzelm@69268
   406
  ISABELLE_OCAML_VERSION
wenzelm@69268
   407
wenzelm@69268
   408
After setup, the following Isabelle settings are automatically
wenzelm@69268
   409
redirected (overriding existing user settings):
wenzelm@69268
   410
wenzelm@69269
   411
  ISABELLE_GHC
wenzelm@69269
   412
wenzelm@69926
   413
  ISABELLE_OCAMLFIND
wenzelm@69268
   414
wenzelm@69268
   415
The old meaning of these settings as locally installed executables may
wenzelm@69268
   416
be recovered by purging the directories ISABELLE_STACK_ROOT /
wenzelm@69926
   417
ISABELLE_OPAM_ROOT, or by resetting these variables in
wenzelm@69926
   418
$ISABELLE_HOME_USER/etc/settings.
wenzelm@69189
   419
wenzelm@69822
   420
wenzelm@68883
   421
wenzelm@68391
   422
New in Isabelle2018 (August 2018)
wenzelm@68391
   423
---------------------------------
wenzelm@66651
   424
wenzelm@66712
   425
*** General ***
wenzelm@66712
   426
wenzelm@68393
   427
* Session-qualified theory names are mandatory: it is no longer possible
wenzelm@68393
   428
to refer to unqualified theories from the parent session.
wenzelm@68393
   429
INCOMPATIBILITY for old developments that have not been updated to
wenzelm@68393
   430
Isabelle2017 yet (using the "isabelle imports" tool).
wenzelm@68393
   431
wenzelm@68393
   432
* Only the most fundamental theory names are global, usually the entry
wenzelm@68393
   433
points to major logic sessions: Pure, Main, Complex_Main, HOLCF, IFOL,
wenzelm@68393
   434
FOL, ZF, ZFC etc. INCOMPATIBILITY, need to use qualified names for
wenzelm@68393
   435
formerly global "HOL-Probability.Probability" and "HOL-SPARK.SPARK".
wenzelm@68393
   436
wenzelm@68558
   437
* Global facts need to be closed: no free variables and no hypotheses.
wenzelm@68558
   438
Rare INCOMPATIBILITY.
wenzelm@68540
   439
wenzelm@68661
   440
* Facts stemming from locale interpretation are subject to lazy
wenzelm@68661
   441
evaluation for improved performance. Rare INCOMPATIBILITY: errors
wenzelm@68661
   442
stemming from interpretation morphisms might be deferred and thus
wenzelm@68661
   443
difficult to locate; enable system option "strict_facts" temporarily to
wenzelm@68661
   444
avoid this.
wenzelm@68661
   445
wenzelm@67446
   446
* Marginal comments need to be written exclusively in the new-style form
wenzelm@67446
   447
"\<comment> \<open>text\<close>", old ASCII variants like "-- {* ... *}" are no longer
wenzelm@67446
   448
supported. INCOMPATIBILITY, use the command-line tool "isabelle
wenzelm@67446
   449
update_comments" to update existing theory files.
wenzelm@67446
   450
wenzelm@67507
   451
* Old-style inner comments (* ... *) within the term language are legacy
wenzelm@67507
   452
and will be discontinued soon: use formal comments "\<comment> \<open>...\<close>" or "\<^cancel>\<open>...\<close>"
wenzelm@67507
   453
instead.
wenzelm@67507
   454
nipkow@67402
   455
* The "op <infix-op>" syntax for infix operators has been replaced by
nipkow@67400
   456
"(<infix-op>)". If <infix-op> begins or ends with a "*", there needs to
nipkow@67400
   457
be a space between the "*" and the corresponding parenthesis.
wenzelm@68543
   458
INCOMPATIBILITY, use the command-line tool "isabelle update_op" to
wenzelm@68543
   459
convert theory and ML files to the new syntax. Because it is based on
wenzelm@68543
   460
regular expression matching, the result may need a bit of manual
wenzelm@68543
   461
postprocessing. Invoking "isabelle update_op" converts all files in the
wenzelm@68543
   462
current directory (recursively). In case you want to exclude conversion
wenzelm@68543
   463
of ML files (because the tool frequently also converts ML's "op"
wenzelm@68543
   464
syntax), use option "-m".
nipkow@67398
   465
wenzelm@67013
   466
* Theory header 'abbrevs' specifications need to be separated by 'and'.
wenzelm@67013
   467
INCOMPATIBILITY.
wenzelm@67013
   468
wenzelm@66757
   469
* Command 'external_file' declares the formal dependency on the given
wenzelm@66757
   470
file name, such that the Isabelle build process knows about it, but
wenzelm@66757
   471
without specific Prover IDE management.
wenzelm@66757
   472
wenzelm@66759
   473
* Session ROOT entries no longer allow specification of 'files'. Rare
wenzelm@66759
   474
INCOMPATIBILITY, use command 'external_file' within a proper theory
wenzelm@66759
   475
context.
wenzelm@66759
   476
wenzelm@66764
   477
* Session root directories may be specified multiple times: each
wenzelm@66764
   478
accessible ROOT file is processed only once. This facilitates
wenzelm@66764
   479
specification of $ISABELLE_HOME_USER/ROOTS or command-line options like
wenzelm@66764
   480
-d or -D for "isabelle build" and "isabelle jedit". Example:
wenzelm@66764
   481
wenzelm@66764
   482
  isabelle build -D '~~/src/ZF'
wenzelm@66764
   483
wenzelm@67263
   484
* The command 'display_drafts' has been discontinued. INCOMPATIBILITY,
wenzelm@67263
   485
use action "isabelle.draft" (or "print") in Isabelle/jEdit instead.
wenzelm@67263
   486
wenzelm@68393
   487
* In HTML output, the Isabelle symbol "\<hyphen>" is rendered as explicit
wenzelm@68393
   488
Unicode hyphen U+2010, to avoid unclear meaning of the old "soft hyphen"
wenzelm@68393
   489
U+00AD. Rare INCOMPATIBILITY, e.g. copy-paste of historic Isabelle HTML
wenzelm@68393
   490
output.
wenzelm@67305
   491
wenzelm@66712
   492
wenzelm@67261
   493
*** Isabelle/jEdit Prover IDE ***
wenzelm@66768
   494
wenzelm@68393
   495
* The command-line tool "isabelle jedit" provides more flexible options
wenzelm@68393
   496
for session management:
wenzelm@68393
   497
wenzelm@68472
   498
  - option -R builds an auxiliary logic image with all theories from
wenzelm@68472
   499
    other sessions that are not already present in its parent
wenzelm@68393
   500
wenzelm@68393
   501
  - option -S is like -R, with a focus on the selected session and its
wenzelm@68393
   502
    descendants (this reduces startup time for big projects like AFP)
wenzelm@68393
   503
wenzelm@68472
   504
  - option -A specifies an alternative ancestor session for options -R
wenzelm@68472
   505
    and -S
wenzelm@68472
   506
wenzelm@68541
   507
  - option -i includes additional sessions into the name-space of
wenzelm@68541
   508
    theories
wenzelm@68541
   509
wenzelm@68393
   510
  Examples:
wenzelm@68393
   511
    isabelle jedit -R HOL-Number_Theory
wenzelm@68393
   512
    isabelle jedit -R HOL-Number_Theory -A HOL
wenzelm@68393
   513
    isabelle jedit -d '$AFP' -S Formal_SSA -A HOL
wenzelm@68393
   514
    isabelle jedit -d '$AFP' -S Formal_SSA -A HOL-Analysis
wenzelm@68541
   515
    isabelle jedit -d '$AFP' -S Formal_SSA -A HOL-Analysis -i CryptHOL
wenzelm@68393
   516
wenzelm@68393
   517
* PIDE markup for session ROOT files: allows to complete session names,
wenzelm@68393
   518
follow links to theories and document files etc.
wenzelm@68393
   519
wenzelm@68393
   520
* Completion supports theory header imports, using theory base name.
wenzelm@68393
   521
E.g. "Prob" may be completed to "HOL-Probability.Probability".
wenzelm@68393
   522
wenzelm@68393
   523
* Named control symbols (without special Unicode rendering) are shown as
wenzelm@68393
   524
bold-italic keyword. This is particularly useful for the short form of
wenzelm@68393
   525
antiquotations with control symbol: \<^name>\<open>argument\<close>. The action
wenzelm@68393
   526
"isabelle.antiquoted_cartouche" turns an antiquotation with 0 or 1
wenzelm@68393
   527
arguments into this format.
wenzelm@68393
   528
wenzelm@68393
   529
* Completion provides templates for named symbols with arguments,
wenzelm@68393
   530
e.g. "\<comment> \<open>ARGUMENT\<close>" or "\<^emph>\<open>ARGUMENT\<close>".
wenzelm@68393
   531
wenzelm@68368
   532
* Slightly more parallel checking, notably for high priority print
wenzelm@68368
   533
functions (e.g. State output).
wenzelm@68368
   534
wenzelm@68080
   535
* The view title is set dynamically, according to the Isabelle
wenzelm@68080
   536
distribution and the logic session name. The user can override this via
wenzelm@68080
   537
set-view-title (stored persistently in $JEDIT_SETTINGS/perspective.xml).
wenzelm@68080
   538
wenzelm@67395
   539
* System options "spell_checker_include" and "spell_checker_exclude"
wenzelm@67395
   540
supersede former "spell_checker_elements" to determine regions of text
wenzelm@67395
   541
that are subject to spell-checking. Minor INCOMPATIBILITY.
wenzelm@67395
   542
wenzelm@67248
   543
* Action "isabelle.preview" is able to present more file formats,
wenzelm@67266
   544
notably bibtex database files and ML files.
wenzelm@67246
   545
wenzelm@67262
   546
* Action "isabelle.draft" is similar to "isabelle.preview", but shows a
wenzelm@68067
   547
plain-text document draft. Both are available via the menu "Plugins /
wenzelm@68067
   548
Isabelle".
wenzelm@67262
   549
wenzelm@67304
   550
* When loading text files, the Isabelle symbols encoding UTF-8-Isabelle
wenzelm@67304
   551
is only used if there is no conflict with existing Unicode sequences in
wenzelm@67304
   552
the file. Otherwise, the fallback encoding is plain UTF-8 and Isabelle
wenzelm@67304
   553
symbols remain in literal \<symbol> form. This avoids accidental loss of
wenzelm@67304
   554
Unicode content when saving the file.
wenzelm@67304
   555
wenzelm@68545
   556
* Bibtex database files (.bib) are semantically checked.
wenzelm@68545
   557
wenzelm@67993
   558
* Update to jedit-5.5.0, the latest release.
wenzelm@67993
   559
wenzelm@67246
   560
wenzelm@67261
   561
*** Isabelle/VSCode Prover IDE ***
wenzelm@67261
   562
wenzelm@67261
   563
* HTML preview of theories and other file-formats similar to
wenzelm@67261
   564
Isabelle/jEdit.
wenzelm@67261
   565
wenzelm@68690
   566
* Command-line tool "isabelle vscode_server" accepts the same options
wenzelm@68690
   567
-A, -R, -S, -i for session selection as "isabelle jedit". This is
wenzelm@68690
   568
relevant for isabelle.args configuration settings in VSCode. The former
wenzelm@68690
   569
option -A (explore all known session files) has been discontinued: it is
wenzelm@68690
   570
enabled by default, unless option -S is used to focus on a particular
wenzelm@68690
   571
spot in the session structure. INCOMPATIBILITY.
wenzelm@68690
   572
wenzelm@66768
   573
wenzelm@67140
   574
*** Document preparation ***
wenzelm@67140
   575
wenzelm@67448
   576
* Formal comments work uniformly in outer syntax, inner syntax (term
wenzelm@67448
   577
language), Isabelle/ML and some other embedded languages of Isabelle.
wenzelm@67448
   578
See also "Document comments" in the isar-ref manual. The following forms
wenzelm@67448
   579
are supported:
wenzelm@67448
   580
wenzelm@67448
   581
  - marginal text comment: \<comment> \<open>\<dots>\<close>
wenzelm@67448
   582
  - canceled source: \<^cancel>\<open>\<dots>\<close>
wenzelm@67448
   583
  - raw LaTeX: \<^latex>\<open>\<dots>\<close>
wenzelm@67413
   584
wenzelm@67381
   585
* Outside of the inner theory body, the default presentation context is
wenzelm@67381
   586
theory Pure. Thus elementary antiquotations may be used in markup
wenzelm@67381
   587
commands (e.g. 'chapter', 'section', 'text') and formal comments.
wenzelm@67381
   588
wenzelm@68513
   589
* System option "document_tags" specifies alternative command tags. This
wenzelm@68513
   590
is occasionally useful to control the global visibility of commands via
wenzelm@68513
   591
session options (e.g. in ROOT).
wenzelm@67140
   592
wenzelm@67140
   593
* Document markup commands ('section', 'text' etc.) are implicitly
wenzelm@67140
   594
tagged as "document" and visible by default. This avoids the application
wenzelm@67140
   595
of option "document_tags" to these commands.
wenzelm@67140
   596
wenzelm@67145
   597
* Isabelle names are mangled into LaTeX macro names to allow the full
wenzelm@67145
   598
identifier syntax with underscore, prime, digits. This is relevant for
wenzelm@67145
   599
antiquotations in control symbol notation, e.g. \<^const_name> becomes
wenzelm@67145
   600
\isactrlconstUNDERSCOREname.
wenzelm@67145
   601
wenzelm@68393
   602
* Document preparation with skip_proofs option now preserves the content
wenzelm@68393
   603
more accurately: only terminal proof steps ('by' etc.) are skipped.
wenzelm@67297
   604
wenzelm@68484
   605
* Document antiquotation @{theory name} requires the long
wenzelm@68484
   606
session-qualified theory name: this is what users reading the text
wenzelm@68484
   607
normally need to import.
wenzelm@68484
   608
wenzelm@67219
   609
* Document antiquotation @{session name} checks and prints the given
wenzelm@67219
   610
session name verbatim.
wenzelm@67219
   611
wenzelm@68393
   612
* Document antiquotation @{cite} now checks the given Bibtex entries
wenzelm@68393
   613
against the Bibtex database files -- only in batch-mode session builds.
wenzelm@67157
   614
wenzelm@67176
   615
* Command-line tool "isabelle document" has been re-implemented in
wenzelm@67194
   616
Isabelle/Scala, with simplified arguments and explicit errors from the
wenzelm@67203
   617
latex and bibtex process. Minor INCOMPATIBILITY.
wenzelm@67173
   618
wenzelm@68393
   619
* Session ROOT entry: empty 'document_files' means there is no document
wenzelm@68393
   620
for this session. There is no need to specify options [document = false]
wenzelm@68393
   621
anymore.
wenzelm@68393
   622
wenzelm@67140
   623
wenzelm@67702
   624
*** Isar ***
wenzelm@67702
   625
wenzelm@67702
   626
* Command 'interpret' no longer exposes resulting theorems as literal
wenzelm@67702
   627
facts, notably for the \<open>prop\<close> notation or the "fact" proof method. This
wenzelm@67702
   628
improves modularity of proofs and scalability of locale interpretation.
wenzelm@67702
   629
Rare INCOMPATIBILITY, need to refer to explicitly named facts instead
wenzelm@67702
   630
(e.g. use 'find_theorems' or 'try' to figure this out).
wenzelm@67702
   631
wenzelm@68393
   632
* The old 'def' command has been discontinued (legacy since
wenzelm@68393
   633
Isbelle2016-1). INCOMPATIBILITY, use 'define' instead -- usually with
wenzelm@68393
   634
object-logic equality or equivalence.
wenzelm@68393
   635
wenzelm@68543
   636
wenzelm@68543
   637
*** Pure ***
wenzelm@68543
   638
wenzelm@68543
   639
* The inner syntax category "sort" now includes notation "_" for the
wenzelm@68543
   640
dummy sort: it is effectively ignored in type-inference.
wenzelm@68543
   641
ballarin@67740
   642
* Rewrites clauses (keyword 'rewrites') were moved into the locale
wenzelm@68393
   643
expression syntax, where they are part of locale instances. In
wenzelm@68393
   644
interpretation commands rewrites clauses now need to occur before 'for'
ballarin@68469
   645
and 'defines'. Rare INCOMPATIBILITY; definitions immediately subject to
ballarin@68469
   646
rewriting may need to be pulled up into the surrounding theory.
wenzelm@68393
   647
wenzelm@68393
   648
* For 'rewrites' clauses, if activating a locale instance fails, fall
wenzelm@68393
   649
back to reading the clause first. This helps avoid qualification of
ballarin@67764
   650
locale instances where the qualifier's sole purpose is avoiding
ballarin@67764
   651
duplicate constant declarations.
ballarin@67741
   652
wenzelm@68543
   653
* Proof method "simp" now supports a new modifier "flip:" followed by a
wenzelm@68543
   654
list of theorems. Each of these theorems is removed from the simpset
wenzelm@68543
   655
(without warning if it is not there) and the symmetric version of the
wenzelm@68543
   656
theorem (i.e. lhs and rhs exchanged) is added to the simpset. For "auto"
wenzelm@68543
   657
and friends the modifier is "simp flip:".
wenzelm@67718
   658
wenzelm@67718
   659
blanchet@66661
   660
*** HOL ***
blanchet@66661
   661
wenzelm@68568
   662
* Sledgehammer: bundled version of "vampire" (for non-commercial users)
wenzelm@68568
   663
helps to avoid fragility of "remote_vampire" service.
wenzelm@68568
   664
haftmann@68028
   665
* Clarified relationship of characters, strings and code generation:
haftmann@68028
   666
wenzelm@68393
   667
  - Type "char" is now a proper datatype of 8-bit values.
wenzelm@68393
   668
wenzelm@68393
   669
  - Conversions "nat_of_char" and "char_of_nat" are gone; use more
wenzelm@68393
   670
    general conversions "of_char" and "char_of" with suitable type
wenzelm@68393
   671
    constraints instead.
wenzelm@68393
   672
wenzelm@68393
   673
  - The zero character is just written "CHR 0x00", not "0" any longer.
wenzelm@68393
   674
wenzelm@68393
   675
  - Type "String.literal" (for code generation) is now isomorphic to
wenzelm@68393
   676
    lists of 7-bit (ASCII) values; concrete values can be written as
wenzelm@68393
   677
    "STR ''...''" for sequences of printable characters and "STR 0x..."
wenzelm@68393
   678
    for one single ASCII code point given as hexadecimal numeral.
wenzelm@68393
   679
wenzelm@68393
   680
  - Type "String.literal" supports concatenation "... + ..." for all
wenzelm@68393
   681
    standard target languages.
wenzelm@68393
   682
wenzelm@68393
   683
  - Theory HOL-Library.Code_Char is gone; study the explanations
wenzelm@68393
   684
    concerning "String.literal" in the tutorial on code generation to
wenzelm@68393
   685
    get an idea how target-language string literals can be converted to
wenzelm@68393
   686
    HOL string values and vice versa.
wenzelm@68393
   687
wenzelm@68393
   688
  - Session Imperative-HOL: operation "raise" directly takes a value of
wenzelm@68393
   689
    type "String.literal" as argument, not type "string".
wenzelm@68393
   690
wenzelm@68393
   691
INCOMPATIBILITY.
wenzelm@68393
   692
wenzelm@68393
   693
* Code generation: Code generation takes an explicit option
wenzelm@68393
   694
"case_insensitive" to accomodate case-insensitive file systems.
wenzelm@68393
   695
wenzelm@68393
   696
* Abstract bit operations as part of Main: push_bit, take_bit, drop_bit.
wenzelm@68393
   697
wenzelm@68393
   698
* New, more general, axiomatization of complete_distrib_lattice. The
wenzelm@68393
   699
former axioms:
wenzelm@68393
   700
wenzelm@68393
   701
  "sup x (Inf X) = Inf (sup x ` X)" and "inf x (Sup X) = Sup (inf x ` X)"
wenzelm@68393
   702
wenzelm@68393
   703
are replaced by:
wenzelm@68393
   704
wenzelm@68393
   705
  "Inf (Sup ` A) <= Sup (Inf ` {f ` A | f . (! Y \<in> A . f Y \<in> Y)})"
wenzelm@68393
   706
wenzelm@68393
   707
The instantiations of sets and functions as complete_distrib_lattice are
wenzelm@68393
   708
moved to Hilbert_Choice.thy because their proofs need the Hilbert choice
wenzelm@68393
   709
operator. The dual of this property is also proved in theory
wenzelm@68393
   710
HOL.Hilbert_Choice.
eberlm@67831
   711
lp15@67999
   712
* New syntax for the minimum/maximum of a function over a finite set:
wenzelm@68393
   713
MIN x\<in>A. B and even MIN x. B (only useful for finite types), also MAX.
lp15@67999
   714
haftmann@67525
   715
* Clarifed theorem names:
haftmann@67525
   716
haftmann@67525
   717
  Min.antimono ~> Min.subset_imp
haftmann@67525
   718
  Max.antimono ~> Max.subset_imp
haftmann@67525
   719
haftmann@67525
   720
Minor INCOMPATIBILITY.
haftmann@67525
   721
blanchet@66661
   722
* SMT module:
wenzelm@68393
   723
blanchet@66661
   724
  - The 'smt_oracle' option is now necessary when using the 'smt' method
blanchet@66662
   725
    with a solver other than Z3. INCOMPATIBILITY.
wenzelm@68393
   726
wenzelm@66844
   727
  - The encoding to first-order logic is now more complete in the
wenzelm@66844
   728
    presence of higher-order quantifiers. An 'smt_explicit_application'
wenzelm@66844
   729
    option has been added to control this. INCOMPATIBILITY.
wenzelm@66844
   730
haftmann@66804
   731
* Facts sum.commute(_restrict) and prod.commute(_restrict) renamed to
wenzelm@66844
   732
sum.swap(_restrict) and prod.swap(_restrict), to avoid name clashes on
wenzelm@66844
   733
interpretation of abstract locales. INCOMPATIBILITY.
haftmann@66804
   734
wenzelm@68393
   735
* Predicate coprime is now a real definition, not a mere abbreviation.
wenzelm@68393
   736
INCOMPATIBILITY.
wenzelm@68393
   737
haftmann@66803
   738
* Predicate pairwise_coprime abolished, use "pairwise coprime" instead.
haftmann@66803
   739
INCOMPATIBILITY.
haftmann@66803
   740
lp15@68373
   741
* The relator rel_filter on filters has been strengthened to its
wenzelm@68393
   742
canonical categorical definition with better properties.
wenzelm@68393
   743
INCOMPATIBILITY.
Andreas@67616
   744
immler@68072
   745
* Generalized linear algebra involving linear, span, dependent, dim
immler@68072
   746
from type class real_vector to locales module and vector_space.
immler@68072
   747
Renamed:
wenzelm@68393
   748
wenzelm@68393
   749
  span_inc ~> span_superset
wenzelm@68393
   750
  span_superset ~> span_base
wenzelm@68393
   751
  span_eq ~> span_eq_iff
wenzelm@68393
   752
wenzelm@68393
   753
INCOMPATIBILITY.
wenzelm@66844
   754
haftmann@66937
   755
* Class linordered_semiring_1 covers zero_less_one also, ruling out
haftmann@66937
   756
pathologic instances. Minor INCOMPATIBILITY.
haftmann@66937
   757
wenzelm@68393
   758
* Theory HOL.List: functions "sorted_wrt" and "sorted" now compare every
wenzelm@68393
   759
element in a list to all following elements, not just the next one.
wenzelm@68393
   760
wenzelm@68393
   761
* Theory HOL.List syntax:
wenzelm@68393
   762
wenzelm@68393
   763
  - filter-syntax "[x <- xs. P]" is no longer output syntax, but only
wenzelm@68393
   764
    input syntax
wenzelm@68393
   765
wenzelm@68393
   766
  - list comprehension syntax now supports tuple patterns in "pat <- xs"
nipkow@68249
   767
nipkow@68450
   768
* Theory Map: "empty" must now be qualified as "Map.empty".
nipkow@68450
   769
haftmann@67051
   770
* Removed nat-int transfer machinery. Rare INCOMPATIBILITY.
haftmann@67051
   771
haftmann@68100
   772
* Fact mod_mult_self4 (on nat) renamed to Suc_mod_mult_self3, to avoid
haftmann@68100
   773
clash with fact mod_mult_self4 (on more generic semirings).
haftmann@68100
   774
INCOMPATIBILITY.
haftmann@68100
   775
haftmann@68100
   776
* Eliminated some theorem aliasses:
haftmann@68100
   777
  even_times_iff ~> even_mult_iff
haftmann@68100
   778
  mod_2_not_eq_zero_eq_one_nat ~> not_mod_2_eq_0_eq_1
haftmann@68100
   779
  even_of_nat ~> even_int_iff
haftmann@68100
   780
haftmann@68100
   781
INCOMPATIBILITY.
haftmann@68100
   782
haftmann@68157
   783
* Eliminated some theorem duplicate variations:
wenzelm@68393
   784
wenzelm@68393
   785
  - dvd_eq_mod_eq_0_numeral can be replaced by dvd_eq_mod_eq_0
wenzelm@68393
   786
  - mod_Suc_eq_Suc_mod can be replaced by mod_Suc
wenzelm@68393
   787
  - mod_Suc_eq_Suc_mod [symmetrict] can be replaced by mod_simps
wenzelm@68393
   788
  - mod_eq_0_iff can be replaced by mod_eq_0_iff_dvd and dvd_def
wenzelm@68393
   789
  - the witness of mod_eqD can be given directly as "_ div _"
haftmann@68157
   790
haftmann@68157
   791
INCOMPATIBILITY.
haftmann@68157
   792
haftmann@68260
   793
* Classical setup: Assumption "m mod d = 0" (for m d :: nat) is no
wenzelm@68393
   794
longer aggresively destroyed to "\<exists>q. m = d * q". INCOMPATIBILITY, adding
wenzelm@68393
   795
"elim!: dvd" to classical proof methods in most situations restores
wenzelm@68393
   796
broken proofs.
wenzelm@68393
   797
wenzelm@68393
   798
* Theory HOL-Library.Conditional_Parametricity provides command
wenzelm@68393
   799
'parametric_constant' for proving parametricity of non-recursive
wenzelm@68393
   800
definitions. For constants that are not fully parametric the command
wenzelm@68393
   801
will infer conditions on relations (e.g., bi_unique, bi_total, or type
wenzelm@68393
   802
class conditions such as "respects 0") sufficient for parametricity. See
wenzelm@68393
   803
theory HOL-ex.Conditional_Parametricity_Examples for some examples.
wenzelm@68393
   804
wenzelm@68393
   805
* Theory HOL-Library.Code_Lazy provides a new preprocessor for the code
wenzelm@68393
   806
generator to generate code for algebraic types with lazy evaluation
Andreas@68639
   807
semantics even in call-by-value target languages. See the theories
wenzelm@68647
   808
HOL-ex.Code_Lazy_Demo and HOL-Codegenerator_Test.Code_Lazy_Test for some
wenzelm@68647
   809
examples.
wenzelm@68393
   810
wenzelm@68393
   811
* Theory HOL-Library.Landau_Symbols has been moved here from AFP.
wenzelm@68393
   812
wenzelm@68393
   813
* Theory HOL-Library.Old_Datatype no longer provides the legacy command
wenzelm@68393
   814
'old_datatype'. INCOMPATIBILITY.
wenzelm@68393
   815
wenzelm@68393
   816
* Theory HOL-Computational_Algebra.Polynomial_Factorial does not provide
wenzelm@68393
   817
instances of rat, real, complex as factorial rings etc. Import
wenzelm@68393
   818
HOL-Computational_Algebra.Field_as_Ring explicitly in case of need.
wenzelm@68393
   819
INCOMPATIBILITY.
wenzelm@68393
   820
wenzelm@68393
   821
* Session HOL-Algebra: renamed (^) to [^] to avoid conflict with new
wenzelm@68393
   822
infix/prefix notation.
wenzelm@68393
   823
wenzelm@68543
   824
* Session HOL-Algebra: revamped with much new material. The set of
wenzelm@68543
   825
isomorphisms between two groups is now denoted iso rather than iso_set.
wenzelm@68543
   826
INCOMPATIBILITY.
wenzelm@68543
   827
wenzelm@68543
   828
* Session HOL-Analysis: the Arg function now respects the same interval
wenzelm@68543
   829
as Ln, namely (-pi,pi]; the old Arg function has been renamed Arg2pi.
lp15@68499
   830
INCOMPATIBILITY.
lp15@68499
   831
wenzelm@68548
   832
* Session HOL-Analysis: the functions zorder, zer_poly, porder and
wenzelm@68548
   833
pol_poly have been redefined. All related lemmas have been reworked.
wl302@68531
   834
INCOMPATIBILITY.
wl302@68531
   835
wenzelm@68393
   836
* Session HOL-Analysis: infinite products, Moebius functions, the
wenzelm@68393
   837
Riemann mapping theorem, the Vitali covering theorem,
wenzelm@68393
   838
change-of-variables results for integration and measures.
haftmann@68260
   839
wenzelm@68647
   840
* Session HOL-Real_Asymp: proof method "real_asymp" proves asymptotics
wenzelm@68647
   841
or real-valued functions (limits, "Big-O", etc.) automatically.
wenzelm@68681
   842
See also ~~/src/HOL/Real_Asymp/Manual for some documentation.
wenzelm@68647
   843
wenzelm@68545
   844
* Session HOL-Types_To_Sets: more tool support (unoverload_type combines
wenzelm@68545
   845
internalize_sorts and unoverload) and larger experimental application
wenzelm@68545
   846
(type based linear algebra transferred to linear algebra on subspaces).
immler@68522
   847
wenzelm@66651
   848
wenzelm@68116
   849
*** ML ***
wenzelm@68116
   850
wenzelm@68116
   851
* Operation Export.export emits theory exports (arbitrary blobs), which
wenzelm@69960
   852
are stored persistently in the session build database.
wenzelm@68116
   853
wenzelm@68276
   854
* Command 'ML_export' exports ML toplevel bindings to the global
wenzelm@68276
   855
bootstrap environment of the ML process. This allows ML evaluation
wenzelm@68276
   856
without a formal theory context, e.g. in command-line tools like
wenzelm@68276
   857
"isabelle process".
wenzelm@68276
   858
wenzelm@68116
   859
wenzelm@66729
   860
*** System ***
wenzelm@66729
   861
wenzelm@67088
   862
* Mac OS X 10.10 Yosemite is now the baseline version; Mavericks is no
wenzelm@67088
   863
longer supported.
wenzelm@67088
   864
wenzelm@68393
   865
* Linux and Windows/Cygwin is for x86_64 only, old 32bit platform
wenzelm@68393
   866
support has been discontinued.
wenzelm@68393
   867
wenzelm@66906
   868
* Java runtime is for x86_64 only. Corresponding Isabelle settings have
wenzelm@66906
   869
been renamed to ISABELLE_TOOL_JAVA_OPTIONS and JEDIT_JAVA_OPTIONS,
wenzelm@66906
   870
instead of former 32/64 variants. INCOMPATIBILITY.
wenzelm@66906
   871
wenzelm@68003
   872
* Old settings ISABELLE_PLATFORM and ISABELLE_WINDOWS_PLATFORM should be
wenzelm@68003
   873
phased out due to unclear preference of 32bit vs. 64bit architecture.
wenzelm@68003
   874
Explicit GNU bash expressions are now preferred, for example (with
wenzelm@68003
   875
quotes):
wenzelm@68003
   876
wenzelm@68003
   877
  #Posix executables (Unix or Cygwin), with preference for 64bit
wenzelm@68003
   878
  "${ISABELLE_PLATFORM64:-$ISABELLE_PLATFORM32}"
wenzelm@68003
   879
wenzelm@68003
   880
  #native Windows or Unix executables, with preference for 64bit
wenzelm@68003
   881
  "${ISABELLE_WINDOWS_PLATFORM64:-${ISABELLE_WINDOWS_PLATFORM32:-${ISABELLE_PLATFORM64:-$ISABELLE_PLATFORM32}}}"
wenzelm@68003
   882
wenzelm@68003
   883
  #native Windows (32bit) or Unix executables (preference for 64bit)
wenzelm@68003
   884
  "${ISABELLE_WINDOWS_PLATFORM32:-${ISABELLE_PLATFORM64:-$ISABELLE_PLATFORM32}}"
wenzelm@68003
   885
wenzelm@66745
   886
* Command-line tool "isabelle build" supports new options:
wenzelm@66745
   887
  - option -B NAME: include session NAME and all descendants
wenzelm@66745
   888
  - option -S: only observe changes of sources, not heap images
wenzelm@66841
   889
  - option -f: forces a fresh build
wenzelm@66737
   890
wenzelm@68734
   891
* Command-line tool "isabelle build" options -c -x -B refer to
wenzelm@68734
   892
descendants wrt. the session parent or import graph. Subtle
wenzelm@68734
   893
INCOMPATIBILITY: options -c -x used to refer to the session parent graph
wenzelm@68734
   894
only.
wenzelm@68734
   895
wenzelm@66843
   896
* Command-line tool "isabelle build" takes "condition" options with the
wenzelm@66843
   897
corresponding environment values into account, when determining the
wenzelm@66843
   898
up-to-date status of a session.
wenzelm@66843
   899
wenzelm@68393
   900
* The command-line tool "dump" dumps information from the cumulative
wenzelm@68393
   901
PIDE session database: many sessions may be loaded into a given logic
wenzelm@68393
   902
image, results from all loaded theories are written to the output
wenzelm@68393
   903
directory.
wenzelm@68393
   904
wenzelm@66851
   905
* Command-line tool "isabelle imports -I" also reports actual session
wenzelm@66851
   906
imports. This helps to minimize the session dependency graph.
wenzelm@66851
   907
wenzelm@69960
   908
* The command-line tool "export" and 'export_files' in session ROOT
wenzelm@69960
   909
entries retrieve theory exports from the session build database.
wenzelm@68393
   910
wenzelm@68393
   911
* The command-line tools "isabelle server" and "isabelle client" provide
wenzelm@68393
   912
access to the Isabelle Server: it supports responsive session management
wenzelm@68393
   913
and concurrent use of theories, based on Isabelle/PIDE infrastructure.
wenzelm@68393
   914
See also the "system" manual.
wenzelm@68393
   915
wenzelm@68393
   916
* The command-line tool "isabelle update_comments" normalizes formal
wenzelm@68393
   917
comments in outer syntax as follows: \<comment> \<open>text\<close> (whith a single space to
wenzelm@68393
   918
approximate the appearance in document output). This is more specific
wenzelm@68393
   919
than former "isabelle update_cartouches -c": the latter tool option has
wenzelm@68393
   920
been discontinued.
wenzelm@68393
   921
wenzelm@68393
   922
* The command-line tool "isabelle mkroot" now always produces a document
wenzelm@68393
   923
outline: its options have been adapted accordingly. INCOMPATIBILITY.
wenzelm@68393
   924
wenzelm@68393
   925
* The command-line tool "isabelle mkroot -I" initializes a Mercurial
wenzelm@68393
   926
repository for the generated session files.
wenzelm@68393
   927
wenzelm@68523
   928
* Settings ISABELLE_HEAPS + ISABELLE_BROWSER_INFO (or
wenzelm@68523
   929
ISABELLE_HEAPS_SYSTEM + ISABELLE_BROWSER_INFO_SYSTEM in "system build
wenzelm@68523
   930
mode") determine the directory locations of the main build artefacts --
wenzelm@68523
   931
instead of hard-wired directories in ISABELLE_HOME_USER (or
wenzelm@68523
   932
ISABELLE_HOME).
wenzelm@68523
   933
wenzelm@68393
   934
* Settings ISABELLE_PATH and ISABELLE_OUTPUT have been discontinued:
wenzelm@68393
   935
heap images and session databases are always stored in
wenzelm@68523
   936
$ISABELLE_HEAPS/$ML_IDENTIFIER (command-line default) or
wenzelm@68523
   937
$ISABELLE_HEAPS_SYSTEM/$ML_IDENTIFIER (main Isabelle application or
wenzelm@68393
   938
"isabelle jedit -s" or "isabelle build -s").
wenzelm@67099
   939
wenzelm@67199
   940
* ISABELLE_LATEX and ISABELLE_PDFLATEX now include platform-specific
wenzelm@67199
   941
options for improved error reporting. Potential INCOMPATIBILITY with
wenzelm@67199
   942
unusual LaTeX installations, may have to adapt these settings.
wenzelm@67199
   943
wenzelm@68393
   944
* Update to Poly/ML 5.7.1 with slightly improved performance and PIDE
wenzelm@68393
   945
markup for identifier bindings. It now uses The GNU Multiple Precision
wenzelm@67591
   946
Arithmetic Library (libgmp) on all platforms, notably Mac OS X with
wenzelm@67591
   947
32/64 bit.
wenzelm@67591
   948
wenzelm@67099
   949
wenzelm@66729
   950
wenzelm@66472
   951
New in Isabelle2017 (October 2017)
wenzelm@66472
   952
----------------------------------
wenzelm@64439
   953
wenzelm@64986
   954
*** General ***
wenzelm@64986
   955
wenzelm@66238
   956
* Experimental support for Visual Studio Code (VSCode) as alternative
wenzelm@66238
   957
Isabelle/PIDE front-end, see also
wenzelm@66599
   958
https://marketplace.visualstudio.com/items?itemName=makarius.Isabelle2017
wenzelm@66238
   959
wenzelm@66238
   960
VSCode is a new type of application that continues the concepts of
wenzelm@66238
   961
"programmer's editor" and "integrated development environment" towards
wenzelm@66238
   962
fully semantic editing and debugging -- in a relatively light-weight
wenzelm@66238
   963
manner. Thus it fits nicely on top of the Isabelle/PIDE infrastructure.
wenzelm@66238
   964
Technically, VSCode is based on the Electron application framework
wenzelm@66238
   965
(Node.js + Chromium browser + V8), which is implemented in JavaScript
wenzelm@66238
   966
and TypeScript, while Isabelle/VSCode mainly consists of Isabelle/Scala
wenzelm@66238
   967
modules around a Language Server implementation.
wenzelm@66238
   968
wenzelm@65504
   969
* Theory names are qualified by the session name that they belong to.
wenzelm@66454
   970
This affects imports, but not the theory name space prefix (which is
wenzelm@66454
   971
just the theory base name as before).
wenzelm@66454
   972
wenzelm@66454
   973
In order to import theories from other sessions, the ROOT file format
wenzelm@66454
   974
provides a new 'sessions' keyword. In contrast, a theory that is
wenzelm@66454
   975
imported in the old-fashioned manner via an explicit file-system path
wenzelm@66472
   976
belongs to the current session, and might cause theory name conflicts
wenzelm@66454
   977
later on. Theories that are imported from other sessions are excluded
wenzelm@66454
   978
from the current session document. The command-line tool "isabelle
wenzelm@66454
   979
imports" helps to update theory imports.
wenzelm@66454
   980
wenzelm@65451
   981
* The main theory entry points for some non-HOL sessions have changed,
wenzelm@65451
   982
to avoid confusion with the global name "Main" of the session HOL. This
wenzelm@65451
   983
leads to the follow renamings:
wenzelm@65451
   984
wenzelm@65451
   985
  CTT/Main.thy    ~>  CTT/CTT.thy
wenzelm@65451
   986
  ZF/Main.thy     ~>  ZF/ZF.thy
wenzelm@65451
   987
  ZF/Main_ZF.thy  ~>  ZF/ZF.thy
wenzelm@65451
   988
  ZF/Main_ZFC.thy ~>  ZF/ZFC.thy
wenzelm@65451
   989
  ZF/ZF.thy       ~>  ZF/ZF_Base.thy
wenzelm@65451
   990
wenzelm@65451
   991
INCOMPATIBILITY.
wenzelm@65451
   992
wenzelm@66472
   993
* Commands 'alias' and 'type_alias' introduce aliases for constants and
wenzelm@66472
   994
type constructors, respectively. This allows adhoc changes to name-space
wenzelm@66472
   995
accesses within global or local theory contexts, e.g. within a 'bundle'.
wenzelm@66472
   996
wenzelm@64986
   997
* Document antiquotations @{prf} and @{full_prf} output proof terms
wenzelm@64986
   998
(again) in the same way as commands 'prf' and 'full_prf'.
wenzelm@64986
   999
wenzelm@65055
  1000
* Computations generated by the code generator can be embedded directly
wenzelm@65055
  1001
into ML, alongside with @{code} antiquotations, using the following
wenzelm@65055
  1002
antiquotations:
wenzelm@65055
  1003
wenzelm@65055
  1004
  @{computation ... terms: ... datatypes: ...} :
wenzelm@65055
  1005
    ((term -> term) -> 'ml option -> 'a) -> Proof.context -> term -> 'a
wenzelm@65055
  1006
  @{computation_conv ... terms: ... datatypes: ...} :
wenzelm@65055
  1007
    (Proof.context -> 'ml -> conv) -> Proof.context -> conv
wenzelm@65045
  1008
  @{computation_check terms: ... datatypes: ...} : Proof.context -> conv
haftmann@65041
  1009
wenzelm@65055
  1010
See src/HOL/ex/Computations.thy,
wenzelm@65055
  1011
src/HOL/Decision_Procs/Commutative_Ring.thy and
wenzelm@65055
  1012
src/HOL/Decision_Procs/Reflective_Field.thy for examples and the
wenzelm@65055
  1013
tutorial on code generation.
haftmann@65041
  1014
wenzelm@64986
  1015
wenzelm@64602
  1016
*** Prover IDE -- Isabelle/Scala/jEdit ***
wenzelm@64602
  1017
wenzelm@66472
  1018
* Session-qualified theory imports allow the Prover IDE to process
wenzelm@66472
  1019
arbitrary theory hierarchies independently of the underlying logic
wenzelm@66472
  1020
session image (e.g. option "isabelle jedit -l"), but the directory
wenzelm@66472
  1021
structure needs to be known in advance (e.g. option "isabelle jedit -d"
wenzelm@66472
  1022
or a line in the file $ISABELLE_HOME_USER/ROOTS).
wenzelm@64602
  1023
wenzelm@64842
  1024
* The PIDE document model maintains file content independently of the
wenzelm@64842
  1025
status of jEdit editor buffers. Reloading jEdit buffers no longer causes
wenzelm@64842
  1026
changes of formal document content. Theory dependencies are always
wenzelm@64842
  1027
resolved internally, without the need for corresponding editor buffers.
wenzelm@64842
  1028
The system option "jedit_auto_load" has been discontinued: it is
wenzelm@64842
  1029
effectively always enabled.
wenzelm@64842
  1030
wenzelm@64867
  1031
* The Theories dockable provides a "Purge" button, in order to restrict
wenzelm@64867
  1032
the document model to theories that are required for open editor
wenzelm@64867
  1033
buffers.
wenzelm@64867
  1034
wenzelm@66424
  1035
* The Theories dockable indicates the overall status of checking of each
wenzelm@66424
  1036
entry. When all forked tasks of a theory are finished, the border is
wenzelm@66424
  1037
painted with thick lines; remaining errors in this situation are
wenzelm@66424
  1038
represented by a different border color.
wenzelm@66424
  1039
wenzelm@66472
  1040
* Automatic indentation is more careful to avoid redundant spaces in
wenzelm@66472
  1041
intermediate situations. Keywords are indented after input (via typed
wenzelm@66472
  1042
characters or completion); see also option "jedit_indent_input".
wenzelm@66472
  1043
wenzelm@66472
  1044
* Action "isabelle.preview" opens an HTML preview of the current theory
wenzelm@66472
  1045
document in the default web browser.
wenzelm@66472
  1046
wenzelm@66574
  1047
* Command-line invocation "isabelle jedit -R -l LOGIC" opens the ROOT
wenzelm@66574
  1048
entry of the specified logic session in the editor, while its parent is
wenzelm@66574
  1049
used for formal checking.
wenzelm@66472
  1050
wenzelm@66462
  1051
* The main Isabelle/jEdit plugin may be restarted manually (using the
wenzelm@66462
  1052
jEdit Plugin Manager), as long as the "Isabelle Base" plugin remains
wenzelm@66462
  1053
enabled at all times.
wenzelm@66462
  1054
wenzelm@66472
  1055
* Update to current jedit-5.4.0.
wenzelm@65329
  1056
wenzelm@64602
  1057
haftmann@66149
  1058
*** Pure ***
haftmann@66149
  1059
haftmann@66149
  1060
* Deleting the last code equations for a particular function using
haftmann@66149
  1061
[code del] results in function with no equations (runtime abort) rather
wenzelm@66472
  1062
than an unimplemented function (generation time abort). Use explicit
haftmann@66665
  1063
[[code drop:]] to enforce the latter. Minor INCOMPATIBILITY.
haftmann@66149
  1064
haftmann@66310
  1065
* Proper concept of code declarations in code.ML:
wenzelm@66472
  1066
  - Regular code declarations act only on the global theory level, being
wenzelm@66472
  1067
    ignored with warnings if syntactically malformed.
wenzelm@66472
  1068
  - Explicitly global code declarations yield errors if syntactically
wenzelm@66472
  1069
    malformed.
wenzelm@66472
  1070
  - Default code declarations are silently ignored if syntactically
wenzelm@66472
  1071
    malformed.
haftmann@66310
  1072
Minor INCOMPATIBILITY.
haftmann@66310
  1073
wenzelm@66472
  1074
* Clarified and standardized internal data bookkeeping of code
wenzelm@66472
  1075
declarations: history of serials allows to track potentially
wenzelm@66472
  1076
non-monotonous declarations appropriately. Minor INCOMPATIBILITY.
haftmann@66310
  1077
haftmann@66149
  1078
haftmann@64593
  1079
*** HOL ***
haftmann@64593
  1080
blanchet@66614
  1081
* The Nunchaku model finder is now part of "Main".
blanchet@66614
  1082
wenzelm@66472
  1083
* SMT module:
wenzelm@66472
  1084
  - A new option, 'smt_nat_as_int', has been added to translate 'nat' to
wenzelm@66472
  1085
    'int' and benefit from the SMT solver's theory reasoning. It is
wenzelm@66472
  1086
    disabled by default.
wenzelm@66472
  1087
  - The legacy module "src/HOL/Library/Old_SMT.thy" has been removed.
wenzelm@66472
  1088
  - Several small issues have been rectified in the 'smt' command.
wenzelm@66472
  1089
wenzelm@66472
  1090
* (Co)datatype package: The 'size_gen_o_map' lemma is no longer
wenzelm@66472
  1091
generated for datatypes with type class annotations. As a result, the
wenzelm@66472
  1092
tactic that derives it no longer fails on nested datatypes. Slight
wenzelm@66472
  1093
INCOMPATIBILITY.
eberlm@66450
  1094
haftmann@66345
  1095
* Command and antiquotation "value" with modified default strategy:
haftmann@66345
  1096
terms without free variables are always evaluated using plain evaluation
wenzelm@66472
  1097
only, with no fallback on normalization by evaluation. Minor
wenzelm@66472
  1098
INCOMPATIBILITY.
eberlm@65956
  1099
wenzelm@65552
  1100
* Theories "GCD" and "Binomial" are already included in "Main" (instead
wenzelm@65575
  1101
of "Complex_Main").
wenzelm@65552
  1102
haftmann@65170
  1103
* Constant "surj" is a full input/output abbreviation (again).
haftmann@65170
  1104
Minor INCOMPATIBILITY.
haftmann@65170
  1105
haftmann@64632
  1106
* Dropped aliasses RangeP, DomainP for Rangep, Domainp respectively.
haftmann@64632
  1107
INCOMPATIBILITY.
haftmann@64632
  1108
wenzelm@66472
  1109
* Renamed ii to imaginary_unit in order to free up ii as a variable
wenzelm@66472
  1110
name. The syntax \<i> remains available. INCOMPATIBILITY.
wenzelm@66472
  1111
wenzelm@66472
  1112
* Dropped abbreviations transP, antisymP, single_valuedP; use constants
wenzelm@66472
  1113
transp, antisymp, single_valuedp instead. INCOMPATIBILITY.
wenzelm@66472
  1114
wenzelm@66472
  1115
* Constant "subseq" in Topological_Spaces has been removed -- it is
wenzelm@66472
  1116
subsumed by "strict_mono". Some basic lemmas specific to "subseq" have
wenzelm@66472
  1117
been renamed accordingly, e.g. "subseq_o" -> "strict_mono_o" etc.
wenzelm@66472
  1118
wenzelm@66472
  1119
* Theory List: "sublist" renamed to "nths" in analogy with "nth", and
wenzelm@66472
  1120
"sublisteq" renamed to "subseq". Minor INCOMPATIBILITY.
wenzelm@66472
  1121
wenzelm@66472
  1122
* Theory List: new generic function "sorted_wrt".
wenzelm@66472
  1123
wenzelm@66472
  1124
* Named theorems mod_simps covers various congruence rules concerning
wenzelm@66472
  1125
mod, replacing former zmod_simps. INCOMPATIBILITY.
haftmann@64787
  1126
haftmann@64593
  1127
* Swapped orientation of congruence rules mod_add_left_eq,
haftmann@64593
  1128
mod_add_right_eq, mod_add_eq, mod_mult_left_eq, mod_mult_right_eq,
haftmann@64593
  1129
mod_mult_eq, mod_minus_eq, mod_diff_left_eq, mod_diff_right_eq,
wenzelm@66472
  1130
mod_diff_eq. INCOMPATIBILITY.
haftmann@64593
  1131
haftmann@64593
  1132
* Generalized some facts:
blanchet@64876
  1133
    measure_induct_rule
blanchet@64876
  1134
    measure_induct
haftmann@64593
  1135
    zminus_zmod ~> mod_minus_eq
haftmann@64593
  1136
    zdiff_zmod_left ~> mod_diff_left_eq
haftmann@64593
  1137
    zdiff_zmod_right ~> mod_diff_right_eq
haftmann@64593
  1138
    zmod_eq_dvd_iff ~> mod_eq_dvd_iff
haftmann@64593
  1139
INCOMPATIBILITY.
haftmann@64593
  1140
wenzelm@66472
  1141
* Algebraic type class hierarchy of euclidean (semi)rings in HOL:
wenzelm@66472
  1142
euclidean_(semi)ring, euclidean_(semi)ring_cancel,
wenzelm@66472
  1143
unique_euclidean_(semi)ring; instantiation requires provision of a
wenzelm@66472
  1144
euclidean size.
wenzelm@66472
  1145
wenzelm@66472
  1146
* Theory "HOL-Number_Theory.Euclidean_Algorithm" has been reworked:
wenzelm@66472
  1147
  - Euclidean induction is available as rule eucl_induct.
wenzelm@66472
  1148
  - Constants Euclidean_Algorithm.gcd, Euclidean_Algorithm.lcm,
wenzelm@66472
  1149
    Euclidean_Algorithm.Gcd and Euclidean_Algorithm.Lcm allow
wenzelm@66472
  1150
    easy instantiation of euclidean (semi)rings as GCD (semi)rings.
wenzelm@66472
  1151
  - Coefficients obtained by extended euclidean algorithm are
wenzelm@66472
  1152
    available as "bezout_coefficients".
wenzelm@66472
  1153
INCOMPATIBILITY.
wenzelm@66472
  1154
wenzelm@66472
  1155
* Theory "Number_Theory.Totient" introduces basic notions about Euler's
wenzelm@66472
  1156
totient function previously hidden as solitary example in theory
wenzelm@66472
  1157
Residues. Definition changed so that "totient 1 = 1" in agreement with
wenzelm@66472
  1158
the literature. Minor INCOMPATIBILITY.
wenzelm@66472
  1159
wenzelm@66542
  1160
* New styles in theory "HOL-Library.LaTeXsugar":
nipkow@66541
  1161
  - "dummy_pats" for printing equations with "_" on the lhs;
nipkow@66541
  1162
  - "eta_expand" for printing eta-expanded terms.
nipkow@66541
  1163
wenzelm@66472
  1164
* Theory "HOL-Library.Permutations": theorem bij_swap_ompose_bij has
wenzelm@66472
  1165
been renamed to bij_swap_compose_bij. INCOMPATIBILITY.
wenzelm@66472
  1166
lp15@66643
  1167
* New theory "HOL-Library.Going_To_Filter" providing the "f going_to F"
eberlm@66488
  1168
filter for describing points x such that f(x) is in the filter F.
eberlm@66488
  1169
eberlm@66480
  1170
* Theory "HOL-Library.Formal_Power_Series": constants X/E/L/F have been
eberlm@66480
  1171
renamed to fps_X/fps_exp/fps_ln/fps_hypergeo to avoid polluting the name
wenzelm@66472
  1172
space. INCOMPATIBILITY.
wenzelm@66472
  1173
wenzelm@66472
  1174
* Theory "HOL-Library.FinFun" has been moved to AFP (again).
wenzelm@66472
  1175
INCOMPATIBILITY.
wenzelm@66472
  1176
wenzelm@66472
  1177
* Theory "HOL-Library.FuncSet": some old and rarely used ASCII
wenzelm@66472
  1178
replacement syntax has been removed. INCOMPATIBILITY, standard syntax
wenzelm@66472
  1179
with symbols should be used instead. The subsequent commands help to
wenzelm@66472
  1180
reproduce the old forms, e.g. to simplify porting old theories:
wenzelm@66472
  1181
wenzelm@66472
  1182
syntax (ASCII)
wenzelm@66472
  1183
  "_PiE" :: "pttrn \<Rightarrow> 'a set \<Rightarrow> 'b set \<Rightarrow> ('a \<Rightarrow> 'b) set"  ("(3PIE _:_./ _)" 10)
wenzelm@66472
  1184
  "_Pi"  :: "pttrn \<Rightarrow> 'a set \<Rightarrow> 'b set \<Rightarrow> ('a \<Rightarrow> 'b) set"  ("(3PI _:_./ _)" 10)
wenzelm@66472
  1185
  "_lam" :: "pttrn \<Rightarrow> 'a set \<Rightarrow> 'a \<Rightarrow> 'b \<Rightarrow> ('a \<Rightarrow> 'b)"  ("(3%_:_./ _)" [0,0,3] 3)
wenzelm@66472
  1186
wenzelm@66472
  1187
* Theory "HOL-Library.Multiset": the simprocs on subsets operators of
wenzelm@66472
  1188
multisets have been renamed:
wenzelm@66472
  1189
wenzelm@66472
  1190
  msetless_cancel_numerals ~> msetsubset_cancel
wenzelm@66472
  1191
  msetle_cancel_numerals ~> msetsubset_eq_cancel
wenzelm@66472
  1192
wenzelm@66472
  1193
INCOMPATIBILITY.
wenzelm@66472
  1194
lars@66481
  1195
* Theory "HOL-Library.Pattern_Aliases" provides input and output syntax
lars@66481
  1196
for pattern aliases as known from Haskell, Scala and ML.
blanchet@65515
  1197
Andreas@66563
  1198
* Theory "HOL-Library.Uprod" formalizes the type of unordered pairs.
Andreas@66563
  1199
wenzelm@64898
  1200
* Session HOL-Analysis: more material involving arcs, paths, covering
wenzelm@66650
  1201
spaces, innessential maps, retracts, infinite products, simplicial
wenzelm@66650
  1202
complexes. Baire Category theorem. Major results include the Jordan
wenzelm@66650
  1203
Curve Theorem and the Great Picard Theorem.
wenzelm@66472
  1204
wenzelm@66472
  1205
* Session HOL-Algebra has been extended by additional lattice theory:
wenzelm@66472
  1206
the Knaster-Tarski fixed point theorem and Galois Connections.
wenzelm@66472
  1207
wenzelm@66472
  1208
* Sessions HOL-Computational_Algebra and HOL-Number_Theory: new notions
wenzelm@66472
  1209
of squarefreeness, n-th powers, and prime powers.
wenzelm@66472
  1210
wenzelm@66472
  1211
* Session "HOL-Computional_Algebra" covers many previously scattered
wenzelm@66472
  1212
theories, notably Euclidean_Algorithm, Factorial_Ring,
wenzelm@66472
  1213
Formal_Power_Series, Fraction_Field, Fundamental_Theorem_Algebra,
wenzelm@66472
  1214
Normalized_Fraction, Polynomial_FPS, Polynomial, Primes. Minor
wenzelm@66472
  1215
INCOMPATIBILITY.
Mathias@65027
  1216
wenzelm@60331
  1217
wenzelm@64844
  1218
*** System ***
wenzelm@64844
  1219
wenzelm@66474
  1220
* Isabelle/Scala: the SQL module supports access to relational
wenzelm@66474
  1221
databases, either as plain file (SQLite) or full-scale server
wenzelm@66474
  1222
(PostgreSQL via local port or remote ssh connection).
wenzelm@66474
  1223
wenzelm@66474
  1224
* Results of "isabelle build" are recorded as SQLite database (i.e.
wenzelm@66474
  1225
"Application File Format" in the sense of
wenzelm@66474
  1226
https://www.sqlite.org/appfileformat.html). This allows systematic
wenzelm@66474
  1227
access via operations from module Sessions.Store in Isabelle/Scala.
wenzelm@66474
  1228
wenzelm@66472
  1229
* System option "parallel_proofs" is 1 by default (instead of more
wenzelm@66472
  1230
aggressive 2). This requires less heap space and avoids burning parallel
wenzelm@66472
  1231
CPU cycles, while full subproof parallelization is enabled for repeated
wenzelm@66472
  1232
builds (according to parallel_subproofs_threshold).
wenzelm@65072
  1233
wenzelm@65448
  1234
* System option "record_proofs" allows to change the global
wenzelm@65448
  1235
Proofterm.proofs variable for a session. Regular values are are 0, 1, 2;
wenzelm@65448
  1236
a negative value means the current state in the ML heap image remains
wenzelm@65448
  1237
unchanged.
wenzelm@65448
  1238
wenzelm@66472
  1239
* Isabelle settings variable ISABELLE_SCALA_BUILD_OPTIONS has been
wenzelm@66472
  1240
renamed to ISABELLE_SCALAC_OPTIONS. Rare INCOMPATIBILITY.
wenzelm@66472
  1241
wenzelm@66472
  1242
* Isabelle settings variables ISABELLE_WINDOWS_PLATFORM,
wenzelm@66472
  1243
ISABELLE_WINDOWS_PLATFORM32, ISABELLE_WINDOWS_PLATFORM64 indicate the
wenzelm@66472
  1244
native Windows platform (independently of the Cygwin installation). This
wenzelm@66472
  1245
is analogous to ISABELLE_PLATFORM, ISABELLE_PLATFORM32,
wenzelm@66472
  1246
ISABELLE_PLATFORM64.
wenzelm@65557
  1247
wenzelm@66786
  1248
* Command-line tool "isabelle build_docker" builds a Docker image from
wenzelm@66786
  1249
the Isabelle application bundle for Linux. See also
wenzelm@66786
  1250
https://hub.docker.com/r/makarius/isabelle
wenzelm@66786
  1251
wenzelm@66473
  1252
* Command-line tool "isabelle vscode_server" provides a Language Server
wenzelm@66473
  1253
Protocol implementation, e.g. for the Visual Studio Code editor. It
wenzelm@66473
  1254
serves as example for alternative PIDE front-ends.
wenzelm@66473
  1255
wenzelm@66472
  1256
* Command-line tool "isabelle imports" helps to maintain theory imports
wenzelm@66671
  1257
wrt. session structure. Examples for the main Isabelle distribution:
wenzelm@66472
  1258
wenzelm@66472
  1259
  isabelle imports -I -a
wenzelm@66472
  1260
  isabelle imports -U -a
wenzelm@66472
  1261
  isabelle imports -U -i -a
wenzelm@66472
  1262
  isabelle imports -M -a -d '~~/src/Benchmarks'
wenzelm@66472
  1263
wenzelm@64844
  1264
wenzelm@67099
  1265
wenzelm@64072
  1266
New in Isabelle2016-1 (December 2016)
wenzelm@64072
  1267
-------------------------------------
wenzelm@62216
  1268
wenzelm@62440
  1269
*** General ***
wenzelm@62440
  1270
wenzelm@64390
  1271
* Splitter in proof methods "simp", "auto" and friends:
wenzelm@64390
  1272
  - The syntax "split add" has been discontinued, use plain "split",
wenzelm@64390
  1273
    INCOMPATIBILITY.
wenzelm@64390
  1274
  - For situations with many conditional or case expressions, there is
wenzelm@64390
  1275
    an alternative splitting strategy that can be much faster. It is
wenzelm@64390
  1276
    selected by writing "split!" instead of "split". It applies safe
wenzelm@64390
  1277
    introduction and elimination rules after each split rule. As a
wenzelm@64390
  1278
    result the subgoal may be split into several subgoals.
wenzelm@64390
  1279
wenzelm@63273
  1280
* Command 'bundle' provides a local theory target to define a bundle
wenzelm@63273
  1281
from the body of specification commands (such as 'declare',
wenzelm@63273
  1282
'declaration', 'notation', 'lemmas', 'lemma'). For example:
wenzelm@63273
  1283
wenzelm@63273
  1284
bundle foo
wenzelm@63273
  1285
begin
wenzelm@63273
  1286
  declare a [simp]
wenzelm@63273
  1287
  declare b [intro]
wenzelm@63273
  1288
end
wenzelm@63272
  1289
wenzelm@63282
  1290
* Command 'unbundle' is like 'include', but works within a local theory
wenzelm@63282
  1291
context. Unlike "context includes ... begin", the effect of 'unbundle'
wenzelm@63282
  1292
on the target context persists, until different declarations are given.
wenzelm@63282
  1293
wenzelm@63977
  1294
* Simplified outer syntax: uniform category "name" includes long
wenzelm@63977
  1295
identifiers. Former "xname" / "nameref" / "name reference" has been
wenzelm@63977
  1296
discontinued.
wenzelm@63977
  1297
wenzelm@63977
  1298
* Embedded content (e.g. the inner syntax of types, terms, props) may be
wenzelm@63977
  1299
delimited uniformly via cartouches. This works better than old-fashioned
wenzelm@63977
  1300
quotes when sub-languages are nested.
wenzelm@63977
  1301
wenzelm@63977
  1302
* Mixfix annotations support general block properties, with syntax
wenzelm@63977
  1303
"(\<open>x=a y=b z \<dots>\<close>". Notable property names are "indent", "consistent",
wenzelm@63977
  1304
"unbreakable", "markup". The existing notation "(DIGITS" is equivalent
wenzelm@63977
  1305
to "(\<open>indent=DIGITS\<close>". The former notation "(00" for unbreakable blocks
wenzelm@63977
  1306
is superseded by "(\<open>unbreabable\<close>" --- rare INCOMPATIBILITY.
nipkow@63650
  1307
wenzelm@63383
  1308
* Proof method "blast" is more robust wrt. corner cases of Pure
wenzelm@63383
  1309
statements without object-logic judgment.
wenzelm@63383
  1310
wenzelm@63624
  1311
* Commands 'prf' and 'full_prf' are somewhat more informative (again):
wenzelm@63977
  1312
proof terms are reconstructed and cleaned from administrative thm nodes.
wenzelm@63977
  1313
wenzelm@63977
  1314
* Code generator: config option "code_timing" triggers measurements of
wenzelm@63977
  1315
different phases of code generation. See src/HOL/ex/Code_Timing.thy for
wenzelm@63977
  1316
examples.
wenzelm@63977
  1317
wenzelm@63977
  1318
* Code generator: implicits in Scala (stemming from type class
wenzelm@63977
  1319
instances) are generated into companion object of corresponding type
wenzelm@63977
  1320
class, to resolve some situations where ambiguities may occur.
wenzelm@63977
  1321
wenzelm@64390
  1322
* Solve direct: option "solve_direct_strict_warnings" gives explicit
wenzelm@64390
  1323
warnings for lemma statements with trivial proofs.
haftmann@64013
  1324
wenzelm@64602
  1325
wenzelm@62904
  1326
*** Prover IDE -- Isabelle/Scala/jEdit ***
wenzelm@62904
  1327
wenzelm@64527
  1328
* More aggressive flushing of machine-generated input, according to
wenzelm@64527
  1329
system option editor_generated_input_delay (in addition to existing
wenzelm@64527
  1330
editor_input_delay for regular user edits). This may affect overall PIDE
wenzelm@64527
  1331
reactivity and CPU usage.
wenzelm@64527
  1332
wenzelm@64390
  1333
* Syntactic indentation according to Isabelle outer syntax. Action
wenzelm@64390
  1334
"indent-lines" (shortcut C+i) indents the current line according to
wenzelm@64390
  1335
command keywords and some command substructure. Action
wenzelm@64390
  1336
"isabelle.newline" (shortcut ENTER) indents the old and the new line
wenzelm@64390
  1337
according to command keywords only; see also option
wenzelm@64390
  1338
"jedit_indent_newline".
wenzelm@64390
  1339
wenzelm@64390
  1340
* Semantic indentation for unstructured proof scripts ('apply' etc.) via
wenzelm@64390
  1341
number of subgoals. This requires information of ongoing document
wenzelm@64390
  1342
processing and may thus lag behind, when the user is editing too
wenzelm@64390
  1343
quickly; see also option "jedit_script_indent" and
wenzelm@64390
  1344
"jedit_script_indent_limit".
wenzelm@64390
  1345
wenzelm@64390
  1346
* Refined folding mode "isabelle" based on Isar syntax: 'next' and 'qed'
wenzelm@64390
  1347
are treated as delimiters for fold structure; 'begin' and 'end'
wenzelm@64390
  1348
structure of theory specifications is treated as well.
wenzelm@64390
  1349
wenzelm@64390
  1350
* Command 'proof' provides information about proof outline with cases,
wenzelm@64390
  1351
e.g. for proof methods "cases", "induct", "goal_cases".
wenzelm@64390
  1352
wenzelm@64390
  1353
* Completion templates for commands involving "begin ... end" blocks,
wenzelm@64390
  1354
e.g. 'context', 'notepad'.
wenzelm@64390
  1355
wenzelm@64390
  1356
* Sidekick parser "isabelle-context" shows nesting of context blocks
wenzelm@64390
  1357
according to 'begin' and 'end' structure.
wenzelm@64390
  1358
wenzelm@63977
  1359
* Highlighting of entity def/ref positions wrt. cursor.
wenzelm@63977
  1360
wenzelm@63977
  1361
* Action "isabelle.select-entity" (shortcut CS+ENTER) selects all
wenzelm@64514
  1362
occurrences of the formal entity at the caret position. This facilitates
wenzelm@63977
  1363
systematic renaming.
wenzelm@63977
  1364
wenzelm@63977
  1365
* PIDE document markup works across multiple Isar commands, e.g. the
wenzelm@63977
  1366
results established at the end of a proof are properly identified in the
wenzelm@63977
  1367
theorem statement.
wenzelm@63977
  1368
wenzelm@63977
  1369
* Cartouche abbreviations work both for " and ` to accomodate typical
wenzelm@63977
  1370
situations where old ASCII notation may be updated.
wenzelm@63977
  1371
wenzelm@63875
  1372
* Dockable window "Symbols" also provides access to 'abbrevs' from the
wenzelm@63875
  1373
outer syntax of the current theory buffer. This provides clickable
wenzelm@63875
  1374
syntax templates, including entries with empty abbrevs name (which are
wenzelm@63875
  1375
inaccessible via keyboard completion).
wenzelm@63875
  1376
wenzelm@63022
  1377
* IDE support for the Isabelle/Pure bootstrap process, with the
wenzelm@63022
  1378
following independent stages:
wenzelm@63022
  1379
wenzelm@63022
  1380
  src/Pure/ROOT0.ML
wenzelm@63022
  1381
  src/Pure/ROOT.ML
wenzelm@63022
  1382
  src/Pure/Pure.thy
wenzelm@63022
  1383
  src/Pure/ML_Bootstrap.thy
wenzelm@63022
  1384
wenzelm@63022
  1385
The ML ROOT files act like quasi-theories in the context of theory
wenzelm@63022
  1386
ML_Bootstrap: this allows continuous checking of all loaded ML files.
wenzelm@63022
  1387
The theory files are presented with a modified header to import Pure
wenzelm@63022
  1388
from the running Isabelle instance. Results from changed versions of
wenzelm@63022
  1389
each stage are *not* propagated to the next stage, and isolated from the
wenzelm@63022
  1390
actual Isabelle/Pure that runs the IDE itself. The sequential
wenzelm@63307
  1391
dependencies of the above files are only observed for batch build.
wenzelm@62904
  1392
wenzelm@63977
  1393
* Isabelle/ML and Standard ML files are presented in Sidekick with the
wenzelm@63977
  1394
tree structure of section headings: this special comment format is
wenzelm@63977
  1395
described in "implementation" chapter 0, e.g. (*** section ***).
wenzelm@63461
  1396
wenzelm@63581
  1397
* Additional abbreviations for syntactic completion may be specified
wenzelm@63871
  1398
within the theory header as 'abbrevs'. The theory syntax for 'keywords'
wenzelm@63871
  1399
has been simplified accordingly: optional abbrevs need to go into the
wenzelm@63871
  1400
new 'abbrevs' section.
wenzelm@63871
  1401
wenzelm@63871
  1402
* Global abbreviations via $ISABELLE_HOME/etc/abbrevs and
wenzelm@63871
  1403
$ISABELLE_HOME_USER/etc/abbrevs are no longer supported. Minor
wenzelm@63871
  1404
INCOMPATIBILITY, use 'abbrevs' within theory header instead.
wenzelm@63579
  1405
wenzelm@64390
  1406
* Action "isabelle.keymap-merge" asks the user to resolve pending
wenzelm@64390
  1407
Isabelle keymap changes that are in conflict with the current jEdit
wenzelm@64390
  1408
keymap; non-conflicting changes are always applied implicitly. This
wenzelm@64390
  1409
action is automatically invoked on Isabelle/jEdit startup and thus
wenzelm@64390
  1410
increases chances that users see new keyboard shortcuts when re-using
wenzelm@64390
  1411
old keymaps.
wenzelm@64390
  1412
wenzelm@63675
  1413
* ML and document antiquotations for file-systems paths are more uniform
wenzelm@63675
  1414
and diverse:
wenzelm@63675
  1415
wenzelm@63675
  1416
  @{path NAME}   -- no file-system check
wenzelm@63675
  1417
  @{file NAME}   -- check for plain file
wenzelm@63675
  1418
  @{dir NAME}    -- check for directory
wenzelm@63675
  1419
wenzelm@63675
  1420
Minor INCOMPATIBILITY, former uses of @{file} and @{file_unchecked} may
wenzelm@63675
  1421
have to be changed.
wenzelm@63669
  1422
wenzelm@63669
  1423
wenzelm@63977
  1424
*** Document preparation ***
wenzelm@63977
  1425
wenzelm@63977
  1426
* New symbol \<circle>, e.g. for temporal operator.
wenzelm@63977
  1427
wenzelm@64073
  1428
* New document and ML antiquotation @{locale} for locales, similar to
wenzelm@64073
  1429
existing antiquotation @{class}.
wenzelm@64073
  1430
wenzelm@63977
  1431
* Mixfix annotations support delimiters like \<^control>\<open>cartouche\<close> --
wenzelm@63977
  1432
this allows special forms of document output.
wenzelm@63977
  1433
wenzelm@63977
  1434
* Raw LaTeX output now works via \<^latex>\<open>...\<close> instead of raw control
wenzelm@63977
  1435
symbol \<^raw:...>. INCOMPATIBILITY, notably for LaTeXsugar.thy and its
wenzelm@63977
  1436
derivatives.
wenzelm@63977
  1437
wenzelm@63977
  1438
* \<^raw:...> symbols are no longer supported.
wenzelm@63977
  1439
wenzelm@63977
  1440
* Old 'header' command is no longer supported (legacy since
wenzelm@63977
  1441
Isabelle2015).
wenzelm@63977
  1442
wenzelm@63977
  1443
wenzelm@62312
  1444
*** Isar ***
wenzelm@62312
  1445
wenzelm@63180
  1446
* Many specification elements support structured statements with 'if' /
wenzelm@63180
  1447
'for' eigen-context, e.g. 'axiomatization', 'abbreviation',
wenzelm@63180
  1448
'definition', 'inductive', 'function'.
wenzelm@63180
  1449
wenzelm@63094
  1450
* Toplevel theorem statements support eigen-context notation with 'if' /
wenzelm@63284
  1451
'for' (in postfix), which corresponds to 'assumes' / 'fixes' in the
wenzelm@63094
  1452
traditional long statement form (in prefix). Local premises are called
wenzelm@63094
  1453
"that" or "assms", respectively. Empty premises are *not* bound in the
wenzelm@63094
  1454
context: INCOMPATIBILITY.
wenzelm@63094
  1455
wenzelm@63039
  1456
* Command 'define' introduces a local (non-polymorphic) definition, with
wenzelm@63039
  1457
optional abstraction over local parameters. The syntax resembles
wenzelm@63043
  1458
'definition' and 'obtain'. It fits better into the Isar language than
wenzelm@63043
  1459
old 'def', which is now a legacy feature.
wenzelm@63039
  1460
wenzelm@63059
  1461
* Command 'obtain' supports structured statements with 'if' / 'for'
wenzelm@63059
  1462
context.
wenzelm@63059
  1463
wenzelm@62312
  1464
* Command '\<proof>' is an alias for 'sorry', with different
wenzelm@62312
  1465
typesetting. E.g. to produce proof holes in examples and documentation.
wenzelm@62216
  1466
wenzelm@63977
  1467
* The defining position of a literal fact \<open>prop\<close> is maintained more
wenzelm@63977
  1468
carefully, and made accessible as hyperlink in the Prover IDE.
wenzelm@63977
  1469
wenzelm@63977
  1470
* Commands 'finally' and 'ultimately' used to expose the result as
wenzelm@63977
  1471
literal fact: this accidental behaviour has been discontinued. Rare
wenzelm@63977
  1472
INCOMPATIBILITY, use more explicit means to refer to facts in Isar.
wenzelm@63977
  1473
wenzelm@63977
  1474
* Command 'axiomatization' has become more restrictive to correspond
wenzelm@63977
  1475
better to internal axioms as singleton facts with mandatory name. Minor
wenzelm@63977
  1476
INCOMPATIBILITY.
wenzelm@62939
  1477
wenzelm@63259
  1478
* Proof methods may refer to the main facts via the dynamic fact
wenzelm@63259
  1479
"method_facts". This is particularly useful for Eisbach method
wenzelm@63259
  1480
definitions.
wenzelm@63259
  1481
wenzelm@63527
  1482
* Proof method "use" allows to modify the main facts of a given method
wenzelm@63527
  1483
expression, e.g.
wenzelm@63259
  1484
wenzelm@63259
  1485
  (use facts in simp)
wenzelm@63259
  1486
  (use facts in \<open>simp add: ...\<close>)
wenzelm@63259
  1487
wenzelm@63977
  1488
* The old proof method "default" has been removed (legacy since
wenzelm@63977
  1489
Isabelle2016). INCOMPATIBILITY, use "standard" instead.
wenzelm@63977
  1490
wenzelm@62216
  1491
haftmann@63165
  1492
*** Pure ***
haftmann@63165
  1493
wenzelm@63977
  1494
* Pure provides basic versions of proof methods "simp" and "simp_all"
wenzelm@63977
  1495
that only know about meta-equality (==). Potential INCOMPATIBILITY in
wenzelm@63977
  1496
theory imports that merge Pure with e.g. Main of Isabelle/HOL: the order
wenzelm@63977
  1497
is relevant to avoid confusion of Pure.simp vs. HOL.simp.
wenzelm@63977
  1498
wenzelm@63977
  1499
* The command 'unfolding' and proof method "unfold" include a second
wenzelm@63977
  1500
stage where given equations are passed through the attribute "abs_def"
wenzelm@63977
  1501
before rewriting. This ensures that definitions are fully expanded,
wenzelm@63977
  1502
regardless of the actual parameters that are provided. Rare
wenzelm@63977
  1503
INCOMPATIBILITY in some corner cases: use proof method (simp only:)
wenzelm@63977
  1504
instead, or declare [[unfold_abs_def = false]] in the proof context.
wenzelm@63977
  1505
wenzelm@63977
  1506
* Type-inference improves sorts of newly introduced type variables for
wenzelm@63977
  1507
the object-logic, using its base sort (i.e. HOL.type for Isabelle/HOL).
wenzelm@63977
  1508
Thus terms like "f x" or "\<And>x. P x" without any further syntactic context
wenzelm@63977
  1509
produce x::'a::type in HOL instead of x::'a::{} in Pure. Rare
wenzelm@63977
  1510
INCOMPATIBILITY, need to provide explicit type constraints for Pure
wenzelm@63977
  1511
types where this is really intended.
haftmann@63350
  1512
haftmann@63165
  1513
blanchet@62327
  1514
*** HOL ***
blanchet@62327
  1515
wenzelm@63977
  1516
* New proof method "argo" using the built-in Argo solver based on SMT
wenzelm@63977
  1517
technology. The method can be used to prove goals of quantifier-free
wenzelm@63977
  1518
propositional logic, goals based on a combination of quantifier-free
wenzelm@63977
  1519
propositional logic with equality, and goals based on a combination of
wenzelm@63977
  1520
quantifier-free propositional logic with linear real arithmetic
wenzelm@63977
  1521
including min/max/abs. See HOL/ex/Argo_Examples.thy for examples.
wenzelm@63977
  1522
blanchet@66614
  1523
* The new "nunchaku" command integrates the Nunchaku model finder. The
wenzelm@64390
  1524
tool is experimental. See ~~/src/HOL/Nunchaku/Nunchaku.thy for details.
wenzelm@64390
  1525
wenzelm@63977
  1526
* Metis: The problem encoding has changed very slightly. This might
blanchet@63785
  1527
break existing proofs. INCOMPATIBILITY.
blanchet@63785
  1528
blanchet@63116
  1529
* Sledgehammer:
lp15@63967
  1530
  - The MaSh relevance filter is now faster than before.
blanchet@63116
  1531
  - Produce syntactically correct Vampire 4.0 problem files.
blanchet@63116
  1532
blanchet@62327
  1533
* (Co)datatype package:
blanchet@62693
  1534
  - New commands for defining corecursive functions and reasoning about
blanchet@62693
  1535
    them in "~~/src/HOL/Library/BNF_Corec.thy": 'corec', 'corecursive',
blanchet@62693
  1536
    'friend_of_corec', and 'corecursion_upto'; and 'corec_unique' proof
blanchet@62842
  1537
    method. See 'isabelle doc corec'.
wenzelm@63977
  1538
  - The predicator :: ('a \<Rightarrow> bool) \<Rightarrow> 'a F \<Rightarrow> bool is now a first-class
blanchet@63855
  1539
    citizen in bounded natural functors.
blanchet@62693
  1540
  - 'primrec' now allows nested calls through the predicator in addition
blanchet@62327
  1541
    to the map function.
blanchet@63855
  1542
  - 'bnf' automatically discharges reflexive proof obligations.
blanchet@62693
  1543
  - 'bnf' outputs a slightly modified proof obligation expressing rel in
traytel@62332
  1544
       terms of map and set
blanchet@63855
  1545
       (not giving a specification for rel makes this one reflexive).
blanchet@62693
  1546
  - 'bnf' outputs a new proof obligation expressing pred in terms of set
blanchet@63855
  1547
       (not giving a specification for pred makes this one reflexive).
blanchet@63855
  1548
    INCOMPATIBILITY: manual 'bnf' declarations may need adjustment.
blanchet@62335
  1549
  - Renamed lemmas:
blanchet@62335
  1550
      rel_prod_apply ~> rel_prod_inject
blanchet@62335
  1551
      pred_prod_apply ~> pred_prod_inject
blanchet@62335
  1552
    INCOMPATIBILITY.
blanchet@62536
  1553
  - The "size" plugin has been made compatible again with locales.
blanchet@63855
  1554
  - The theorems about "rel" and "set" may have a slightly different (but
blanchet@63855
  1555
    equivalent) form.
blanchet@63855
  1556
    INCOMPATIBILITY.
blanchet@62327
  1557
wenzelm@63977
  1558
* The 'coinductive' command produces a proper coinduction rule for
wenzelm@63977
  1559
mutual coinductive predicates. This new rule replaces the old rule,
wenzelm@63977
  1560
which exposed details of the internal fixpoint construction and was
wenzelm@63977
  1561
hard to use. INCOMPATIBILITY.
wenzelm@63977
  1562
wenzelm@63977
  1563
* New abbreviations for negated existence (but not bounded existence):
wenzelm@63977
  1564
wenzelm@63977
  1565
  \<nexists>x. P x \<equiv> \<not> (\<exists>x. P x)
wenzelm@63977
  1566
  \<nexists>!x. P x \<equiv> \<not> (\<exists>!x. P x)
wenzelm@63977
  1567
wenzelm@63977
  1568
* The print mode "HOL" for ASCII syntax of binders "!", "?", "?!", "@"
wenzelm@63977
  1569
has been removed for output. It is retained for input only, until it is
wenzelm@63977
  1570
eliminated altogether.
wenzelm@63977
  1571
wenzelm@63977
  1572
* The unique existence quantifier no longer provides 'binder' syntax,
wenzelm@63977
  1573
but uses syntax translations (as for bounded unique existence). Thus
wenzelm@63977
  1574
iterated quantification \<exists>!x y. P x y with its slightly confusing
wenzelm@63977
  1575
sequential meaning \<exists>!x. \<exists>!y. P x y is no longer possible. Instead,
wenzelm@63977
  1576
pattern abstraction admits simultaneous unique existence \<exists>!(x, y). P x y
wenzelm@63977
  1577
(analogous to existing notation \<exists>!(x, y)\<in>A. P x y). Potential
wenzelm@63977
  1578
INCOMPATIBILITY in rare situations.
wenzelm@63977
  1579
wenzelm@63977
  1580
* Conventional syntax "%(). t" for unit abstractions. Slight syntactic
wenzelm@63977
  1581
INCOMPATIBILITY.
wenzelm@63977
  1582
wenzelm@64390
  1583
* Renamed constants and corresponding theorems:
wenzelm@64390
  1584
wenzelm@64390
  1585
    setsum ~> sum
wenzelm@64390
  1586
    setprod ~> prod
wenzelm@64390
  1587
    listsum ~> sum_list
wenzelm@64390
  1588
    listprod ~> prod_list
wenzelm@64390
  1589
wenzelm@64390
  1590
INCOMPATIBILITY.
wenzelm@64390
  1591
wenzelm@64390
  1592
* Sligthly more standardized theorem names:
wenzelm@64390
  1593
    sgn_times ~> sgn_mult
wenzelm@64390
  1594
    sgn_mult' ~> Real_Vector_Spaces.sgn_mult
wenzelm@64390
  1595
    divide_zero_left ~> div_0
wenzelm@64390
  1596
    zero_mod_left ~> mod_0
wenzelm@64390
  1597
    divide_zero ~> div_by_0
wenzelm@64390
  1598
    divide_1 ~> div_by_1
wenzelm@64390
  1599
    nonzero_mult_divide_cancel_left ~> nonzero_mult_div_cancel_left
wenzelm@64390
  1600
    div_mult_self1_is_id ~> nonzero_mult_div_cancel_left
wenzelm@64390
  1601
    nonzero_mult_divide_cancel_right ~> nonzero_mult_div_cancel_right
wenzelm@64390
  1602
    div_mult_self2_is_id ~> nonzero_mult_div_cancel_right
wenzelm@64390
  1603
    is_unit_divide_mult_cancel_left ~> is_unit_div_mult_cancel_left
wenzelm@64390
  1604
    is_unit_divide_mult_cancel_right ~> is_unit_div_mult_cancel_right
wenzelm@64390
  1605
    mod_div_equality ~> div_mult_mod_eq
wenzelm@64390
  1606
    mod_div_equality2 ~> mult_div_mod_eq
wenzelm@64390
  1607
    mod_div_equality3 ~> mod_div_mult_eq
wenzelm@64390
  1608
    mod_div_equality4 ~> mod_mult_div_eq
wenzelm@64390
  1609
    minus_div_eq_mod ~> minus_div_mult_eq_mod
wenzelm@64390
  1610
    minus_div_eq_mod2 ~> minus_mult_div_eq_mod
wenzelm@64390
  1611
    minus_mod_eq_div ~> minus_mod_eq_div_mult
wenzelm@64390
  1612
    minus_mod_eq_div2 ~> minus_mod_eq_mult_div
wenzelm@64390
  1613
    div_mod_equality' ~> minus_mod_eq_div_mult [symmetric]
wenzelm@64390
  1614
    mod_div_equality' ~> minus_div_mult_eq_mod [symmetric]
wenzelm@64390
  1615
    zmod_zdiv_equality ~> mult_div_mod_eq [symmetric]
wenzelm@64390
  1616
    zmod_zdiv_equality' ~> minus_div_mult_eq_mod [symmetric]
wenzelm@64390
  1617
    Divides.mult_div_cancel ~> minus_mod_eq_mult_div [symmetric]
wenzelm@64390
  1618
    mult_div_cancel ~> minus_mod_eq_mult_div [symmetric]
wenzelm@64390
  1619
    zmult_div_cancel ~> minus_mod_eq_mult_div [symmetric]
wenzelm@64390
  1620
    div_1 ~> div_by_Suc_0
wenzelm@64390
  1621
    mod_1 ~> mod_by_Suc_0
wenzelm@64390
  1622
INCOMPATIBILITY.
wenzelm@64390
  1623
wenzelm@64390
  1624
* New type class "idom_abs_sgn" specifies algebraic properties
wenzelm@64390
  1625
of sign and absolute value functions.  Type class "sgn_if" has
wenzelm@64390
  1626
disappeared.  Slight INCOMPATIBILITY.
wenzelm@64390
  1627
wenzelm@64390
  1628
* Dedicated syntax LENGTH('a) for length of types.
wenzelm@64390
  1629
wenzelm@63977
  1630
* Characters (type char) are modelled as finite algebraic type
wenzelm@63977
  1631
corresponding to {0..255}.
wenzelm@63977
  1632
wenzelm@63977
  1633
  - Logical representation:
wenzelm@63977
  1634
    * 0 is instantiated to the ASCII zero character.
wenzelm@63977
  1635
    * All other characters are represented as "Char n"
wenzelm@63977
  1636
      with n being a raw numeral expression less than 256.
wenzelm@63977
  1637
    * Expressions of the form "Char n" with n greater than 255
wenzelm@63977
  1638
      are non-canonical.
wenzelm@63977
  1639
  - Printing and parsing:
wenzelm@63977
  1640
    * Printable characters are printed and parsed as "CHR ''\<dots>''"
wenzelm@63977
  1641
      (as before).
wenzelm@63977
  1642
    * The ASCII zero character is printed and parsed as "0".
wenzelm@63977
  1643
    * All other canonical characters are printed as "CHR 0xXX"
wenzelm@63977
  1644
      with XX being the hexadecimal character code.  "CHR n"
wenzelm@63977
  1645
      is parsable for every numeral expression n.
wenzelm@63977
  1646
    * Non-canonical characters have no special syntax and are
wenzelm@63977
  1647
      printed as their logical representation.
wenzelm@63977
  1648
  - Explicit conversions from and to the natural numbers are
wenzelm@63977
  1649
    provided as char_of_nat, nat_of_char (as before).
wenzelm@63977
  1650
  - The auxiliary nibble type has been discontinued.
wenzelm@63977
  1651
wenzelm@63977
  1652
INCOMPATIBILITY.
wenzelm@63977
  1653
wenzelm@63977
  1654
* Type class "div" with operation "mod" renamed to type class "modulo"
wenzelm@63977
  1655
with operation "modulo", analogously to type class "divide". This
wenzelm@63977
  1656
eliminates the need to qualify any of those names in the presence of
wenzelm@63977
  1657
infix "mod" syntax. INCOMPATIBILITY.
wenzelm@63977
  1658
wenzelm@63979
  1659
* Statements and proofs of Knaster-Tarski fixpoint combinators lfp/gfp
wenzelm@63979
  1660
have been clarified. The fixpoint properties are lfp_fixpoint, its
wenzelm@63979
  1661
symmetric lfp_unfold (as before), and the duals for gfp. Auxiliary items
wenzelm@63979
  1662
for the proof (lfp_lemma2 etc.) are no longer exported, but can be
wenzelm@63979
  1663
easily recovered by composition with eq_refl. Minor INCOMPATIBILITY.
wenzelm@63979
  1664
wenzelm@63977
  1665
* Constant "surj" is a mere input abbreviation, to avoid hiding an
wenzelm@63977
  1666
equation in term output. Minor INCOMPATIBILITY.
wenzelm@63977
  1667
wenzelm@63977
  1668
* Command 'code_reflect' accepts empty constructor lists for datatypes,
wenzelm@63977
  1669
which renders those abstract effectively.
wenzelm@63977
  1670
wenzelm@63977
  1671
* Command 'export_code' checks given constants for abstraction
wenzelm@63977
  1672
violations: a small guarantee that given constants specify a safe
wenzelm@63977
  1673
interface for the generated code.
wenzelm@63977
  1674
wenzelm@63977
  1675
* Code generation for Scala: ambiguous implicts in class diagrams are
wenzelm@63977
  1676
spelt out explicitly.
wenzelm@63977
  1677
wenzelm@63977
  1678
* Static evaluators (Code_Evaluation.static_* in Isabelle/ML) rely on
wenzelm@63977
  1679
explicitly provided auxiliary definitions for required type class
wenzelm@64390
  1680
dictionaries rather than half-working magic. INCOMPATIBILITY, see the
wenzelm@64390
  1681
tutorial on code generation for details.
wenzelm@64390
  1682
wenzelm@64390
  1683
* Theory Set_Interval: substantial new theorems on indexed sums and
wenzelm@64390
  1684
products.
wenzelm@63977
  1685
wenzelm@63977
  1686
* Locale bijection establishes convenient default simp rules such as
wenzelm@63977
  1687
"inv f (f a) = a" for total bijections.
wenzelm@63977
  1688
wenzelm@63977
  1689
* Abstract locales semigroup, abel_semigroup, semilattice,
wenzelm@63977
  1690
semilattice_neutr, ordering, ordering_top, semilattice_order,
wenzelm@63977
  1691
semilattice_neutr_order, comm_monoid_set, semilattice_set,
wenzelm@63977
  1692
semilattice_neutr_set, semilattice_order_set,
wenzelm@63977
  1693
semilattice_order_neutr_set monoid_list, comm_monoid_list,
wenzelm@63977
  1694
comm_monoid_list_set, comm_monoid_mset, comm_monoid_fun use boldified
wenzelm@63977
  1695
syntax uniformly that does not clash with corresponding global syntax.
wenzelm@63977
  1696
INCOMPATIBILITY.
wenzelm@63977
  1697
wenzelm@63977
  1698
* Former locale lifting_syntax is now a bundle, which is easier to
wenzelm@63977
  1699
include in a local context or theorem statement, e.g. "context includes
wenzelm@63977
  1700
lifting_syntax begin ... end". Minor INCOMPATIBILITY.
wenzelm@63977
  1701
wenzelm@63807
  1702
* Some old / obsolete theorems have been renamed / removed, potential
wenzelm@63807
  1703
INCOMPATIBILITY.
wenzelm@63807
  1704
wenzelm@63807
  1705
  nat_less_cases  --  removed, use linorder_cases instead
wenzelm@63807
  1706
  inv_image_comp  --  removed, use image_inv_f_f instead
wenzelm@63807
  1707
  image_surj_f_inv_f  ~>  image_f_inv_f
wenzelm@63113
  1708
Mathias@63456
  1709
* Some theorems about groups and orders have been generalised from
Mathias@63456
  1710
  groups to semi-groups that are also monoids:
Mathias@63456
  1711
    le_add_same_cancel1
Mathias@63456
  1712
    le_add_same_cancel2
Mathias@63456
  1713
    less_add_same_cancel1
Mathias@63456
  1714
    less_add_same_cancel2
Mathias@63456
  1715
    add_le_same_cancel1
Mathias@63456
  1716
    add_le_same_cancel2
Mathias@63456
  1717
    add_less_same_cancel1
Mathias@63456
  1718
    add_less_same_cancel2
Mathias@63456
  1719
Mathias@63456
  1720
* Some simplifications theorems about rings have been removed, since
Mathias@63456
  1721
  superseeded by a more general version:
Mathias@63456
  1722
    less_add_cancel_left_greater_zero ~> less_add_same_cancel1
Mathias@63456
  1723
    less_add_cancel_right_greater_zero ~> less_add_same_cancel2
Mathias@63456
  1724
    less_eq_add_cancel_left_greater_eq_zero ~> le_add_same_cancel1
Mathias@63456
  1725
    less_eq_add_cancel_right_greater_eq_zero ~> le_add_same_cancel2
Mathias@63456
  1726
    less_eq_add_cancel_left_less_eq_zero ~> add_le_same_cancel1
Mathias@63456
  1727
    less_eq_add_cancel_right_less_eq_zero ~> add_le_same_cancel2
Mathias@63456
  1728
    less_add_cancel_left_less_zero ~> add_less_same_cancel1
Mathias@63456
  1729
    less_add_cancel_right_less_zero ~> add_less_same_cancel2
Mathias@63456
  1730
INCOMPATIBILITY.
Mathias@63456
  1731
wenzelm@62407
  1732
* Renamed split_if -> if_split and split_if_asm -> if_split_asm to
wenzelm@62407
  1733
resemble the f.split naming convention, INCOMPATIBILITY.
nipkow@62396
  1734
wenzelm@63977
  1735
* Added class topological_monoid.
wenzelm@63977
  1736
wenzelm@64391
  1737
* The following theorems have been renamed:
wenzelm@64391
  1738
nipkow@64457
  1739
  setsum_left_distrib ~> sum_distrib_right
nipkow@64457
  1740
  setsum_right_distrib ~> sum_distrib_left
wenzelm@64391
  1741
wenzelm@64391
  1742
INCOMPATIBILITY.
wenzelm@64391
  1743
wenzelm@64391
  1744
* Compound constants INFIMUM and SUPREMUM are mere abbreviations now.
wenzelm@64391
  1745
INCOMPATIBILITY.
wenzelm@64391
  1746
wenzelm@64391
  1747
* "Gcd (f ` A)" and "Lcm (f ` A)" are printed with optional
wenzelm@64391
  1748
comprehension-like syntax analogously to "Inf (f ` A)" and "Sup (f `
wenzelm@64391
  1749
A)".
wenzelm@64391
  1750
wenzelm@64391
  1751
* Class semiring_Lcd merged into semiring_Gcd. INCOMPATIBILITY.
wenzelm@64391
  1752
wenzelm@64391
  1753
* The type class ordered_comm_monoid_add is now called
wenzelm@64391
  1754
ordered_cancel_comm_monoid_add. A new type class ordered_comm_monoid_add
wenzelm@64391
  1755
is introduced as the combination of ordered_ab_semigroup_add +
wenzelm@64391
  1756
comm_monoid_add. INCOMPATIBILITY.
wenzelm@64391
  1757
wenzelm@64391
  1758
* Introduced the type classes canonically_ordered_comm_monoid_add and
wenzelm@64391
  1759
dioid.
wenzelm@64391
  1760
wenzelm@64391
  1761
* Introduced the type class ordered_ab_semigroup_monoid_add_imp_le. When
wenzelm@64391
  1762
instantiating linordered_semiring_strict and ordered_ab_group_add, an
wenzelm@64391
  1763
explicit instantiation of ordered_ab_semigroup_monoid_add_imp_le might
wenzelm@64391
  1764
be required. INCOMPATIBILITY.
nipkow@63117
  1765
haftmann@62348
  1766
* Dropped various legacy fact bindings, whose replacements are often
haftmann@62348
  1767
of a more general type also:
haftmann@62348
  1768
  lcm_left_commute_nat ~> lcm.left_commute
haftmann@62348
  1769
  lcm_left_commute_int ~> lcm.left_commute
haftmann@62348
  1770
  gcd_left_commute_nat ~> gcd.left_commute
haftmann@62348
  1771
  gcd_left_commute_int ~> gcd.left_commute
haftmann@62348
  1772
  gcd_greatest_iff_nat ~> gcd_greatest_iff
haftmann@62348
  1773
  gcd_greatest_iff_int ~> gcd_greatest_iff
haftmann@62348
  1774
  coprime_dvd_mult_nat ~> coprime_dvd_mult
haftmann@62348
  1775
  coprime_dvd_mult_int ~> coprime_dvd_mult
haftmann@62348
  1776
  zpower_numeral_even ~> power_numeral_even
haftmann@62348
  1777
  gcd_mult_cancel_nat ~> gcd_mult_cancel
haftmann@62348
  1778
  gcd_mult_cancel_int ~> gcd_mult_cancel
haftmann@62348
  1779
  div_gcd_coprime_nat ~> div_gcd_coprime
haftmann@62348
  1780
  div_gcd_coprime_int ~> div_gcd_coprime
haftmann@62348
  1781
  zpower_numeral_odd ~> power_numeral_odd
haftmann@62348
  1782
  zero_less_int_conv ~> of_nat_0_less_iff
haftmann@62348
  1783
  gcd_greatest_nat ~> gcd_greatest
haftmann@62348
  1784
  gcd_greatest_int ~> gcd_greatest
haftmann@62348
  1785
  coprime_mult_nat ~> coprime_mult
haftmann@62348
  1786
  coprime_mult_int ~> coprime_mult
haftmann@62348
  1787
  lcm_commute_nat ~> lcm.commute
haftmann@62348
  1788
  lcm_commute_int ~> lcm.commute
haftmann@62348
  1789
  int_less_0_conv ~> of_nat_less_0_iff
haftmann@62348
  1790
  gcd_commute_nat ~> gcd.commute
haftmann@62348
  1791
  gcd_commute_int ~> gcd.commute
haftmann@62348
  1792
  Gcd_insert_nat ~> Gcd_insert
haftmann@62348
  1793
  Gcd_insert_int ~> Gcd_insert
haftmann@62348
  1794
  of_int_int_eq ~> of_int_of_nat_eq
haftmann@62348
  1795
  lcm_least_nat ~> lcm_least
haftmann@62348
  1796
  lcm_least_int ~> lcm_least
haftmann@62348
  1797
  lcm_assoc_nat ~> lcm.assoc
haftmann@62348
  1798
  lcm_assoc_int ~> lcm.assoc
haftmann@62348
  1799
  int_le_0_conv ~> of_nat_le_0_iff
haftmann@62348
  1800
  int_eq_0_conv ~> of_nat_eq_0_iff
haftmann@62348
  1801
  Gcd_empty_nat ~> Gcd_empty
haftmann@62348
  1802
  Gcd_empty_int ~> Gcd_empty
haftmann@62348
  1803
  gcd_assoc_nat ~> gcd.assoc
haftmann@62348
  1804
  gcd_assoc_int ~> gcd.assoc
haftmann@62348
  1805
  zero_zle_int ~> of_nat_0_le_iff
haftmann@62348
  1806
  lcm_dvd2_nat ~> dvd_lcm2
haftmann@62348
  1807
  lcm_dvd2_int ~> dvd_lcm2
haftmann@62348
  1808
  lcm_dvd1_nat ~> dvd_lcm1
haftmann@62348
  1809
  lcm_dvd1_int ~> dvd_lcm1
haftmann@62348
  1810
  gcd_zero_nat ~> gcd_eq_0_iff
haftmann@62348
  1811
  gcd_zero_int ~> gcd_eq_0_iff
haftmann@62348
  1812
  gcd_dvd2_nat ~> gcd_dvd2
haftmann@62348
  1813
  gcd_dvd2_int ~> gcd_dvd2
haftmann@62348
  1814
  gcd_dvd1_nat ~> gcd_dvd1
haftmann@62348
  1815
  gcd_dvd1_int ~> gcd_dvd1
haftmann@62348
  1816
  int_numeral ~> of_nat_numeral
haftmann@62348
  1817
  lcm_ac_nat ~> ac_simps
haftmann@62348
  1818
  lcm_ac_int ~> ac_simps
haftmann@62348
  1819
  gcd_ac_nat ~> ac_simps
haftmann@62348
  1820
  gcd_ac_int ~> ac_simps
haftmann@62348
  1821
  abs_int_eq ~> abs_of_nat
haftmann@62348
  1822
  zless_int ~> of_nat_less_iff
haftmann@62348
  1823
  zdiff_int ~> of_nat_diff
haftmann@62348
  1824
  zadd_int ~> of_nat_add
haftmann@62348
  1825
  int_mult ~> of_nat_mult
haftmann@62348
  1826
  int_Suc ~> of_nat_Suc
haftmann@62348
  1827
  inj_int ~> inj_of_nat
haftmann@62348
  1828
  int_1 ~> of_nat_1
haftmann@62348
  1829
  int_0 ~> of_nat_0
haftmann@62353
  1830
  Lcm_empty_nat ~> Lcm_empty
haftmann@62353
  1831
  Lcm_empty_int ~> Lcm_empty
haftmann@62353
  1832
  Lcm_insert_nat ~> Lcm_insert
haftmann@62353
  1833
  Lcm_insert_int ~> Lcm_insert
haftmann@62353
  1834
  comp_fun_idem_gcd_nat ~> comp_fun_idem_gcd
haftmann@62353
  1835
  comp_fun_idem_gcd_int ~> comp_fun_idem_gcd
haftmann@62353
  1836
  comp_fun_idem_lcm_nat ~> comp_fun_idem_lcm
haftmann@62353
  1837
  comp_fun_idem_lcm_int ~> comp_fun_idem_lcm
haftmann@62353
  1838
  Lcm_eq_0 ~> Lcm_eq_0_I
haftmann@62353
  1839
  Lcm0_iff ~> Lcm_0_iff
haftmann@62353
  1840
  Lcm_dvd_int ~> Lcm_least
haftmann@62353
  1841
  divides_mult_nat ~> divides_mult
haftmann@62353
  1842
  divides_mult_int ~> divides_mult
haftmann@62353
  1843
  lcm_0_nat ~> lcm_0_right
haftmann@62353
  1844
  lcm_0_int ~> lcm_0_right
haftmann@62353
  1845
  lcm_0_left_nat ~> lcm_0_left
haftmann@62353
  1846
  lcm_0_left_int ~> lcm_0_left
haftmann@62353
  1847
  dvd_gcd_D1_nat ~> dvd_gcdD1
haftmann@62353
  1848
  dvd_gcd_D1_int ~> dvd_gcdD1
haftmann@62353
  1849
  dvd_gcd_D2_nat ~> dvd_gcdD2
haftmann@62353
  1850
  dvd_gcd_D2_int ~> dvd_gcdD2
haftmann@62353
  1851
  coprime_dvd_mult_iff_nat ~> coprime_dvd_mult_iff
haftmann@62353
  1852
  coprime_dvd_mult_iff_int ~> coprime_dvd_mult_iff
haftmann@62348
  1853
  realpow_minus_mult ~> power_minus_mult
haftmann@62348
  1854
  realpow_Suc_le_self ~> power_Suc_le_self
haftmann@62353
  1855
  dvd_Gcd, dvd_Gcd_nat, dvd_Gcd_int removed in favour of Gcd_greatest
haftmann@62347
  1856
INCOMPATIBILITY.
haftmann@62347
  1857
lp15@63967
  1858
* Renamed HOL/Quotient_Examples/FSet.thy to
wenzelm@63977
  1859
HOL/Quotient_Examples/Quotient_FSet.thy INCOMPATIBILITY.
wenzelm@63977
  1860
wenzelm@64390
  1861
* Session HOL-Library: theory FinFun bundles "finfun_syntax" and
wenzelm@64390
  1862
"no_finfun_syntax" allow to control optional syntax in local contexts;
wenzelm@64390
  1863
this supersedes former theory FinFun_Syntax. INCOMPATIBILITY, e.g. use
wenzelm@64390
  1864
"unbundle finfun_syntax" to imitate import of
wenzelm@64390
  1865
"~~/src/HOL/Library/FinFun_Syntax".
wenzelm@64390
  1866
wenzelm@64390
  1867
* Session HOL-Library: theory Multiset_Permutations (executably) defines
wenzelm@64390
  1868
the set of permutations of a given set or multiset, i.e. the set of all
wenzelm@64390
  1869
lists that contain every element of the carrier (multi-)set exactly
wenzelm@64390
  1870
once.
wenzelm@64390
  1871
wenzelm@64390
  1872
* Session HOL-Library: multiset membership is now expressed using
wenzelm@64390
  1873
set_mset rather than count.
wenzelm@64390
  1874
wenzelm@64390
  1875
  - Expressions "count M a > 0" and similar simplify to membership
wenzelm@64390
  1876
    by default.
wenzelm@64390
  1877
wenzelm@64390
  1878
  - Converting between "count M a = 0" and non-membership happens using
wenzelm@64390
  1879
    equations count_eq_zero_iff and not_in_iff.
wenzelm@64390
  1880
wenzelm@64390
  1881
  - Rules count_inI and in_countE obtain facts of the form
wenzelm@64390
  1882
    "count M a = n" from membership.
wenzelm@64390
  1883
wenzelm@64390
  1884
  - Rules count_in_diffI and in_diff_countE obtain facts of the form
wenzelm@64390
  1885
    "count M a = n + count N a" from membership on difference sets.
wenzelm@64390
  1886
wenzelm@64390
  1887
INCOMPATIBILITY.
wenzelm@64390
  1888
wenzelm@64390
  1889
* Session HOL-Library: theory LaTeXsugar uses new-style "dummy_pats" for
wenzelm@64390
  1890
displaying equations in functional programming style --- variables
wenzelm@64390
  1891
present on the left-hand but not on the righ-hand side are replaced by
wenzelm@64390
  1892
underscores.
wenzelm@64390
  1893
wenzelm@64390
  1894
* Session HOL-Library: theory Combinator_PER provides combinator to
wenzelm@64390
  1895
build partial equivalence relations from a predicate and an equivalence
wenzelm@64390
  1896
relation.
wenzelm@64390
  1897
wenzelm@64390
  1898
* Session HOL-Library: theory Perm provides basic facts about almost
wenzelm@64390
  1899
everywhere fix bijections.
wenzelm@64390
  1900
wenzelm@64390
  1901
* Session HOL-Library: theory Normalized_Fraction allows viewing an
wenzelm@64390
  1902
element of a field of fractions as a normalized fraction (i.e. a pair of
wenzelm@64390
  1903
numerator and denominator such that the two are coprime and the
wenzelm@64390
  1904
denominator is normalized wrt. unit factors).
wenzelm@64390
  1905
wenzelm@64390
  1906
* Session HOL-NSA has been renamed to HOL-Nonstandard_Analysis.
wenzelm@64390
  1907
wenzelm@64390
  1908
* Session HOL-Multivariate_Analysis has been renamed to HOL-Analysis.
wenzelm@64390
  1909
wenzelm@64390
  1910
* Session HOL-Analysis: measure theory has been moved here from
wenzelm@64390
  1911
HOL-Probability. When importing HOL-Analysis some theorems need
wenzelm@64390
  1912
additional name spaces prefixes due to name clashes. INCOMPATIBILITY.
wenzelm@64390
  1913
wenzelm@64390
  1914
* Session HOL-Analysis: more complex analysis including Cauchy's
wenzelm@64390
  1915
inequality, Liouville theorem, open mapping theorem, maximum modulus
wenzelm@64390
  1916
principle, Residue theorem, Schwarz Lemma.
wenzelm@64390
  1917
wenzelm@64390
  1918
* Session HOL-Analysis: Theory of polyhedra: faces, extreme points,
wenzelm@64390
  1919
polytopes, and the Krein–Milman Minkowski theorem.
wenzelm@64390
  1920
wenzelm@64390
  1921
* Session HOL-Analysis: Numerous results ported from the HOL Light
wenzelm@64390
  1922
libraries: homeomorphisms, continuous function extensions, invariance of
wenzelm@64390
  1923
domain.
wenzelm@64390
  1924
wenzelm@64390
  1925
* Session HOL-Probability: the type of emeasure and nn_integral was
wenzelm@64390
  1926
changed from ereal to ennreal, INCOMPATIBILITY.
wenzelm@64390
  1927
wenzelm@64390
  1928
  emeasure :: 'a measure \<Rightarrow> 'a set \<Rightarrow> ennreal
wenzelm@64390
  1929
  nn_integral :: 'a measure \<Rightarrow> ('a \<Rightarrow> ennreal) \<Rightarrow> ennreal
wenzelm@64390
  1930
wenzelm@64390
  1931
* Session HOL-Probability: Code generation and QuickCheck for
wenzelm@64390
  1932
Probability Mass Functions.
wenzelm@64390
  1933
wenzelm@64390
  1934
* Session HOL-Probability: theory Random_Permutations contains some
wenzelm@64390
  1935
theory about choosing a permutation of a set uniformly at random and
wenzelm@64390
  1936
folding over a list in random order.
wenzelm@64390
  1937
wenzelm@64390
  1938
* Session HOL-Probability: theory SPMF formalises discrete
wenzelm@64390
  1939
subprobability distributions.
wenzelm@64390
  1940
wenzelm@64390
  1941
* Session HOL-Library: the names of multiset theorems have been
wenzelm@64390
  1942
normalised to distinguish which ordering the theorems are about
wenzelm@64390
  1943
wenzelm@64390
  1944
    mset_less_eqI ~> mset_subset_eqI
wenzelm@64390
  1945
    mset_less_insertD ~> mset_subset_insertD
wenzelm@64390
  1946
    mset_less_eq_count ~> mset_subset_eq_count
wenzelm@64390
  1947
    mset_less_diff_self ~> mset_subset_diff_self
wenzelm@64390
  1948
    mset_le_exists_conv ~> mset_subset_eq_exists_conv
wenzelm@64390
  1949
    mset_le_mono_add_right_cancel ~> mset_subset_eq_mono_add_right_cancel
wenzelm@64390
  1950
    mset_le_mono_add_left_cancel ~> mset_subset_eq_mono_add_left_cancel
wenzelm@64390
  1951
    mset_le_mono_add ~> mset_subset_eq_mono_add
wenzelm@64390
  1952
    mset_le_add_left ~> mset_subset_eq_add_left
wenzelm@64390
  1953
    mset_le_add_right ~> mset_subset_eq_add_right
wenzelm@64390
  1954
    mset_le_single ~> mset_subset_eq_single
wenzelm@64390
  1955
    mset_le_multiset_union_diff_commute ~> mset_subset_eq_multiset_union_diff_commute
wenzelm@64390
  1956
    diff_le_self ~> diff_subset_eq_self
wenzelm@64390
  1957
    mset_leD ~> mset_subset_eqD
wenzelm@64390
  1958
    mset_lessD ~> mset_subsetD
wenzelm@64390
  1959
    mset_le_insertD ~> mset_subset_eq_insertD
wenzelm@64390
  1960
    mset_less_of_empty ~> mset_subset_of_empty
wenzelm@64390
  1961
    mset_less_size ~> mset_subset_size
wenzelm@64390
  1962
    wf_less_mset_rel ~> wf_subset_mset_rel
wenzelm@64390
  1963
    count_le_replicate_mset_le ~> count_le_replicate_mset_subset_eq
wenzelm@64390
  1964
    mset_remdups_le ~> mset_remdups_subset_eq
wenzelm@64390
  1965
    ms_lesseq_impl ~> subset_eq_mset_impl
wenzelm@64390
  1966
wenzelm@64390
  1967
Some functions have been renamed:
wenzelm@64390
  1968
    ms_lesseq_impl -> subset_eq_mset_impl
wenzelm@64390
  1969
wenzelm@64390
  1970
* HOL-Library: multisets are now ordered with the multiset ordering
wenzelm@64390
  1971
    #\<subseteq># ~> \<le>
wenzelm@64390
  1972
    #\<subset># ~> <
wenzelm@64390
  1973
    le_multiset ~> less_eq_multiset
wenzelm@64390
  1974
    less_multiset ~> le_multiset
wenzelm@64390
  1975
INCOMPATIBILITY.
wenzelm@64390
  1976
wenzelm@64390
  1977
* Session HOL-Library: the prefix multiset_order has been discontinued:
wenzelm@64390
  1978
the theorems can be directly accessed. As a consequence, the lemmas
wenzelm@64390
  1979
"order_multiset" and "linorder_multiset" have been discontinued, and the
wenzelm@64390
  1980
interpretations "multiset_linorder" and "multiset_wellorder" have been
wenzelm@64390
  1981
replaced by instantiations. INCOMPATIBILITY.
wenzelm@64390
  1982
wenzelm@64390
  1983
* Session HOL-Library: some theorems about the multiset ordering have
wenzelm@64390
  1984
been renamed:
wenzelm@64390
  1985
wenzelm@64390
  1986
    le_multiset_def ~> less_eq_multiset_def
wenzelm@64390
  1987
    less_multiset_def ~> le_multiset_def
wenzelm@64390
  1988
    less_eq_imp_le_multiset ~> subset_eq_imp_le_multiset
wenzelm@64390
  1989
    mult_less_not_refl ~> mset_le_not_refl
wenzelm@64390
  1990
    mult_less_trans ~> mset_le_trans
wenzelm@64390
  1991
    mult_less_not_sym ~> mset_le_not_sym
wenzelm@64390
  1992
    mult_less_asym ~> mset_le_asym
wenzelm@64390
  1993
    mult_less_irrefl ~> mset_le_irrefl
wenzelm@64390
  1994
    union_less_mono2{,1,2} ~> union_le_mono2{,1,2}
wenzelm@64390
  1995
wenzelm@64390
  1996
    le_multiset\<^sub>H\<^sub>O ~> less_eq_multiset\<^sub>H\<^sub>O
wenzelm@64390
  1997
    le_multiset_total ~> less_eq_multiset_total
wenzelm@64390
  1998
    less_multiset_right_total ~> subset_eq_imp_le_multiset
wenzelm@64390
  1999
    le_multiset_empty_left ~> less_eq_multiset_empty_left
wenzelm@64390
  2000
    le_multiset_empty_right ~> less_eq_multiset_empty_right
wenzelm@64390
  2001
    less_multiset_empty_right ~> le_multiset_empty_left
wenzelm@64390
  2002
    less_multiset_empty_left ~> le_multiset_empty_right
wenzelm@64390
  2003
    union_less_diff_plus ~> union_le_diff_plus
wenzelm@64390
  2004
    ex_gt_count_imp_less_multiset ~> ex_gt_count_imp_le_multiset
wenzelm@64390
  2005
    less_multiset_plus_left_nonempty ~> le_multiset_plus_left_nonempty
wenzelm@64390
  2006
    le_multiset_plus_right_nonempty ~> le_multiset_plus_right_nonempty
wenzelm@64390
  2007
INCOMPATIBILITY.
wenzelm@64390
  2008
wenzelm@64390
  2009
* Session HOL-Library: the lemma mset_map has now the attribute [simp].
wenzelm@64390
  2010
INCOMPATIBILITY.
wenzelm@64390
  2011
wenzelm@64390
  2012
* Session HOL-Library: some theorems about multisets have been removed.
wenzelm@64390
  2013
INCOMPATIBILITY, use the following replacements:
wenzelm@64390
  2014
wenzelm@64390
  2015
    le_multiset_plus_plus_left_iff ~> add_less_cancel_right
wenzelm@64390
  2016
    less_multiset_plus_plus_left_iff ~> add_less_cancel_right
wenzelm@64390
  2017
    le_multiset_plus_plus_right_iff ~> add_less_cancel_left
wenzelm@64390
  2018
    less_multiset_plus_plus_right_iff ~> add_less_cancel_left
wenzelm@64390
  2019
    add_eq_self_empty_iff ~> add_cancel_left_right
wenzelm@64390
  2020
    mset_subset_add_bothsides ~> subset_mset.add_less_cancel_right
wenzelm@64390
  2021
    mset_less_add_bothsides ~> subset_mset.add_less_cancel_right
wenzelm@64390
  2022
    mset_le_add_bothsides ~> subset_mset.add_less_cancel_right
wenzelm@64390
  2023
    empty_inter ~> subset_mset.inf_bot_left
wenzelm@64390
  2024
    inter_empty ~> subset_mset.inf_bot_right
wenzelm@64390
  2025
    empty_sup ~> subset_mset.sup_bot_left
wenzelm@64390
  2026
    sup_empty ~> subset_mset.sup_bot_right
wenzelm@64390
  2027
    bdd_below_multiset ~> subset_mset.bdd_above_bot
wenzelm@64390
  2028
    subset_eq_empty ~> subset_mset.le_zero_eq
wenzelm@64390
  2029
    le_empty ~> subset_mset.le_zero_eq
wenzelm@64390
  2030
    mset_subset_empty_nonempty ~> subset_mset.zero_less_iff_neq_zero
wenzelm@64390
  2031
    mset_less_empty_nonempty ~> subset_mset.zero_less_iff_neq_zero
wenzelm@64390
  2032
wenzelm@64390
  2033
* Session HOL-Library: some typeclass constraints about multisets have
wenzelm@64390
  2034
been reduced from ordered or linordered to preorder. Multisets have the
wenzelm@64390
  2035
additional typeclasses order_bot, no_top,
wenzelm@64390
  2036
ordered_ab_semigroup_add_imp_le, ordered_cancel_comm_monoid_add,
wenzelm@64390
  2037
linordered_cancel_ab_semigroup_add, and
wenzelm@64390
  2038
ordered_ab_semigroup_monoid_add_imp_le. INCOMPATIBILITY.
wenzelm@64390
  2039
wenzelm@64390
  2040
* Session HOL-Library: there are some new simplification rules about
wenzelm@64390
  2041
multisets, the multiset ordering, and the subset ordering on multisets.
wenzelm@64390
  2042
INCOMPATIBILITY.
wenzelm@64390
  2043
wenzelm@64390
  2044
* Session HOL-Library: the subset ordering on multisets has now the
wenzelm@64390
  2045
interpretations ordered_ab_semigroup_monoid_add_imp_le and
wenzelm@64390
  2046
bounded_lattice_bot. INCOMPATIBILITY.
wenzelm@64390
  2047
wenzelm@64390
  2048
* Session HOL-Library, theory Multiset: single has been removed in favor
wenzelm@64390
  2049
of add_mset that roughly corresponds to Set.insert. Some theorems have
wenzelm@64390
  2050
removed or changed:
wenzelm@64390
  2051
wenzelm@64390
  2052
  single_not_empty ~> add_mset_not_empty or empty_not_add_mset
wenzelm@64390
  2053
  fold_mset_insert ~> fold_mset_add_mset
wenzelm@64390
  2054
  image_mset_insert ~> image_mset_add_mset
wenzelm@64390
  2055
  union_single_eq_diff
wenzelm@64390
  2056
  multi_self_add_other_not_self
wenzelm@64390
  2057
  diff_single_eq_union
wenzelm@64390
  2058
INCOMPATIBILITY.
wenzelm@64390
  2059
wenzelm@64390
  2060
* Session HOL-Library, theory Multiset: some theorems have been changed
wenzelm@64390
  2061
to use add_mset instead of single:
wenzelm@64390
  2062
wenzelm@64390
  2063
  mset_add
wenzelm@64390
  2064
  multi_self_add_other_not_self
wenzelm@64390
  2065
  diff_single_eq_union
wenzelm@64390
  2066
  union_single_eq_diff
wenzelm@64390
  2067
  union_single_eq_member
wenzelm@64390
  2068
  add_eq_conv_diff
wenzelm@64390
  2069
  insert_noteq_member
wenzelm@64390
  2070
  add_eq_conv_ex
wenzelm@64390
  2071
  multi_member_split
wenzelm@64390
  2072
  multiset_add_sub_el_shuffle
wenzelm@64390
  2073
  mset_subset_eq_insertD
wenzelm@64390
  2074
  mset_subset_insertD
wenzelm@64390
  2075
  insert_subset_eq_iff
wenzelm@64390
  2076
  insert_union_subset_iff
wenzelm@64390
  2077
  multi_psub_of_add_self
wenzelm@64390
  2078
  inter_add_left1
wenzelm@64390
  2079
  inter_add_left2
wenzelm@64390
  2080
  inter_add_right1
wenzelm@64390
  2081
  inter_add_right2
wenzelm@64390
  2082
  sup_union_left1
wenzelm@64390
  2083
  sup_union_left2
wenzelm@64390
  2084
  sup_union_right1
wenzelm@64390
  2085
  sup_union_right2
wenzelm@64390
  2086
  size_eq_Suc_imp_eq_union
wenzelm@64390
  2087
  multi_nonempty_split
wenzelm@64390
  2088
  mset_insort
wenzelm@64390
  2089
  mset_update
wenzelm@64390
  2090
  mult1I
wenzelm@64390
  2091
  less_add
wenzelm@64390
  2092
  mset_zip_take_Cons_drop_twice
wenzelm@64390
  2093
  rel_mset_Zero
wenzelm@64390
  2094
  msed_map_invL
wenzelm@64390
  2095
  msed_map_invR
wenzelm@64390
  2096
  msed_rel_invL
wenzelm@64390
  2097
  msed_rel_invR
wenzelm@64390
  2098
  le_multiset_right_total
wenzelm@64390
  2099
  multiset_induct
wenzelm@64390
  2100
  multiset_induct2_size
wenzelm@64390
  2101
  multiset_induct2
wenzelm@64390
  2102
INCOMPATIBILITY.
wenzelm@64390
  2103
wenzelm@64390
  2104
* Session HOL-Library, theory Multiset: the definitions of some
wenzelm@64390
  2105
constants have changed to use add_mset instead of adding a single
wenzelm@64390
  2106
element:
wenzelm@64390
  2107
wenzelm@64390
  2108
  image_mset
wenzelm@64390
  2109
  mset
wenzelm@64390
  2110
  replicate_mset
wenzelm@64390
  2111
  mult1
wenzelm@64390
  2112
  pred_mset
wenzelm@64390
  2113
  rel_mset'
wenzelm@64390
  2114
  mset_insort
wenzelm@64390
  2115
wenzelm@64390
  2116
INCOMPATIBILITY.
wenzelm@64390
  2117
wenzelm@64390
  2118
* Session HOL-Library, theory Multiset: due to the above changes, the
wenzelm@64390
  2119
attributes of some multiset theorems have been changed:
wenzelm@64390
  2120
wenzelm@64390
  2121
  insert_DiffM  [] ~> [simp]
wenzelm@64390
  2122
  insert_DiffM2 [simp] ~> []
wenzelm@64390
  2123
  diff_add_mset_swap [simp]
wenzelm@64390
  2124
  fold_mset_add_mset [simp]
wenzelm@64390
  2125
  diff_diff_add [simp] (for multisets only)
wenzelm@64390
  2126
  diff_cancel [simp] ~> []
wenzelm@64390
  2127
  count_single [simp] ~> []
wenzelm@64390
  2128
  set_mset_single [simp] ~> []
wenzelm@64390
  2129
  size_multiset_single [simp] ~> []
wenzelm@64390
  2130
  size_single [simp] ~> []
wenzelm@64390
  2131
  image_mset_single [simp] ~> []
wenzelm@64390
  2132
  mset_subset_eq_mono_add_right_cancel [simp] ~> []
wenzelm@64390
  2133
  mset_subset_eq_mono_add_left_cancel [simp] ~> []
wenzelm@64390
  2134
  fold_mset_single [simp] ~> []
wenzelm@64390
  2135
  subset_eq_empty [simp] ~> []
wenzelm@64390
  2136
  empty_sup [simp] ~> []
wenzelm@64390
  2137
  sup_empty [simp] ~> []
wenzelm@64390
  2138
  inter_empty [simp] ~> []
wenzelm@64390
  2139
  empty_inter [simp] ~> []
wenzelm@64390
  2140
INCOMPATIBILITY.
wenzelm@64390
  2141
wenzelm@64391
  2142
* Session HOL-Library, theory Multiset: the order of the variables in
wenzelm@64390
  2143
the second cases of multiset_induct, multiset_induct2_size,
wenzelm@64390
  2144
multiset_induct2 has been changed (e.g. Add A a ~> Add a A).
wenzelm@64390
  2145
INCOMPATIBILITY.
wenzelm@64390
  2146
wenzelm@64390
  2147
* Session HOL-Library, theory Multiset: there is now a simplification
wenzelm@64390
  2148
procedure on multisets. It mimics the behavior of the procedure on
wenzelm@64390
  2149
natural numbers. INCOMPATIBILITY.
wenzelm@64390
  2150
wenzelm@64390
  2151
* Session HOL-Library, theory Multiset: renamed sums and products of
wenzelm@64390
  2152
multisets:
wenzelm@64390
  2153
wenzelm@64390
  2154
  msetsum ~> sum_mset
wenzelm@64390
  2155
  msetprod ~> prod_mset
wenzelm@64390
  2156
wenzelm@64390
  2157
* Session HOL-Library, theory Multiset: the notation for intersection
wenzelm@64390
  2158
and union of multisets have been changed:
wenzelm@64390
  2159
wenzelm@64390
  2160
  #\<inter> ~> \<inter>#
wenzelm@64390
  2161
  #\<union> ~> \<union>#
wenzelm@64390
  2162
wenzelm@64390
  2163
INCOMPATIBILITY.
wenzelm@64390
  2164
wenzelm@64390
  2165
* Session HOL-Library, theory Multiset: the lemma
wenzelm@64390
  2166
one_step_implies_mult_aux on multisets has been removed, use
wenzelm@64390
  2167
one_step_implies_mult instead. INCOMPATIBILITY.
wenzelm@64390
  2168
wenzelm@64390
  2169
* Session HOL-Library: theory Complete_Partial_Order2 provides reasoning
wenzelm@64390
  2170
support for monotonicity and continuity in chain-complete partial orders
wenzelm@64390
  2171
and about admissibility conditions for fixpoint inductions.
wenzelm@64390
  2172
haftmann@64523
  2173
* Session HOL-Library: theory Library/Polynomial contains also
haftmann@64523
  2174
derivation of polynomials (formerly in Library/Poly_Deriv) but not
haftmann@64523
  2175
gcd/lcm on polynomials over fields. This has been moved to a separate
haftmann@64523
  2176
theory Library/Polynomial_GCD_euclidean.thy, to pave way for a possible
haftmann@64523
  2177
future different type class instantiation for polynomials over factorial
haftmann@64523
  2178
rings. INCOMPATIBILITY.
wenzelm@64390
  2179
wenzelm@64390
  2180
* Session HOL-Library: theory Sublist provides function "prefixes" with
wenzelm@64390
  2181
the following renaming
wenzelm@64390
  2182
wenzelm@64390
  2183
  prefixeq -> prefix
wenzelm@64390
  2184
  prefix -> strict_prefix
wenzelm@64390
  2185
  suffixeq -> suffix
wenzelm@64390
  2186
  suffix -> strict_suffix
wenzelm@64390
  2187
wenzelm@64390
  2188
Added theory of longest common prefixes.
blanchet@64389
  2189
wenzelm@64391
  2190
* Session HOL-Number_Theory: algebraic foundation for primes:
wenzelm@64391
  2191
Generalisation of predicate "prime" and introduction of predicates
wenzelm@64391
  2192
"prime_elem", "irreducible", a "prime_factorization" function, and the
wenzelm@64391
  2193
"factorial_ring" typeclass with instance proofs for nat, int, poly. Some
wenzelm@64391
  2194
theorems now have different names, most notably "prime_def" is now
wenzelm@64391
  2195
"prime_nat_iff". INCOMPATIBILITY.
wenzelm@64391
  2196
wenzelm@64391
  2197
* Session Old_Number_Theory has been removed, after porting remaining
wenzelm@64391
  2198
theories.
wenzelm@64391
  2199
wenzelm@64551
  2200
* Session HOL-Types_To_Sets provides an experimental extension of
wenzelm@64551
  2201
Higher-Order Logic to allow translation of types to sets.
wenzelm@64551
  2202
wenzelm@63198
  2203
wenzelm@62498
  2204
*** ML ***
wenzelm@62498
  2205
wenzelm@63227
  2206
* Integer.gcd and Integer.lcm use efficient operations from the Poly/ML
wenzelm@63228
  2207
library (notably for big integers). Subtle change of semantics:
wenzelm@63228
  2208
Integer.gcd and Integer.lcm both normalize the sign, results are never
wenzelm@63228
  2209
negative. This coincides with the definitions in HOL/GCD.thy.
wenzelm@63228
  2210
INCOMPATIBILITY.
wenzelm@63227
  2211
wenzelm@63212
  2212
* Structure Rat for rational numbers is now an integral part of
wenzelm@63215
  2213
Isabelle/ML, with special notation @int/nat or @int for numerals (an
wenzelm@63215
  2214
abbreviation for antiquotation @{Pure.rat argument}) and ML pretty
wenzelm@63212
  2215
printing. Standard operations on type Rat.rat are provided via ad-hoc
wenzelm@63215
  2216
overloading of + - * / < <= > >= ~ abs. INCOMPATIBILITY, need to
wenzelm@63212
  2217
use + instead of +/ etc. Moreover, exception Rat.DIVZERO has been
wenzelm@63212
  2218
superseded by General.Div.
wenzelm@63198
  2219
wenzelm@64390
  2220
* ML antiquotation @{path} is superseded by @{file}, which ensures that
wenzelm@64390
  2221
the argument is a plain file. Minor INCOMPATIBILITY.
wenzelm@64390
  2222
wenzelm@64390
  2223
* Antiquotation @{make_string} is available during Pure bootstrap --
wenzelm@64390
  2224
with approximative output quality.
wenzelm@64390
  2225
wenzelm@64390
  2226
* Low-level ML system structures (like PolyML and RunCall) are no longer
wenzelm@64390
  2227
exposed to Isabelle/ML user-space. Potential INCOMPATIBILITY.
wenzelm@64390
  2228
wenzelm@62861
  2229
* The ML function "ML" provides easy access to run-time compilation.
wenzelm@62861
  2230
This is particularly useful for conditional compilation, without
wenzelm@62861
  2231
requiring separate files.
wenzelm@62861
  2232
wenzelm@62498
  2233
* Option ML_exception_debugger controls detailed exception trace via the
wenzelm@62498
  2234
Poly/ML debugger. Relevant ML modules need to be compiled beforehand
wenzelm@62498
  2235
with ML_file_debug, or with ML_file and option ML_debugger enabled. Note
wenzelm@62498
  2236
debugger information requires consirable time and space: main
wenzelm@62498
  2237
Isabelle/HOL with full debugger support may need ML_system_64.
wenzelm@62498
  2238
wenzelm@62514
  2239
* Local_Theory.restore has been renamed to Local_Theory.reset to
wenzelm@62514
  2240
emphasize its disruptive impact on the cumulative context, notably the
wenzelm@62514
  2241
scope of 'private' or 'qualified' names. Note that Local_Theory.reset is
wenzelm@62514
  2242
only appropriate when targets are managed, e.g. starting from a global
wenzelm@62514
  2243
theory and returning to it. Regular definitional packages should use
wenzelm@62514
  2244
balanced blocks of Local_Theory.open_target versus
wenzelm@62514
  2245
Local_Theory.close_target instead. Rare INCOMPATIBILITY.
wenzelm@62514
  2246
wenzelm@62519
  2247
* Structure TimeLimit (originally from the SML/NJ library) has been
wenzelm@62519
  2248
replaced by structure Timeout, with slightly different signature.
wenzelm@62519
  2249
INCOMPATIBILITY.
wenzelm@62519
  2250
wenzelm@62551
  2251
* Discontinued cd and pwd operations, which are not well-defined in a
wenzelm@62551
  2252
multi-threaded environment. Note that files are usually located
wenzelm@62551
  2253
relatively to the master directory of a theory (see also
wenzelm@62551
  2254
File.full_path). Potential INCOMPATIBILITY.
wenzelm@62551
  2255
wenzelm@63352
  2256
* Binding.empty_atts supersedes Thm.empty_binding and
wenzelm@63352
  2257
Attrib.empty_binding. Minor INCOMPATIBILITY.
wenzelm@63352
  2258
wenzelm@62498
  2259
wenzelm@62354
  2260
*** System ***
wenzelm@62354
  2261
wenzelm@64390
  2262
* SML/NJ and old versions of Poly/ML are no longer supported.
wenzelm@64390
  2263
wenzelm@64390
  2264
* Poly/ML heaps now follow the hierarchy of sessions, and thus require
wenzelm@64390
  2265
much less disk space.
wenzelm@63226
  2266
wenzelm@62591
  2267
* The Isabelle ML process is now managed directly by Isabelle/Scala, and
wenzelm@62591
  2268
shell scripts merely provide optional command-line access. In
wenzelm@62591
  2269
particular:
wenzelm@62591
  2270
wenzelm@62591
  2271
  . Scala module ML_Process to connect to the raw ML process,
wenzelm@62591
  2272
    with interaction via stdin/stdout/stderr or in batch mode;
wenzelm@62591
  2273
  . command-line tool "isabelle console" as interactive wrapper;
wenzelm@62591
  2274
  . command-line tool "isabelle process" as batch mode wrapper.
wenzelm@62588
  2275
wenzelm@62588
  2276
* The executable "isabelle_process" has been discontinued. Tools and
wenzelm@62588
  2277
prover front-ends should use ML_Process or Isabelle_Process in
wenzelm@62591
  2278
Isabelle/Scala. INCOMPATIBILITY.
wenzelm@62588
  2279
wenzelm@62588
  2280
* New command-line tool "isabelle process" supports ML evaluation of
wenzelm@62588
  2281
literal expressions (option -e) or files (option -f) in the context of a
wenzelm@62588
  2282
given heap image. Errors lead to premature exit of the ML process with
wenzelm@62588
  2283
return code 1.
wenzelm@62588
  2284
wenzelm@64390
  2285
* The command-line tool "isabelle build" supports option -N for cyclic
wenzelm@64390
  2286
shuffling of NUMA CPU nodes. This may help performance tuning on Linux
wenzelm@64390
  2287
servers with separate CPU/memory modules.
wenzelm@64390
  2288
wenzelm@64390
  2289
* System option "threads" (for the size of the Isabelle/ML thread farm)
wenzelm@64390
  2290
is also passed to the underlying ML runtime system as --gcthreads,
wenzelm@64274
  2291
unless there is already a default provided via ML_OPTIONS settings.
wenzelm@64274
  2292
wenzelm@63827
  2293
* System option "checkpoint" helps to fine-tune the global heap space
wenzelm@63827
  2294
management of isabelle build. This is relevant for big sessions that may
wenzelm@63827
  2295
exhaust the small 32-bit address space of the ML process (which is used
wenzelm@63827
  2296
by default).
wenzelm@63827
  2297
wenzelm@64308
  2298
* System option "profiling" specifies the mode for global ML profiling
wenzelm@64342
  2299
in "isabelle build". Possible values are "time", "allocations". The
wenzelm@64342
  2300
command-line tool "isabelle profiling_report" helps to digest the
wenzelm@64342
  2301
resulting log files.
wenzelm@64308
  2302
wenzelm@63986
  2303
* System option "ML_process_policy" specifies an optional command prefix
wenzelm@63986
  2304
for the underlying ML process, e.g. to control CPU affinity on
wenzelm@63987
  2305
multiprocessor systems. The "isabelle jedit" tool allows to override the
wenzelm@63987
  2306
implicit default via option -p.
wenzelm@63986
  2307
wenzelm@64390
  2308
* Command-line tool "isabelle console" provides option -r to help to
wenzelm@64390
  2309
bootstrapping Isabelle/Pure interactively.
wenzelm@64390
  2310
wenzelm@64390
  2311
* Command-line tool "isabelle yxml" has been discontinued.
wenzelm@64390
  2312
INCOMPATIBILITY, use operations from the modules "XML" and "YXML" in
wenzelm@64390
  2313
Isabelle/ML or Isabelle/Scala.
wenzelm@64390
  2314
wenzelm@64390
  2315
* Many Isabelle tools that require a Java runtime system refer to the
wenzelm@64390
  2316
settings ISABELLE_TOOL_JAVA_OPTIONS32 / ISABELLE_TOOL_JAVA_OPTIONS64,
wenzelm@64390
  2317
depending on the underlying platform. The settings for "isabelle build"
wenzelm@64390
  2318
ISABELLE_BUILD_JAVA_OPTIONS32 / ISABELLE_BUILD_JAVA_OPTIONS64 have been
wenzelm@64390
  2319
discontinued. Potential INCOMPATIBILITY.
wenzelm@64390
  2320
wenzelm@64390
  2321
* The Isabelle system environment always ensures that the main
wenzelm@64390
  2322
executables are found within the shell search $PATH: "isabelle" and
wenzelm@64390
  2323
"isabelle_scala_script".
wenzelm@64390
  2324
wenzelm@64390
  2325
* Isabelle tools may consist of .scala files: the Scala compiler is
wenzelm@64390
  2326
invoked on the spot. The source needs to define some object that extends
wenzelm@64390
  2327
Isabelle_Tool.Body.
wenzelm@64390
  2328
wenzelm@64390
  2329
* File.bash_string, File.bash_path etc. represent Isabelle/ML and
wenzelm@64390
  2330
Isabelle/Scala strings authentically within GNU bash. This is useful to
wenzelm@64390
  2331
produce robust shell scripts under program control, without worrying
wenzelm@64390
  2332
about spaces or special characters. Note that user output works via
wenzelm@64390
  2333
Path.print (ML) or Path.toString (Scala). INCOMPATIBILITY, the old (and
wenzelm@64390
  2334
less versatile) operations File.shell_quote, File.shell_path etc. have
wenzelm@64390
  2335
been discontinued.
wenzelm@64390
  2336
wenzelm@63995
  2337
* The isabelle_java executable allows to run a Java process within the
wenzelm@63995
  2338
name space of Java and Scala components that are bundled with Isabelle,
wenzelm@63995
  2339
but without the Isabelle settings environment.
wenzelm@63995
  2340
wenzelm@64390
  2341
* Isabelle/Scala: the SSH module supports ssh and sftp connections, for
wenzelm@64390
  2342
remote command-execution and file-system access. This resembles
wenzelm@64390
  2343
operations from module File and Isabelle_System to some extent. Note
wenzelm@64390
  2344
that Path specifications need to be resolved remotely via
wenzelm@64390
  2345
ssh.remote_path instead of File.standard_path: the implicit process
wenzelm@64390
  2346
environment is different, Isabelle settings are not available remotely.
wenzelm@64390
  2347
wenzelm@64390
  2348
* Isabelle/Scala: the Mercurial module supports repositories via the
wenzelm@64390
  2349
regular hg command-line interface. The repositroy clone and working
wenzelm@64390
  2350
directory may reside on a local or remote file-system (via ssh
wenzelm@64390
  2351
connection).
wenzelm@64265
  2352
wenzelm@62354
  2353
wenzelm@62354
  2354
wenzelm@62031
  2355
New in Isabelle2016 (February 2016)
wenzelm@62016
  2356
-----------------------------------
wenzelm@60138
  2357
wenzelm@61337
  2358
*** General ***
wenzelm@61337
  2359
wenzelm@62168
  2360
* Eisbach is now based on Pure instead of HOL. Objects-logics may import
wenzelm@62168
  2361
either the theory ~~/src/HOL/Eisbach/Eisbach (for HOL etc.) or
wenzelm@62168
  2362
~~/src/HOL/Eisbach/Eisbach_Old_Appl_Syntax (for FOL, ZF etc.). Note that
wenzelm@62168
  2363
the HOL-Eisbach session located in ~~/src/HOL/Eisbach/ contains further
wenzelm@62168
  2364
examples that do require HOL.
wenzelm@62168
  2365
wenzelm@62157
  2366
* Better resource usage on all platforms (Linux, Windows, Mac OS X) for
wenzelm@62157
  2367
both Isabelle/ML and Isabelle/Scala.  Slightly reduced heap space usage.
wenzelm@62157
  2368
wenzelm@62017
  2369
* Former "xsymbols" syntax with Isabelle symbols is used by default,
wenzelm@62017
  2370
without any special print mode. Important ASCII replacement syntax
wenzelm@62017
  2371
remains available under print mode "ASCII", but less important syntax
wenzelm@62017
  2372
has been removed (see below).
wenzelm@62017
  2373
wenzelm@62109
  2374
* Support for more arrow symbols, with rendering in LaTeX and Isabelle
wenzelm@62109
  2375
fonts: \<Lleftarrow> \<Rrightarrow> \<longlongleftarrow> \<longlongrightarrow> \<longlonglongleftarrow> \<longlonglongrightarrow>.
wenzelm@62017
  2376
wenzelm@62108
  2377
* Special notation \<struct> for the first implicit 'structure' in the
wenzelm@62108
  2378
context has been discontinued. Rare INCOMPATIBILITY, use explicit
wenzelm@62108
  2379
structure name instead, notably in indexed notation with block-subscript
wenzelm@62108
  2380
(e.g. \<odot>\<^bsub>A\<^esub>).
wenzelm@62108
  2381
wenzelm@62108
  2382
* The glyph for \<diamond> in the IsabelleText font now corresponds better to its
wenzelm@62108
  2383
counterpart \<box> as quantifier-like symbol. A small diamond is available as
wenzelm@62108
  2384
\<diamondop>; the old symbol \<struct> loses this rendering and any special
wenzelm@62108
  2385
meaning.
wenzelm@62108
  2386
wenzelm@62017
  2387
* Syntax for formal comments "-- text" now also supports the symbolic
wenzelm@62017
  2388
form "\<comment> text". Command-line tool "isabelle update_cartouches -c" helps
wenzelm@62017
  2389
to update old sources.
wenzelm@62017
  2390
wenzelm@61337
  2391
* Toplevel theorem statements have been simplified as follows:
wenzelm@61337
  2392
wenzelm@61337
  2393
  theorems             ~>  lemmas
wenzelm@61337
  2394
  schematic_lemma      ~>  schematic_goal
wenzelm@61337
  2395
  schematic_theorem    ~>  schematic_goal
wenzelm@61337
  2396
  schematic_corollary  ~>  schematic_goal
wenzelm@61337
  2397
wenzelm@61337
  2398
Command-line tool "isabelle update_theorems" updates theory sources
wenzelm@61337
  2399
accordingly.
wenzelm@61337
  2400
wenzelm@61338
  2401
* Toplevel theorem statement 'proposition' is another alias for
wenzelm@61338
  2402
'theorem'.
wenzelm@61338
  2403
wenzelm@62169
  2404
* The old 'defs' command has been removed (legacy since Isabelle2014).
wenzelm@62169
  2405
INCOMPATIBILITY, use regular 'definition' instead. Overloaded and/or
wenzelm@62169
  2406
deferred definitions require a surrounding 'overloading' block.
wenzelm@62169
  2407
wenzelm@61337
  2408
wenzelm@60610
  2409
*** Prover IDE -- Isabelle/Scala/jEdit ***
wenzelm@60610
  2410
wenzelm@60986
  2411
* IDE support for the source-level debugger of Poly/ML, to work with
wenzelm@62253
  2412
Isabelle/ML and official Standard ML. Option "ML_debugger" and commands
wenzelm@62253
  2413
'ML_file_debug', 'ML_file_no_debug', 'SML_file_debug',
wenzelm@62253
  2414
'SML_file_no_debug' control compilation of sources with or without
wenzelm@62253
  2415
debugging information. The Debugger panel allows to set breakpoints (via
wenzelm@62253
  2416
context menu), step through stopped threads, evaluate local ML
wenzelm@62253
  2417
expressions etc. At least one Debugger view needs to be active to have
wenzelm@62253
  2418
any effect on the running ML program.
wenzelm@60984
  2419
wenzelm@61803
  2420
* The State panel manages explicit proof state output, with dynamic
wenzelm@61803
  2421
auto-update according to cursor movement. Alternatively, the jEdit
wenzelm@61803
  2422
action "isabelle.update-state" (shortcut S+ENTER) triggers manual
wenzelm@61803
  2423
update.
wenzelm@61729
  2424
wenzelm@61729
  2425
* The Output panel no longer shows proof state output by default, to
wenzelm@61729
  2426
avoid GUI overcrowding. INCOMPATIBILITY, use the State panel instead or
wenzelm@61729
  2427
enable option "editor_output_state".
wenzelm@61215
  2428
wenzelm@61803
  2429
* The text overview column (status of errors, warnings etc.) is updated
wenzelm@61803
  2430
asynchronously, leading to much better editor reactivity. Moreover, the
wenzelm@61803
  2431
full document node content is taken into account. The width of the
wenzelm@61803
  2432
column is scaled according to the main text area font, for improved
wenzelm@61803
  2433
visibility.
wenzelm@61803
  2434
wenzelm@61803
  2435
* The main text area no longer changes its color hue in outdated
wenzelm@61803
  2436
situations. The text overview column takes over the role to indicate
wenzelm@61803
  2437
unfinished edits in the PIDE pipeline. This avoids flashing text display
wenzelm@61803
  2438
due to ad-hoc updates by auxiliary GUI components, such as the State
wenzelm@61803
  2439
panel.
wenzelm@61803
  2440
wenzelm@62254
  2441
* Slightly improved scheduling for urgent print tasks (e.g. command
wenzelm@62254
  2442
state output, interactive queries) wrt. long-running background tasks.
wenzelm@62017
  2443
wenzelm@62017
  2444
* Completion of symbols via prefix of \<name> or \<^name> or \name is
wenzelm@62017
  2445
always possible, independently of the language context. It is never
wenzelm@62017
  2446
implicit: a popup will show up unconditionally.
wenzelm@62017
  2447
wenzelm@62017
  2448
* Additional abbreviations for syntactic completion may be specified in
wenzelm@62017
  2449
$ISABELLE_HOME/etc/abbrevs and $ISABELLE_HOME_USER/etc/abbrevs, with
wenzelm@62017
  2450
support for simple templates using ASCII 007 (bell) as placeholder.
wenzelm@62017
  2451
wenzelm@62234
  2452
* Symbols \<oplus>, \<Oplus>, \<otimes>, \<Otimes>, \<odot>, \<Odot>, \<ominus>, \<oslash> no longer provide abbreviations for
wenzelm@62234
  2453
completion like "+o", "*o", ".o" etc. -- due to conflicts with other
wenzelm@62234
  2454
ASCII syntax. INCOMPATIBILITY, use plain backslash-completion or define
wenzelm@62234
  2455
suitable abbreviations in $ISABELLE_HOME_USER/etc/abbrevs.
wenzelm@62234
  2456
wenzelm@61483
  2457
* Action "isabelle-emph" (with keyboard shortcut C+e LEFT) controls
wenzelm@61483
  2458
emphasized text style; the effect is visible in document output, not in
wenzelm@61483
  2459
the editor.
wenzelm@61483
  2460
wenzelm@61483
  2461
* Action "isabelle-reset" now uses keyboard shortcut C+e BACK_SPACE,
wenzelm@61483
  2462
instead of former C+e LEFT.
wenzelm@61483
  2463
wenzelm@61512
  2464
* The command-line tool "isabelle jedit" and the isabelle.Main
wenzelm@62027
  2465
application wrapper treat the default $USER_HOME/Scratch.thy more
wenzelm@61512
  2466
uniformly, and allow the dummy file argument ":" to open an empty buffer
wenzelm@61512
  2467
instead.
wenzelm@61512
  2468
wenzelm@62017
  2469
* New command-line tool "isabelle jedit_client" allows to connect to an
wenzelm@62017
  2470
already running Isabelle/jEdit process. This achieves the effect of
wenzelm@62017
  2471
single-instance applications seen on common GUI desktops.
wenzelm@62017
  2472
wenzelm@61529
  2473
* The default look-and-feel for Linux is the traditional "Metal", which
wenzelm@61529
  2474
works better with GUI scaling for very high-resolution displays (e.g.
wenzelm@61529
  2475
4K). Moreover, it is generally more robust than "Nimbus".
wenzelm@61529
  2476
wenzelm@62163
  2477
* Update to jedit-5.3.0, with improved GUI scaling and support of
wenzelm@62163
  2478
high-resolution displays (e.g. 4K).
wenzelm@62163
  2479
wenzelm@62034
  2480
* The main Isabelle executable is managed as single-instance Desktop
wenzelm@62034
  2481
application uniformly on all platforms: Linux, Windows, Mac OS X.
wenzelm@62034
  2482
wenzelm@60610
  2483
wenzelm@61405
  2484
*** Document preparation ***
wenzelm@61405
  2485
wenzelm@62017
  2486
* Commands 'paragraph' and 'subparagraph' provide additional section
wenzelm@62017
  2487
headings. Thus there are 6 levels of standard headings, as in HTML.
wenzelm@62017
  2488
wenzelm@62017
  2489
* Command 'text_raw' has been clarified: input text is processed as in
wenzelm@62017
  2490
'text' (with antiquotations and control symbols). The key difference is
wenzelm@62017
  2491
the lack of the surrounding isabelle markup environment in output.
wenzelm@62017
  2492
wenzelm@62017
  2493
* Text is structured in paragraphs and nested lists, using notation that
wenzelm@62017
  2494
is similar to Markdown. The control symbols for list items are as
wenzelm@62017
  2495
follows:
wenzelm@62017
  2496
wenzelm@62017
  2497
  \<^item>  itemize
wenzelm@62017
  2498
  \<^enum>  enumerate
wenzelm@62017
  2499
  \<^descr>  description
wenzelm@62017
  2500
wenzelm@61491
  2501
* There is a new short form for antiquotations with a single argument
wenzelm@61491
  2502
that is a cartouche: \<^name>\<open>...\<close> is equivalent to @{name \<open>...\<close>} and
wenzelm@61595
  2503
\<open>...\<close> without control symbol is equivalent to @{cartouche \<open>...\<close>}.
wenzelm@61595
  2504
\<^name> without following cartouche is equivalent to @{name}. The
wenzelm@61501
  2505
standard Isabelle fonts provide glyphs to render important control
wenzelm@61501
  2506
symbols, e.g. "\<^verbatim>", "\<^emph>", "\<^bold>".
wenzelm@61491
  2507
wenzelm@61595
  2508
* Antiquotations @{noindent}, @{smallskip}, @{medskip}, @{bigskip} with
wenzelm@61595
  2509
corresponding control symbols \<^noindent>, \<^smallskip>, \<^medskip>, \<^bigskip> specify spacing formally, using
wenzelm@61595
  2510
standard LaTeX macros of the same names.
wenzelm@61595
  2511
wenzelm@61491
  2512
* Antiquotation @{cartouche} in Isabelle/Pure is the same as @{text}.
wenzelm@61491
  2513
Consequently, \<open>...\<close> without any decoration prints literal quasi-formal
wenzelm@61492
  2514
text. Command-line tool "isabelle update_cartouches -t" helps to update
wenzelm@61492
  2515
old sources, by approximative patching of the content of string and
wenzelm@61492
  2516
cartouche tokens seen in theory sources.
wenzelm@61491
  2517
wenzelm@61491
  2518
* The @{text} antiquotation now ignores the antiquotation option
wenzelm@61491
  2519
"source". The given text content is output unconditionally, without any
wenzelm@61491
  2520
surrounding quotes etc. Subtle INCOMPATIBILITY, put quotes into the
wenzelm@61494
  2521
argument where they are really intended, e.g. @{text \<open>"foo"\<close>}. Initial
wenzelm@61494
  2522
or terminal spaces are ignored.
wenzelm@61491
  2523
wenzelm@62017
  2524
* Antiquotations @{emph} and @{bold} output LaTeX source recursively,
wenzelm@62017
  2525
adding appropriate text style markup. These may be used in the short
wenzelm@62017
  2526
form \<^emph>\<open>...\<close> and \<^bold>\<open>...\<close>.
wenzelm@62017
  2527
wenzelm@62017
  2528
* Document antiquotation @{footnote} outputs LaTeX source recursively,
wenzelm@62017
  2529
marked as \footnote{}. This may be used in the short form \<^footnote>\<open>...\<close>.
wenzelm@62017
  2530
wenzelm@62017
  2531
* Antiquotation @{verbatim [display]} supports option "indent".
wenzelm@62017
  2532
wenzelm@62017
  2533
* Antiquotation @{theory_text} prints uninterpreted theory source text
wenzelm@62231
  2534
(Isar outer syntax with command keywords etc.). This may be used in the
wenzelm@62231
  2535
short form \<^theory_text>\<open>...\<close>. @{theory_text [display]} supports option "indent".
wenzelm@62017
  2536
wenzelm@62017
  2537
* Antiquotation @{doc ENTRY} provides a reference to the given
wenzelm@62017
  2538
documentation, with a hyperlink in the Prover IDE.
wenzelm@62017
  2539
wenzelm@62017
  2540
* Antiquotations @{command}, @{method}, @{attribute} print checked
wenzelm@62017
  2541
entities of the Isar language.
wenzelm@62017
  2542
wenzelm@61471
  2543
* HTML presentation uses the standard IsabelleText font and Unicode
wenzelm@61471
  2544
rendering of Isabelle symbols like Isabelle/Scala/jEdit.  The former
wenzelm@61488
  2545
print mode "HTML" loses its special meaning.
wenzelm@61471
  2546
wenzelm@61405
  2547
wenzelm@60406
  2548
*** Isar ***
wenzelm@60406
  2549
wenzelm@62205
  2550
* Local goals ('have', 'show', 'hence', 'thus') allow structured rule
wenzelm@62205
  2551
statements like fixes/assumes/shows in theorem specifications, but the
wenzelm@62205
  2552
notation is postfix with keywords 'if' (or 'when') and 'for'. For
wenzelm@60555
  2553
example:
wenzelm@60414
  2554
wenzelm@60414
  2555
  have result: "C x y"
wenzelm@60414
  2556
    if "A x" and "B y"
wenzelm@60414
  2557
    for x :: 'a and y :: 'a
wenzelm@60414
  2558
    <proof>
wenzelm@60414
  2559
wenzelm@60449
  2560
The local assumptions are bound to the name "that". The result is
wenzelm@60449
  2561
exported from context of the statement as usual. The above roughly
wenzelm@60414
  2562
corresponds to a raw proof block like this:
wenzelm@60414
  2563
wenzelm@60414
  2564
  {
wenzelm@60414
  2565
    fix x :: 'a and y :: 'a
wenzelm@60449
  2566
    assume that: "A x" "B y"
wenzelm@60414
  2567
    have "C x y" <proof>
wenzelm@60414
  2568
  }
wenzelm@60414
  2569
  note result = this
wenzelm@60406
  2570
wenzelm@60555
  2571
The keyword 'when' may be used instead of 'if', to indicate 'presume'
wenzelm@60555
  2572
instead of 'assume' above.
wenzelm@60555
  2573
wenzelm@61733
  2574
* Assumptions ('assume', 'presume') allow structured rule statements
wenzelm@61733
  2575
using 'if' and 'for', similar to 'have' etc. above. For example:
wenzelm@61658
  2576
wenzelm@61658
  2577
  assume result: "C x y"
wenzelm@61658
  2578
    if "A x" and "B y"
wenzelm@61658
  2579
    for x :: 'a and y :: 'a
wenzelm@61658
  2580
wenzelm@61658
  2581
This assumes "\<And>x y::'a. A x \<Longrightarrow> B y \<Longrightarrow> C x y" and produces a general
wenzelm@61658
  2582
result as usual: "A ?x \<Longrightarrow> B ?y \<Longrightarrow> C ?x ?y".
wenzelm@61658
  2583
wenzelm@61658
  2584
Vacuous quantification in assumptions is omitted, i.e. a for-context
wenzelm@61658
  2585
only effects propositions according to actual use of variables. For
wenzelm@61658
  2586
example:
wenzelm@61658
  2587
wenzelm@61658
  2588
  assume "A x" and "B y" for x and y
wenzelm@61658
  2589
wenzelm@61658
  2590
is equivalent to:
wenzelm@61658
  2591
wenzelm@61658
  2592
  assume "\<And>x. A x" and "\<And>y. B y"
wenzelm@61658
  2593
wenzelm@60595
  2594
* The meaning of 'show' with Pure rule statements has changed: premises
wenzelm@60595
  2595
are treated in the sense of 'assume', instead of 'presume'. This means,
wenzelm@62205
  2596
a goal like "\<And>x. A x \<Longrightarrow> B x \<Longrightarrow> C x" can be solved completely as
wenzelm@62205
  2597
follows:
wenzelm@60595
  2598
wenzelm@60595
  2599
  show "\<And>x. A x \<Longrightarrow> B x \<Longrightarrow> C x"
wenzelm@60595
  2600
wenzelm@60595
  2601
or:
wenzelm@60595
  2602
wenzelm@60595
  2603
  show "C x" if "A x" "B x" for x
wenzelm@60595
  2604
wenzelm@60595
  2605
Rare INCOMPATIBILITY, the old behaviour may be recovered as follows:
wenzelm@60595
  2606
wenzelm@60595
  2607
  show "C x" when "A x" "B x" for x
wenzelm@60595
  2608
wenzelm@60459
  2609
* New command 'consider' states rules for generalized elimination and
wenzelm@60459
  2610
case splitting. This is like a toplevel statement "theorem obtains" used
wenzelm@60459
  2611
within a proof body; or like a multi-branch 'obtain' without activation
wenzelm@60459
  2612
of the local context elements yet.
wenzelm@60459
  2613
wenzelm@60455
  2614
* Proof method "cases" allows to specify the rule as first entry of
wenzelm@60455
  2615
chained facts.  This is particularly useful with 'consider':
wenzelm@60455
  2616
wenzelm@60455
  2617
  consider (a) A | (b) B | (c) C <proof>
wenzelm@60455
  2618
  then have something
wenzelm@60455
  2619
  proof cases
wenzelm@60455
  2620
    case a
wenzelm@60455
  2621
    then show ?thesis <proof>
wenzelm@60455
  2622
  next
wenzelm@60455
  2623
    case b
wenzelm@60455
  2624
    then show ?thesis <proof>
wenzelm@60455
  2625
  next
wenzelm@60455
  2626
    case c
wenzelm@60455
  2627
    then show ?thesis <proof>
wenzelm@60455
  2628
  qed
wenzelm@60455
  2629
wenzelm@60565
  2630
* Command 'case' allows fact name and attribute specification like this:
wenzelm@60565
  2631
wenzelm@60565
  2632
  case a: (c xs)
wenzelm@60565
  2633
  case a [attributes]: (c xs)
wenzelm@60565
  2634
wenzelm@60565
  2635
Facts that are introduced by invoking the case context are uniformly
wenzelm@60565
  2636
qualified by "a"; the same name is used for the cumulative fact. The old
wenzelm@60565
  2637
form "case (c xs) [attributes]" is no longer supported. Rare
wenzelm@60565
  2638
INCOMPATIBILITY, need to adapt uses of case facts in exotic situations,
wenzelm@60565
  2639
and always put attributes in front.
wenzelm@60565
  2640
wenzelm@60618
  2641
* The standard proof method of commands 'proof' and '..' is now called
wenzelm@60618
  2642
"standard" to make semantically clear what it is; the old name "default"
wenzelm@60618
  2643
is still available as legacy for some time. Documentation now explains
wenzelm@60618
  2644
'..' more accurately as "by standard" instead of "by rule".
wenzelm@60618
  2645
wenzelm@62017
  2646
* Nesting of Isar goal structure has been clarified: the context after
wenzelm@62017
  2647
the initial backwards refinement is retained for the whole proof, within
wenzelm@62017
  2648
all its context sections (as indicated via 'next'). This is e.g.
wenzelm@62017
  2649
relevant for 'using', 'including', 'supply':
wenzelm@62017
  2650
wenzelm@62017
  2651
  have "A \<and> A" if a: A for A
wenzelm@62017
  2652
    supply [simp] = a
wenzelm@62017
  2653
  proof
wenzelm@62017
  2654
    show A by simp
wenzelm@62017
  2655
  next
wenzelm@62017
  2656
    show A by simp
wenzelm@62017
  2657
  qed
wenzelm@62017
  2658
wenzelm@62017
  2659
* Command 'obtain' binds term abbreviations (via 'is' patterns) in the
wenzelm@62017
  2660
proof body as well, abstracted over relevant parameters.
wenzelm@62017
  2661
wenzelm@62017
  2662
* Improved type-inference for theorem statement 'obtains': separate
wenzelm@62017
  2663
parameter scope for of each clause.
wenzelm@62017
  2664
wenzelm@62017
  2665
* Term abbreviations via 'is' patterns also work for schematic
wenzelm@62017
  2666
statements: result is abstracted over unknowns.
wenzelm@62017
  2667
wenzelm@60631
  2668
* Command 'subgoal' allows to impose some structure on backward
wenzelm@60631
  2669
refinements, to avoid proof scripts degenerating into long of 'apply'
wenzelm@60631
  2670
sequences. Further explanations and examples are given in the isar-ref
wenzelm@60631
  2671
manual.
wenzelm@60631
  2672
wenzelm@62017
  2673
* Command 'supply' supports fact definitions during goal refinement
wenzelm@62017
  2674
('apply' scripts).
wenzelm@62017
  2675
wenzelm@61166
  2676
* Proof method "goal_cases" turns the current subgoals into cases within
wenzelm@61166
  2677
the context; the conclusion is bound to variable ?case in each case. For
wenzelm@61166
  2678
example:
wenzelm@60617
  2679
wenzelm@60617
  2680
lemma "\<And>x. A x \<Longrightarrow> B x \<Longrightarrow> C x"
wenzelm@60622
  2681
  and "\<And>y z. U y \<Longrightarrow> V z \<Longrightarrow> W y z"
wenzelm@61166
  2682
proof goal_cases
wenzelm@60622
  2683
  case (1 x)
wenzelm@60622
  2684
  then show ?case using \<open>A x\<close> \<open>B x\<close> sorry
wenzelm@60622
  2685
next
wenzelm@60622
  2686
  case (2 y z)
wenzelm@60622
  2687
  then show ?case using \<open>U y\<close> \<open>V z\<close> sorry
wenzelm@60622
  2688
qed
wenzelm@60622
  2689
wenzelm@60622
  2690
lemma "\<And>x. A x \<Longrightarrow> B x \<Longrightarrow> C x"
wenzelm@60622
  2691
  and "\<And>y z. U y \<Longrightarrow> V z \<Longrightarrow> W y z"
wenzelm@61166
  2692
proof goal_cases
wenzelm@60617
  2693
  case prems: 1
wenzelm@60617
  2694
  then show ?case using prems sorry
wenzelm@60617
  2695
next
wenzelm@60617
  2696
  case prems: 2
wenzelm@60617
  2697
  then show ?case using prems sorry
wenzelm@60617
  2698
qed
wenzelm@60578
  2699
wenzelm@60581
  2700
* The undocumented feature of implicit cases goal1, goal2, goal3, etc.
wenzelm@60617
  2701
is marked as legacy, and will be removed eventually. The proof method
wenzelm@60617
  2702
"goals" achieves a similar effect within regular Isar; often it can be
wenzelm@60617
  2703
done more adequately by other means (e.g. 'consider').
wenzelm@60581
  2704
wenzelm@62017
  2705
* The vacuous fact "TERM x" may be established "by fact" or as `TERM x`
<