NEWS

   1 This file contains a summary of important user-visible changes.
   2
   3 Changes since 1.8
   4 =================
   5
   6 New Features:
   7 * A new parametric theory of sequences whose syntax is compatible with the
   8   syntax for sequences used by Z3.
   9 * Arrays: Added support for an `eqrange` predicate. `(eqrange a b i j)` is true
  10   if arrays `a` and `b` are equal on all indices within indices `i` and `j`.
  11 * Support for an integer operator `(_ iand n)` that returns the bitwise `and`
  12   of two integers, seen as integers modulo n.
  13
  14 Improvements:
  15 * New API: Added functions to retrieve the heap/nil term when using separation
  16   logic.
  17
  18 Changes:
  19 * SyGuS: Removed support for SyGuS-IF 1.0.
  20 * Removed Java and Python bindings for the legacy API
  21 * Interactive shell: the GPL-licensed Readline library has been replaced the
  22   BSD-licensed Editline. Compiling with `--best` now enables Editline, instead
  23   of Readline. Without selecting optional GPL components, Editline-enabled CVC4
  24   builds will be BSD licensed.
  25 * The semantics for division and remainder operators in the CVC language now
  26   correspond to SMT-LIB 2.6 semantics (i.e. a division by zero or a zero
  27   modulus results in a constant value, instead of an uninterpreted one).
  28   Similarly, when no language is set, the API semantics now correspond to the
  29   SMT-LIB 2.6 semantics.
  30 * The `competition` build type includes the dependencies used for SMT-COMP by
  31   default. Note that this makes this build type produce GPL-licensed binaries.
  32 * Bit-vector operator bvxnor was previously mistakenly marked as
  33   left-assoicative in SMT-LIB. This has recently been corrected in SMT-LIB. We
  34   now restrict bvxnor to only allow two operands in order to avoid confusion
  35   about the semantics, since the behavior of n-ary operands to bvxnor is now
  36   undefined in SMT-LIB.
  37
  38
  39 Changes since 1.7
  40 =================
  41
  42 New Features:
  43 * New C++ and Python API: CVC4 has a new, more streamlined API. We plan to
  44   make CVC4 1.8 the last version that ships with the legacy API.
  45 * Strings: Full support of the new SMT-LIB standard for the theory of strings,
  46   including:
  47   * Support for `str.replace_re`, `str.replace_re_all`, `str.is_digit`,
  48     `str.from_code`, `re.diff`, and `re.comp`
  49   * Support for new operator names (e.g. `str.in_re` instead of `str.in.re`),
  50     new escape sequences. The new syntax is enabled by default for smt2 files.
  51 * Support for syntax-guided synthesis (SyGuS) problems in the new API. C++
  52   examples of the SyGuS API can be found in `./examples/api/sygus_*.cpp`.
  53 * Support for higher-order constraints. This includes treating function sorts
  54   (constructible by `->`) as first-class sorts and handling partially applied
  55   function symbols. Support for higher-order constraints can be enabled by
  56   the option `--uf-ho`.
  57 * Support for set comprehension binders `comprehension`.
  58 * Eager bit-blasting: Support for SAT solver Kissat.
  59
  60 Improvements:
  61 * API: Function definitions can now be requested to be global. If the `global`
  62   parameter is set to true, they persist after popping the user context.
  63 * Java/Python bindings: The bindings now allow users to catch exceptions
  64 * Arithmetic: Performance improvements
  65   * Linear solver: New lemmas inspired by unit-cube tests
  66   * Non-linear solver: Expanded set of axioms
  67 * Ackermannization: The Ackermannization preprocessing pass now supports
  68   uninterpreted sorts and as a result all QF_UFBV problems are supported in
  69   combination with eager bit blasting.
  70
  71 Changes:
  72 * CVC language: Models printed in the CVC language now include an explicit end
  73   marker to facilitate the communication over pipes with CVC4.
  74 * API change: `SmtEngine::query()` has been renamed to
  75   `SmtEngine::checkEntailed()` and `Result::Validity` has been renamed to
  76   `Result::Entailment` along with corresponding changes to the enum values.
  77 * Java API change: The name of CVC4's package is now `edu.stanford.CVC4`
  78   instead of `edu.nyu.acsys.CVC4`.
  79 * The default output language is changed from CVC to SMT-LIB 2.6. The
  80   default output language is used when the problem language cannot be
  81   easily inferred (for example when CVC4 is used from the API).
  82 * Printing of BV constants: previously CVC4 would print BV constant
  83   values as indexed symbols by default and in binary notation with the
  84   option --bv-print-consts-in-binary. To be SMT-LIB compliant the
  85   default behavior is now to print BV constant values in binary
  86   notation and as indexed symbols with the new option
  87   --bv-print-consts-as-indexed-symbols. The option
  88   --bv-print-consts-in-binary has been removed.
  89 * Updated to SyGuS language version 2.0 by default. This is the last release
  90   that will support the SyGuS language version 1.0 (`--lang=sygus1`). A
  91   script is provided to convert version 1.0 files to version 2.0, see
  92   `./contrib/sygus-v1-to-v2.sh`.
  93 * Support for user-provided rewrite rule quantifiers have been removed.
  94 * Support for certain option aliases have been removed.
  95 * Support for parallel portfolio builds has been removed.
  96
  97 Changes since 1.6
  98 =================
  99
 100 New Features:
 101 * Proofs:
 102   * Support for bit-vector proofs with eager bitblasting (older versions only
 103     supported proofs with lazy bitblasting).
 104 * Strings:
 105   * Support for `str.replaceall` operator.
 106   * New option `--re-elim` to reduce regular expressions to extended string
 107     operators, resulting in better performance on regular expression benchmarks
 108     (enabled by default).
 109 * SyGuS:
 110   * Support for abduction (`--sygus-abduct`). Given a formula, this option uses
 111     CVC4's SyGuS solver to find a sufficient condition such that the
 112     conjunction of the condition and the formula is unsatisfiable.
 113   * Support for two new term enumerator strategies: variable agnostic
 114     (`--sygus-active-gen=var-agnostic`) and fast (`--sygus-active-gen=enum`).
 115     By default, CVC4 tries to choose the best term enumerator strategy
 116     automatically based on the input (`--sygus-active-gen=auto`).
 117   * Support for streaming solutions of increasingly smaller size when using the
 118     PBE solver (`--sygus-stream --sygus-pbe`). After the first solution is found
 119     and printed, the solver will continue to look for new solutions and print
 120     those, if any, that are smaller than previously printed solutions.
 121   * Support for unification-based techniques in non-separable specifications
 122     (`--sygus-unif`). For solving invariant problems a dedicate mode
 123     (`--sygus-unif-boolean-heuristic-dt`) is available that builds candidate
 124     solutions using heuristic decision tree learning.
 125
 126 Improvements:
 127 * Strings:
 128   * Significantly better performance on string benchmarks over the core theory
 129     and those with extended string functions like substring, contains, and
 130     replace.
 131
 132 Changes:
 133 * API change: Expr::iffExpr() is renamed to Expr::eqExpr() to reflect its
 134               actual behavior.
 135 * Compiling the language bindings now requires SWIG 3 instead of SWIG 2.
 136 * The CVC3 compatibility layer has been removed.
 137 * The build system now uses CMake instead of Autotools. Please refer to
 138   [INSTALL.md](https://github.com/CVC4/CVC4/blob/master/INSTALL.md) for
 139   up-to-date instructions on how to build CVC4.
 140
 141 Changes since 1.5
 142 =================
 143
 144 New Features:
 145 * A new theory of floating points.
 146 * Novel approach for solving quantified bit-vectors (BV).
 147 * Eager bit-blasting: Support for SAT solver CaDiCaL.
 148 * A new Gaussian Elimination preprocessing pass for the theory of bit-vectors.
 149 * Support for transcendental functions (sin, cos, exp). In SMT2 input, this
 150   can be enabled by adding T to the logic (e.g., QF_NRAT).
 151 * Support for new operators in strings, including string inequality (str.<=)
 152   and string code (str.code).
 153 * Support for automated rewrite rule generation from sygus (*.sy) inputs using
 154   syntax-guided enumeration (option --sygus-rr).
 155
 156 Improvements:
 157 * Incremental unsat core support.
 158 * Further development of rewrite rules for the theory of strings and regular
 159   expressions.
 160 * Many optimizations for syntax-guided synthesis, including improved symmetry
 161   breaking for enumerative search and specialized algorithms for
 162   programming-by-examples conjectures.
 163
 164 Changes:
 165 * Eager bit-blasting: Removed support for SAT solver CryptoMinisat 4, added
 166   support for CryptoMinisat 5.
 167 * The LFSC proof checker now resides in its own repository on GitHub at
 168   https://github.com/CVC4/LFSC. It is not distributed with CVC4 anymore.
 169
 170 Changes since 1.4
 171 =================
 172
 173 * Improved heuristics for reasoning about non-linear arithmetic.
 174 * Native support for syntax-guided synthesis (sygus).
 175 * Support for many new heuristics for reasoning with quantifiers, including
 176   finite model finding.
 177 * Support for proofs for uninterpreted functions, arrays, bitvectors, and
 178   their combinations.
 179 * Performance improvements to existing theories.
 180 * A new theory of sets with cardinality and relations.
 181 * A new theory of strings.
 182 * Support for unsat cores.
 183 * Support for separation logic constraints.
 184 * Simplification mode "incremental" no longer supported.
 185 * Support for array constants in constraints.
 186 * Syntax for array models has changed in some language front-ends.
 187 * New input/output languages supported: "smt2.0" and "smtlib2.0" to
 188   force SMT-LIB v2.0; "smt2.5" and "smtlib2.5" to force SMT-LIB v2.5;
 189   "smt2.6" and "smtlib2.6" to force SMT-LIB v2.6;
 190   "smt", "smtlib", "smt2", and "smtlib2" all refer to the current standard
 191   version 2.6.  If an :smt-lib-version is set in the input, that overrides
 192   the command line.
 193 * Abstract values in SMT-LIB models are now ascribed types (with "as").
 194 * In SMT-LIB model output, real-sorted but integer-valued constants are
 195   now printed in accordance with the standard (e.g. "1.0").
 196
 197 Changes since 1.3
 198 =================
 199
 200 * CVC4 now supports libc++ in addition to libstdc++ (this especially
 201   helps on Mac OS Mavericks).
 202 * The LFSC proof checker has been incorporated into CVC4 sources.
 203 * Theory of finite sets, handling the MLSS fragment (singleton, union,
 204   intersection, set subtraction, membership and subset).
 205 * By default, CVC4 builds in "production" mode (optimized, with fewer
 206   internal checks on).  The common alternative is a "debug" build, which
 207   is much slower.  By default, CVC4 builds with no GPL'ed dependences.
 208   However, this is not the best-performing version; for that, you should
 209   configure with "--enable-gpl --best", which links against GPL'ed
 210   libraries that improve usability and performance.  For details on
 211   licensing and dependences, see the README file.
 212 * Small API adjustments to Datatypes to even out the API and make it
 213   function better in Java.
 214 * Timed statistics are now properly updated even on process abort.
 215 * Better automatic handling of output language setting when using CVC4
 216   via API.  Previously, the "automatic" language setting was sometimes
 217   (though not always) defaulting to the internal "AST" language; it
 218   should now (correctly) default to the same as the input language
 219   (if the input language is supported as an output language), or the
 220   "CVC4" native output language if no input language setting is applied.
 221 * The SmtEngine cannot be safely copied with the copy constructor.
 222   Previous versions inadvertently permitted clients to do this via the
 223   API.  This has been corrected, copy and assignment of the SmtEngine
 224   is no longer permitted.
 225
 226 Changes since 1.2
 227 =================
 228
 229 New features:
 230 * SMT-LIB-compliant support for abs, to_real, to_int, is_int, which were
 231   previously missing
 232 * New bv2nat/int2bv operators for bitvector/integer inter-compatibility.
 233 * Support in linear logics for /, div, and mod by constants (with the
 234   --rewrite-divk command line option).
 235 * Parsing support for TPTP's TFF and TFA formats.
 236 * A new theory of strings: word (dis-)equations, length constraints,
 237   regular expressions.
 238 * Increased compliance to SMT-LIBv2, numerous bugs and usability issues
 239   resolved.
 240 * New :command-verbosity SMT option to silence success and error messages
 241   on a per-command basis, and API changes to Command infrastructure to
 242   support this.
 243
 244 Behavioral changes:
 245 * It is no longer permitted to request model or proof generation if there's
 246   been an intervening push/pop.
 247 * User-defined symbols (define-funs) are no longer reported in the output
 248   of get-model commands.
 249 * Exit codes are now more standard for UNIX command-line tools.  Exit code
 250   zero means no error---but the result could be sat, unsat, or unknown---and
 251   nonzero means error.
 252
 253 API changes:
 254 * Expr::substitute() now capable of substituting operators (e.g.,
 255   function symbols under an APPLY_UF)
 256 * Numerous improvements to the Java language bindings
 257
 258 Changes since 1.1
 259 =================
 260
 261 * Real arithmetic now has three simplex solvers for exact precision linear
 262   arithmetic: the classical dual solver and two new solvers based on
 263   techniques for minimizing the sum of infeasibilities. GLPK can now be used
 264   as a heuristic backup to the exact precision solvers.  GLPK must be enabled
 265   at configure time. See --help for more information on enabling these solvers.
 266 * added support for "bit0" and "bit1" bitvector constants in SMT-LIB v1.2
 267 * support for theory "alternates": new ability to prototype new decision
 268   procedures that are selectable at runtime
 269 * various bugfixes
 270
 271 Changes since 1.0
 272 =================
 273
 274 * bit-vector solver now has a specialized decision procedure for unsigned bit-
 275   vector inequalities
 276 * numerous important bug fixes, performance improvements, and usability
 277   improvements
 278 * support for multiline input in interactive mode
 279 * Win32-building support via mingw
 280 * SMT-LIB get-model output now is easier to machine-parse: contains (model...)
 281 * user patterns for quantifier instantiation are now supported in the
 282   SMT-LIBv1.2 parser
 283 * --finite-model-find was incomplete when using --incremental, now fixed
 284 * the E-matching procedure is slightly improved
 285 * Boolean terms are now supported in datatypes
 286 * tuple and record support have been added to the compatibility library
 287 * driver verbosity change: for printing all commands as they're executed, you
 288   now need verbosity level >= 3 (e.g., -vvv) instead of level 1 (-v).  This
 289   allows tracing the solver's activities (with -v and -vv) without having too
 290   much output.
 291 * to make CVC4 quieter in abnormal (e.g., "warning" conditions), you can
 292   use -q.  Previously, this would silence all output (including "sat" or
 293   "unsat") as well.  Now, single -q silences messages and warnings, and
 294   double -qq silences all output (except on exception or signal).