CHANGES.md 41.4 KB
Newer Older
1 2
# Changes

POTTIER Francois's avatar
POTTIER Francois committed
3 4
## 2020/12/XX

POTTIER Francois's avatar
POTTIER Francois committed
5 6 7
* The new command line switch `--require-aliases` causes Menhir to check
  that a token alias has been defined for every token.

POTTIER Francois's avatar
POTTIER Francois committed
8 9 10 11 12 13 14 15 16
* The escaped characters `\\`, `\'`, `\"`, `\n`, `\t`, `\b`, `\r`, `\ ` are
  now accepted in token aliases.

* If a token alias has been defined for every token, then, in every
  `.messages` file produced by Menhir, every sentence is now followed by its
  concrete syntax, in an auto-generated comment that begins with `## Concrete
  syntax: `. This feature relies on the assumption that the concrete syntax
  allows separating two tokens with a space character.

POTTIER Francois's avatar
POTTIER Francois committed
17 18 19 20 21 22 23 24 25
* Update the demo `calc-syntax-errors` to show how to compile a parser both
  via the code back-end and via the table back-end, so as to obtain both
  optimal performance and good error messages.

* Rename the undocumented option `--graph` to `--reference-graph`.

* Add an undocumented option `--automaton-graph` which produces an
  (incomplete) graphical representation of the LR(1) automaton.

POTTIER Francois's avatar
POTTIER Francois committed
26 27 28
* At log level `--log-automaton 2`, Menhir now shows which states have a
  conflict between multiple `%on_error_reduce` declarations.

POTTIER Francois's avatar
POTTIER Francois committed
29
## 2020/12/01
POTTIER Francois's avatar
POTTIER Francois committed
30 31

* The module `MenhirLib.ErrorReports` is extended with new functions:
POTTIER Francois's avatar
POTTIER Francois committed
32
  `wrap_supplier`, `extract`, `sanitize`, `compress`, `shorten`, `expand`.
POTTIER Francois's avatar
POTTIER Francois committed
33 34 35 36 37

* The new module `MenhirLib.LexerUtil` offers a few functions that help
  reading a file, setting up a lexing buffer, printing source code positions,
  etc.

POTTIER Francois's avatar
POTTIER Francois committed
38
* The new demo `calc-syntax-errors` demonstrates how to produce customized
POTTIER Francois's avatar
POTTIER Francois committed
39 40 41 42 43 44
  syntax error messages. Here are examples of the messages that this little
  parser can produce:

  Incorrect Input | Error Message
  --------------- | -------------
  [calc01.in](demos/calc-syntax-errors/calc01.in) | [calc01.exp](demos/calc-syntax-errors/calc01.exp)
POTTIER Francois's avatar
POTTIER Francois committed
45 46 47 48 49 50
  [calc02.in](demos/calc-syntax-errors/calc02.in) | [calc02.exp](demos/calc-syntax-errors/calc02.exp)
  [calc03.in](demos/calc-syntax-errors/calc03.in) | [calc03.exp](demos/calc-syntax-errors/calc03.exp)
  [calc04.in](demos/calc-syntax-errors/calc04.in) | [calc04.exp](demos/calc-syntax-errors/calc04.exp)
  [calc05.in](demos/calc-syntax-errors/calc05.in) | [calc05.exp](demos/calc-syntax-errors/calc05.exp)
  [calc06.in](demos/calc-syntax-errors/calc06.in) | [calc06.exp](demos/calc-syntax-errors/calc06.exp)
  [calc07.in](demos/calc-syntax-errors/calc07.in) | [calc07.exp](demos/calc-syntax-errors/calc07.exp)
POTTIER Francois's avatar
POTTIER Francois committed
51

POTTIER Francois's avatar
POTTIER Francois committed
52 53 54 55 56
* The new command `--merge-errors` merges two `.messages` files. It can be
  useful when two or more users have independently produced partial
  `.messages` files and wish to combine their work.
  (Suggested by Gabriel Scherer and François Bobot.)

POTTIER Francois's avatar
POTTIER Francois committed
57 58 59 60 61 62 63
* The commands that read `.messages` files have been hardened so as to
  tolerate situations where a sentence mentions a nonexistent symbol or does
  not lead to an error state. When such a sentence is encountered, an error
  message is produced on the standard error channel; then, this sentence is
  ignored and processing continues. (As an exception, the command
  `--compile-errors` refuses to proceed in the presence of such sentences.)

64
## 2020/11/22
POTTIER Francois's avatar
POTTIER Francois committed
65 66

* The new command line switch `--dump-resolved` writes a description of the
67 68 69
  automaton to the file `.automaton.resolved` after all conflicts have been
  resolved and after extra reductions have been introduced. This file also
  shows which states have a default reduction.
POTTIER Francois's avatar
POTTIER Francois committed
70 71

* The command line switch `--dump` writes a description of the automaton to
72 73 74 75
  the file `.automaton` after benign conflicts have been silently resolved,
  but *before* severe conflicts are resolved and before extra reductions are
  introduced. (This behavior is unchanged.) The manner in which end-of-stream
  conflicts are displayed in this file has been improved.
POTTIER Francois's avatar
POTTIER Francois committed
76

77 78
* In the files `.automaton` and `.automaton.resolved`, the reduction table in
  each state is now presented in a much more compact and readable way.
POTTIER Francois's avatar
POTTIER Francois committed
79

POTTIER Francois's avatar
POTTIER Francois committed
80 81 82 83
* In the files `.automaton` and `.automaton.resolved`, the known suffix of the
  stack in each state is now explicitly shown. (Although it can be deduced
  from the LR(1) items, showing it helps.)

84 85 86
* Document the problem caused by placing a module alias declaration
  in an `.mly` file. (See *Questions and Answers* in the manual.)

POTTIER Francois's avatar
POTTIER Francois committed
87 88 89 90
* Turn off a costly internal well-formedness assertion.
  This allows a 30% speedup in the construction of large automata
  and in the conflict explanation process. (Reported by Joe.)

POTTIER Francois's avatar
POTTIER Francois committed
91 92 93 94 95 96
## 2020/06/24

* Fix a bug introduced on 2020/02/11 that causes all reduce/reduce conflicts
  to be mistakenly declared unexplainable, provided the grammar has at least
  62 terminal symbols. (Reported by Joe.)

POTTIER Francois's avatar
POTTIER Francois committed
97 98 99 100 101 102 103 104
## 2020/06/19

* Fix the suggestions printed by `--suggest-link-flags-byte` and
  `--suggest-link-flags-opt` so as to suggest `menhirLib.cma` or
  `menhirLib.cmxa` instead of `menhirLib.cmo` or `menhirLib.cmx`. This change
  should have been made on 2020/01/21, when we switched to automated
  installation via `opam` and `dune`.

POTTIER Francois's avatar
POTTIER Francois committed
105 106 107 108 109 110 111
## 2020/06/12

* When a semantic value is unused in a semantic action, the warning (or error)
  should now be correctly reported in the `.mly` file, not in a generated
  `.ml` file. (This works only when `--infer` is enabled, because we are lazy.
  If you use `dune`, this works out of the box.)

POTTIER Francois's avatar
POTTIER Francois committed
112 113 114 115 116 117 118
## 2020/05/25

* Fix a problem that could arise when an open polymorphic variant, such as
  ```[> `A ]```, was used in a `%type` or `%start` declaration. A type that
  was too general could possibly be inferred. This could in turn lead to an
  incorrect compilation of pattern matching and to a segmentation fault.
  (Problem reported by Joe.)
119 120 121

* Fix the static check that is performed prior to expanding the parameterized
  nonterminal symbols. The previous check was incorrect: it would sometimes
POTTIER Francois's avatar
POTTIER Francois committed
122
  accept a grammar whose expansion would diverge. (Fix by Yann Régis-Gianas.)
123

124
## 2020/02/11
125

POTTIER Francois's avatar
POTTIER Francois committed
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151
* Re-implement Menhir's default algorithm for constructing LR(1) automata,
  namely Pager's algorithm. This closes issue #21 (reported by Andrej Bauer),
  a bug that would sometimes cause unexplainable conflicts to appear, because
  states were merged too aggressively. This also removes an unreported bug
  that would cause the automaton to have too many states, because states were
  *not* merged aggressively enough. In summary, the old and new construction
  algorithms differ: in many cases, the resulting automaton is unchanged, but
  in some cases, the automaton produced by the new algorithm may have slightly
  more or slightly fewer states.

* Re-implement Menhir's algorithm for constructing automata in `--no-pager`
  mode. In this (undocumented) mode, Menhir does not merge any states, but
  allows itself to redirect a transition from a state `s` to a *larger* state
  `s'`. This method yields an automaton whose states form a subset of the
  states of the canonical LR(1) automaton. It usually has significantly fewer
  states than the canonical automaton, and significantly more states than the
  automaton produced by Pager's algorithm. The new construction method removes
  an unreported bug that would cause the automaton to have too many states.
  The automaton produced by the new algorithm will usually have significantly
  fewer states than the automaton produced by the previous algorithm.

* Re-implement Menhir's algorithms for constructing automata in `--lalr` and
  `--canonical` modes. The previous algorithms were correct, as far as we
  know, so the output of the new algorithms is the same, up to a possible
  renumbering of the states. The new algorithms are slightly faster.

152 153
* Increase the maximum length of a production, which used to be 127,
  up to 1023. Display a polite error message if this length is exceeded.
POTTIER Francois's avatar
POTTIER Francois committed
154
  (Problem reported by Andreas Abel.)
155

156 157 158
* The new switch `--timings-to <filename>` causes internal timing
  information to be written to the file `<filename>`.

POTTIER Francois's avatar
Typo.  
POTTIER Francois committed
159
* A version of the library `fix` is now vendored (included) inside Menhir.
160 161 162
  This should have no impact for end users, but implies that `dune` 2.2.0
  or later is required.

163 164 165 166 167 168 169
## 2020/01/21

* There used to be a distinction between two slightly different ways of
  installing Menhir, namely with and without `ocamlfind`. This distinction
  disappears. The command line switch `--suggest-ocamlfind` is deprecated
  and causes Menhir to print `false`.

POTTIER Francois's avatar
POTTIER Francois committed
170 171 172 173 174
* Menhir is now built and installed by `dune`. This should make life easier
  for Menhir's developers: in particular, `make test` and `make speed` can be
  run straight away and do not requiring installing Menhir first. This should
  also make compilation much faster on multi-core machines. (Contributed by
  Nicolás Ojeda Bär, to whom many thanks are due.)
175

POTTIER Francois's avatar
POTTIER Francois committed
176 177 178 179
## 2019/09/24

* Build Menhir's standard library into the Menhir executable instead of
  storing it in a separate file `standard.mly`. This removes the need to
POTTIER Francois's avatar
POTTIER Francois committed
180 181 182 183 184 185 186
  hardcode the path to this file into the Menhir executable. This also removes
  the need for the command line switch `--stdlib`, which remains supported but
  is now ignored, and for the environment variable `$MENHIR_STDLIB`, which is
  now ignored. A positive side effect of this change is that the full path of
  the file `standard.mly` no longer appears in generated parsers; this removes
  a source of spurious variation. (Suggested and implemented by Nicolás Ojeda
  Bär.)
POTTIER Francois's avatar
POTTIER Francois committed
187

188 189 190 191 192 193
## 2019/06/20

* When compiled with OCaml 4.02.3, Menhir could produce OCaml code
  containing invalid string literals. This was due to a problem in
  `String.escaped`. Fixed. (Reported by ELLIOTCABLE.)

POTTIER Francois's avatar
POTTIER Francois committed
194
## 2019/06/13
195

196 197 198 199
* Relax the syntax of point-free actions to allow `< >` (with arbitrary
  whitespace inside the angle brackets) instead of just `<>`.
  (Suggested by Lélio Brun.)

200 201 202 203
* When a cycle of `%inline` nonterminal symbols is encountered,
  the error message now shows the entire cycle,
  as opposed to just one symbol that participates in the cycle.

204 205 206 207 208
* Fix the treatment of the `error` token when printing the grammar for
  `ocamlyacc`. Its semantic value must not be referred to; a unit value
  must be used instead. The switch `--only-preprocess-for-ocamlyacc`
  remains undocumented. (Reported by kris.)

POTTIER Francois's avatar
POTTIER Francois committed
209
* Coq back-end: multiple changes to stay up-to-date with respect to
210
  coq-menhirlib. See [coq-menhirlib/CHANGES.md](coq-menhirlib/CHANGES.md).
Jacques-Henri Jourdan's avatar
Jacques-Henri Jourdan committed
211

POTTIER Francois's avatar
POTTIER Francois committed
212 213
* Coq back-end: the generated parser now contains a dedicated inductive
  type for tokens. This removes the need for `Obj.magic` in client code
Jacques-Henri Jourdan's avatar
Jacques-Henri Jourdan committed
214 215
  when the parser is used via extraction.

POTTIER Francois's avatar
POTTIER Francois committed
216
* Coq back-end: the generated parser checks that the version of
Jacques-Henri Jourdan's avatar
Jacques-Henri Jourdan committed
217
  MenhirLib matches. This check can be disabled with
POTTIER Francois's avatar
POTTIER Francois committed
218
  `--coq-no-version-check`.
Jacques-Henri Jourdan's avatar
Jacques-Henri Jourdan committed
219

POTTIER Francois's avatar
POTTIER Francois committed
220
* Coq back-end: the fuel parameter is now given as the *logarithm* of
221
  the maximum number of steps to perform. Therefore, using e.g., 50
POTTIER Francois's avatar
POTTIER Francois committed
222
  makes sure we will not run out of fuel in any reasonable
223 224
  computation time.

POTTIER Francois's avatar
POTTIER Francois committed
225
## 2018/11/13
POTTIER Francois's avatar
POTTIER Francois committed
226 227 228 229 230 231

* In `.mly` files, a new syntax for rules has been introduced, which is
  slightly more pleasant than the old syntax. (A rule is the definition of a
  nonterminal symbol.) The old syntax remains available; the user chooses
  between the two syntaxes on a per-rule basis. The new syntax is fully
  documented in the manual;
POTTIER Francois's avatar
POTTIER Francois committed
232
  [a brief summary of the differences](doc/new-rule-syntax-summary.md)
POTTIER Francois's avatar
POTTIER Francois committed
233 234 235
  with respect to the old syntax is also available.
  **The new syntax is considered experimental**
  and is subject to change in the near future.
POTTIER Francois's avatar
POTTIER Francois committed
236 237 238 239 240

* In the Coq back-end, avoid pattern-matching at type `int31`,
  which will disappear in future versions of Coq.
  Instead, convert `int31` to `Z`, and perform pattern matching in `Z`.
  (Reported by Vincent Laporte, implemented by Jacques-Henri Jourdan.)
241

242 243 244 245 246
* Implement a more economical renaming scheme for OCaml variables
  during the elimination of `%inline` symbols. This leads to slightly
  more readable code (more reasonable variables names, fewer `let`
  bindings).

247 248 249
* Another attempt at removing all trailing spaces in auto-generated
  `.messages` files. (I hope I got it right, this time.)

250 251 252 253 254 255 256 257 258 259
## 2018/10/26

* A new syntactic sugar facility, "token aliases", has been added.
  The declaration of a terminal symbol may also declare an alias,
  which takes the form of a name between double quotes, as in
  `%token PLUS "+"`.
  Thereafter, `"+"` may be used freely in place of `PLUS` throughout
  the grammar. This makes it slightly easier to read grammars.
  (Contributed by Perry E. Metzger.)

260 261 262 263 264 265 266
* Until today, the semicolon character `;` was insignificant: it was
  considered as whitespace by Menhir. It is now accepted only in a
  few specific places, namely: after a declaration; after a rule;
  after a producer. If Menhir suddenly complains about a semicolon,
  just remove it. This change is being made in preparation for
  further syntactic changes.

267
* New flag `--no-dollars`, which disallows the use of `$i` in semantic actions.
268
  The default behavior remains to allow the use of `$i`.
269 270 271 272 273

* When generating OCaml code, include all record fields in record patterns,
  even when bound to a wildcard pattern. Thus, avoid triggering OCaml's
  warning 9.

274
## 2018/10/06
POTTIER Francois's avatar
POTTIER Francois committed
275

276
* Standard library: add `rev`, `flatten`, `append`.
277 278
  Add a link from the manual to `standard.mly` in the repository.

279 280
* Update the manual to explain how to use `dune` and `menhir` together.

POTTIER Francois's avatar
POTTIER Francois committed
281
* Install `.cmxs` files for menhirLib and menhirSdk.
282

283 284 285 286
* Remove all references to `Pervasives` in the generated OCaml code.
  These references were infrequent anyway,
  and `Pervasives` is about to be deprecated in OCaml 4.08, it seems.

287 288
* In `--interpret` mode, print `Ready!` once ready to accept input.

289 290 291 292 293 294
* At verbosity level `-lg 2`, for each nonterminal symbol `N`, display
  a sentence (composed of terminal symbols) of minimal length generated
  by `N`.

* When writing a `.cmly` file, open it in binary mode. This should
  eliminate the failure that was observed under Windows:
295 296 297 298 299
  `output_value: not a binary channel`. (Reported by Bryan Phelps.
  A fix was present in the `mingw` patches for Menhir.)

* Change the logic used in the root `Makefile` to deal with Unix and Windows
  in a uniform way. (Also inspired by the `mingw` patches for Menhir.)
300

301 302 303
* Coq back-end: add a few newlines in the generated file for readability.
  (Suggested by Bernhard Schommer.)

304 305 306
* Remove the trailing space at the end of every sentence in
  auto-generated `.messages` files. (Suggested by Xavier Leroy.)

307 308 309 310 311 312 313 314 315 316
## 2018/09/05

* When `--explain` is enabled, always create a fresh `.conflicts` file
  (wiping out any pre-existing file), even if there are in fact no conflicts.
  This should avoid confusion with outdated `.conflicts` files.

* Fix several bugs in the treatment of `--strict`. No `.conflicts` file
  was created when `--strict` and `--explain` were both enabled. Also,
  some warnings were not properly turned into errors by `--strict`.

317 318 319 320
## 2018/07/04

* Update the `man` page, which was woefully out of date.

321 322 323 324 325 326 327 328
## 2018/07/03

* New location keywords.
  `$loc` is sugar for the pair `($startpos, $endpos)`.
  `$loc(x)` is sugar for the pair `($startpos(x), $endpos(x))`.
  `$sloc` is sugar for the pair `($symbolstartpos, $endpos)`.
  (Contributed by Nicolás Ojeda Bär.)

329 330 331 332 333 334 335 336
## 2018/06/08

* Add two new parameterized nonterminal symbols, `endrule(X)` and `midrule(X)`,
  to the standard library. These symbols have been available since 2015/02/11
  under the names `anonymous(X)` and `embedded(X)`, but were not yet documented.
  `endrule(X)` and `midrule(X)` are now documented,
  while `anonymous(X)` and `embedded(X)` remain present but are deprecated.

337 338 339 340 341 342 343 344 345 346 347 348 349 350
## 2018/05/30

* In `--coq` mode, Menhir now produces references to `MenhirLib.Grammar`
  instead of just `Grammar`, and similarly for all modules in Menhir's support
  library.

* New command line option `--coq-lib-no-path` to suppress the above behavior
  and retain the previous (now-deprecated) behavior, that is, produce
  unqualified references the modules in Menhir's support library.

* New command line option `--coq-lib-path <path>` to indicate under what name
  (or path) the support library has been installed. Its default value is
  `MenhirLib`.

POTTIER Francois's avatar
POTTIER Francois committed
351 352 353
## 2018/05/23

* New commands `--infer-write-query`, `--infer-read-reply`, and
354 355 356 357 358 359 360 361 362 363 364 365
  `--infer-protocol-supported`. These commands remove the need for Menhir to
  invoke `ocamlc` and `ocamldep` behind the scenes, and make it easier to
  write correct build rules for Menhir projects. The command line options
  `--infer`, `--raw-depend` and `--depend` remain supported, but are no longer
  preferred. (Suggested by Fabrice Le Fessant.)

* Remove the warning that was issued when `%inline` was used but `--infer` was
  turned off. Most people should use a build system that knows how to enable
  OCaml type inference, such as `ocamlbuild` or `dune`.

* New HTML rendering of the manual, available both online and as part of
  Menhir's installation. (Implemented by Gabriel Scherer.)
POTTIER Francois's avatar
POTTIER Francois committed
366

367 368 369 370 371 372
## 2017/12/22

* Add a flag `--unused-precedence-levels` to suppress all warnings about
  useless `%left`, `%right`, `%nonassoc` and `%prec` declarations.
  (Suggested by Zachary Tatlock.)

POTTIER Francois's avatar
POTTIER Francois committed
373 374 375 376
## 2017/12/06

* Fix the termination test that takes place before parameterized symbols are
  expanded away. The previous test was both unsound (it would accept grammars
POTTIER Francois's avatar
POTTIER Francois committed
377 378 379
  whose expansion did not terminate) and incomplete (it would reject grammars
  whose expansion did terminate). The new test is believed to be sound and
  complete. (Thanks to Martin Bodin for prompting us to look into this issue.)
POTTIER Francois's avatar
POTTIER Francois committed
380

POTTIER Francois's avatar
POTTIER Francois committed
381 382 383 384 385
## 2017/11/12

* Documentation: clarify the fact that `%type` declarations should carry types
  whose meaning does not depend on the headers `%{ ... %}`.

386 387 388 389 390 391
## 2017/10/13

* Remove the OCaml version check at installation time, for greater simplicity,
  and because for some reason it did not work properly under Cygwin.
  (Reported by Andrew Appel.)

392 393 394 395 396 397 398
## 2017/09/26

* `Makefile` fix: when determining whether the suffix `.exe` should be used,
  one should test whether the OS is Windows,
  not whether the compiler is MSVC.
  (Suggested by Jonathan Protzenko.)

POTTIER Francois's avatar
POTTIER Francois committed
399 400 401 402 403 404 405 406
## 2017/07/12

* Include the LaTeX sources of the manual in the official `.tar.gz` archive.
  This should allow the manual to be included as part of the Debian package.

* Mention [Obelisk](https://github.com/Lelio-Brun/Obelisk),
  a pretty-printer for `.mly` files, in the manual.

407 408 409 410 411
## 2017/06/07

* Removed an undeclared dependency of MenhirSdk on Unix. (Reported and fixed
  by Frédéric Bour.)

POTTIER Francois's avatar
POTTIER Francois committed
412 413 414 415 416 417 418 419
## 2017/05/09

* Menhir now always places OCaml line number directives in the generated `.ml`
  file. (Until now, this was done only when `--infer` was off.) Thus, if a
  semantic action contains an `assert` statement, the file name and line
  number information carried by the `Assert_failure` exception should now be
  correct. (Reported by Helmut Brandl.)

POTTIER Francois's avatar
POTTIER Francois committed
420
## 2017/04/18
POTTIER Francois's avatar
POTTIER Francois committed
421

POTTIER Francois's avatar
POTTIER Francois committed
422 423
* Changed Menhir's license from QPL to GPLv2.
  MenhirLib remains under LGPLv2, with a linking exception.
POTTIER Francois's avatar
POTTIER Francois committed
424

POTTIER Francois's avatar
POTTIER Francois committed
425 426 427 428 429 430 431 432 433 434 435 436 437 438 439
* Moved the repository to
  [gitlab.inria.fr](https://gitlab.inria.fr/fpottier/menhir/).

* Introduced a new command line switch, `--cmly`, which causes Menhir to
  create a `.cmly` file, containing a description of the grammar and
  automaton. (Suggested by Frédéric Bour.)

* Introduced a new library, MenhirSdk, which allows reading a `.cmly` file.
  The purpose of this library is to allow external tools to take advantage
  of the work performed by Menhir's front-end. (Suggested by Frédéric Bour.)

* Introduced new syntax for attributes in a `.mly` file. Attributes are
  ignored by Menhir's back-ends, but are written to `.cmly` files, thus
  can be exploited by external tools via MenhirSdk. (Suggested by Frédéric Bour.)

440 441 442
* The definition of a `%public` nonterminal symbol can now be split into several
  parts within a single `.mly` file. (This used to be permitted only over
  multiple `.mly` files.) (Suggested by Frédéric Bour.)
443

POTTIER Francois's avatar
POTTIER Francois committed
444 445 446 447 448 449 450 451 452
* New functions in the incremental API:
  `shifts`, `acceptable`, `current_state_number`.

* New functions in the incremental API and inspection API:
  `top`, `pop`, `pop_many`, `get`, `equal`,
  `force_reduction`, `feed`, `input_needed`,
  `state_has_default_reduction`,
  `production_index`, `find_production`.
  (Suggested by Frédéric Bour.)
453

454 455 456 457 458
* New module `MenhirLib.ErrorReports`. This module is supposed to offer
  auxiliary functions that help produce good syntax error messages.
  This module does not yet contain much functionality and is expected
  to evolve in the future.

459 460 461 462
* Incompatible change in the incremental API: the type `env` becomes `'a env`.

* Incompatible change in the incremental API: the function
  `has_default_reduction` is renamed `env_has_default_reduction`.
463

464 465 466 467 468
* The type `stack` and the function `stack` in the incremental API are
  deprecated. The new functions `top` and `pop` can be used instead to
  inspect the parser's stack. The module `MenhirLib.General` is deprecated
  as well. Deprecated functionality will be removed in the future.

POTTIER Francois's avatar
POTTIER Francois committed
469 470 471 472 473
* Incompatible change in the incremental API: the type of the function
  `print_stack` in the result signature of the functor
  `MenhirLib.Printers.Make` changes to `'a env -> unit`.
   (Anyway, as of now, `MenhirLib.Printers` remains undocumented.)

POTTIER Francois's avatar
POTTIER Francois committed
474 475 476
* Improved the syntax error message that is displayed when a `.mly` file
  is incorrect: the previous and next token are shown.

477 478
* Fixed a bug where the module name `Basics` was shadowed (that is, if the user's
  project happened to contain a toplevel module by this name, then it could not
POTTIER Francois's avatar
POTTIER Francois committed
479
  be referred to from a `.mly` file). (Reported by François Thiré.)
480

POTTIER Francois's avatar
POTTIER Francois committed
481
## 2017/01/01
482 483 484 485 486

* Add `$MENHIR_STDLIB` as a way of controlling where Menhir looks for the file
  `standard.mly`. This environment variable overrides the installation-time
  default setting, and is itself overridden by the `--stdlib` command line
  switch. (Requested by Jonathan Protzenko.)
POTTIER Francois's avatar
POTTIER Francois committed
487

488 489 490
* `Makefile` fix: filter out `'\r'` in the output of `menhir --suggest-ocamlfind`,
  so that the `Makefile` works when Menhir is compiled as a Windows executable.
  (Suggested by Jonathan Protzenko.)
491

POTTIER Francois's avatar
POTTIER Francois committed
492
## 2016/12/01
493 494 495

* Updated the Coq back-end for compatibility with Coq 8.6.
  (Jacques-Henri Jourdan.)
POTTIER Francois's avatar
POTTIER Francois committed
496

POTTIER Francois's avatar
POTTIER Francois committed
497
## 2016/11/15
498 499 500 501 502 503

* Fix in `--only-preprocess-for-ocamlyacc` mode: avoid printing newline characters
  inside a `%type` declaration, as this is forbidden by `ocamlyacc`. (Reported by
  Kenji Maillard.)
* Fix in `--only-preprocess-for-ocamlyacc` mode: avoid variable capture caused by
  `ocamlyacc` internally translating `$i` to `_i`. (Reported by Kenji Maillard.)
504

POTTIER Francois's avatar
POTTIER Francois committed
505
## 2016/09/01
506 507 508 509 510

* New command line switch `--only-preprocess-for-ocamlyacc`, supposed to print the
  grammar in a form that `ocamlyacc` can accept. As of now, this feature is
  incomplete (in particular, support for Menhir's position keywords is missing),
  untested, and undocumented. It could be removed in the future.
POTTIER Francois's avatar
POTTIER Francois committed
511

POTTIER Francois's avatar
POTTIER Francois committed
512
## 2016/08/26
513 514

* Fixes in the output of `--only-preprocess`:
515 516 517 518
  * The order of productions is now preserved.
      (It was not. This matters if there are reduce/reduce conflicts.)
  * `%parameter` directives are now printed. (They were not).
  * `%on_error_reduce` directives are now printed. (They were not.)
519

POTTIER Francois's avatar
POTTIER Francois committed
520
## 2016/08/25
521 522 523 524

* `Makefile` fix, undoing a change made on 2016/03/03, which caused installation
  to fail under (some versions of?) Windows where dynamic linking is not
  supported. (Reported by Andrew Appel.)
525

POTTIER Francois's avatar
POTTIER Francois committed
526
## 2016/08/05
527 528 529 530 531

* `%on_error_reduce` declarations now have implicit priority levels, so as to
  tell Menhir what to do when two such declarations are applicable.
  Also, the well-formedness checks on `%type` and `%on_error_reduce` declarations
  have been reinforced.
POTTIER Francois's avatar
POTTIER Francois committed
532

POTTIER Francois's avatar
POTTIER Francois committed
533
## 2016/06/23
534 535 536 537 538 539

* A small change in the generated code (both in the code and table back-ends) so
  as to avoid OCaml's warning 41. The warning would arise (when compiling a
  generated parser with OCaml 4.03) because Menhir's exception `Error` has the
  same name as the data constructor `Error` in OCaml's pervasive library.
  (Reported by Bernhard Schommer.)
540

POTTIER Francois's avatar
POTTIER Francois committed
541
## 2016/05/18
542 543 544 545 546

* Anonymous rules now work also when used inside a parameterized rule.
  (This did not work until now.) When an anonymous rule is hoisted out
  of a parameterized rule, it may itself become parameterized. Menhir
  parameterizes it only over the parameters that it actually needs.
547

POTTIER Francois's avatar
POTTIER Francois committed
548
## 2016/05/04
549

POTTIER Francois's avatar
POTTIER Francois committed
550
* In the Coq back-end, split the largest definitions into smaller
551 552 553
  ones. This circumvents a limitation of vm_compute on 32 bit
  machines. This also enables us to perform sharing between
  definitions, so that the generated files are much smaller.
Jacques-Henri Jourdan's avatar
CHANGES  
Jacques-Henri Jourdan committed
554

POTTIER Francois's avatar
POTTIER Francois committed
555
## 2016/04/10
556 557 558

* When printing a grammar (which is done by the `--only-preprocess` options),
  remove the leading bar `|`, for compatibility with `yacc` and `bison`.
POTTIER Francois's avatar
POTTIER Francois committed
559

POTTIER Francois's avatar
POTTIER Francois committed
560
## 2016/03/11
561 562 563 564 565

* In the code back-end, generate type annotations when extracting a semantic
  value out of the stack. When working with a semantic value of some function
  type, OCaml would incorrectly warn that this function does not use its
  argument. This warning should now be gone.
566

POTTIER Francois's avatar
POTTIER Francois committed
567
## 2016/03/03
568 569 570

* Makefile changes, so as to support `ocamlbuild` 4.03, which seems to have
  stricter hygiene rules than previous versions.
POTTIER Francois's avatar
POTTIER Francois committed
571

POTTIER Francois's avatar
POTTIER Francois committed
572
## 2015/12/30
573 574 575 576

* Prevented an incorrect installation that would take place if `USE_OCAMLFIND`
  was given during `make all` but not during `make install`. Added a command
  line directive `--suggest-ocamlfind`.
577

POTTIER Francois's avatar
POTTIER Francois committed
578
## 2015/11/11
579 580 581 582

* Fixed a severe bug in Menhir 20151110 which (when using the code back-end)
  could cause a generated parser to crash. Thanks to ygrek for reporting the
  bug.
POTTIER Francois's avatar
POTTIER Francois committed
583

584
* The code produced by version `XXXXXXXX` of `menhir --table` can now be linked only
585 586 587
  against a matching version of MenhirLib. If an incorrect version of MenhirLib
  is installed, the OCaml compiler should complain that
  `MenhirLib.StaticVersion.require_XXXXXXXX` is undefined.
588

POTTIER Francois's avatar
POTTIER Francois committed
589
## 2015/11/10
590 591 592

* Optimized the computation of `$symbolstartpos`, based on a couple of assumptions
  about the lexer. (See the manual.)
POTTIER Francois's avatar
POTTIER Francois committed
593

POTTIER Francois's avatar
POTTIER Francois committed
594
## 2015/11/04
595 596 597 598 599

* Modified the treatment of `%inline` so that the positions that are computed are
  the same, regardless of whether `%inline` is used. This property did not hold
  until now. It now does. Of course, this means that the positions computed by
  the new Menhir are not the same as those computed by older versions of Menhir.
POTTIER Francois's avatar
POTTIER Francois committed
600

601 602 603
* Fixed a bug in the treatment of `%inline` that would lead to an incorrect
  position being computed when the caller and callee had a variable by the
  same name.
POTTIER Francois's avatar
POTTIER Francois committed
604

605 606 607 608 609 610 611 612
* Modified Menhir so as to compute the start and end positions in the exact same
  way as `ocamlyacc`. (There used to be a difference in the treatment of epsilon
  productions.) Of course, this means that the positions computed by the new
  Menhir are not the same as those computed by older versions of Menhir. Added
  the keyword `$symbolstartpos` so as to simulate `Parsing.symbol_start_pos()`
  in the `ocamlyacc` world. The keyword `$startpos` sometimes produces a position
  that is too far off to the left; `$symbolstartpos` produces a more accurate
  position.
POTTIER Francois's avatar
POTTIER Francois committed
613

614 615 616
* Incompatible change of the incremental API: instead of a unit argument, the
  entry points (which are named after the start symbols) now require an initial
  position, which typically should be `lexbuf.lex_curr_p`.
617

POTTIER Francois's avatar
POTTIER Francois committed
618
## 2015/11/03
619 620 621

* Fix-fix-and-re-fix the `Makefile` in an attempt to allow installation under
  opam/Windows. Thanks to Daniel Weil for patient explanations and testing.
622

POTTIER Francois's avatar
POTTIER Francois committed
623
## 2015/10/29
624 625 626 627 628 629

* MenhirLib is now installed in both binary and source forms.
  `menhir --suggest-menhirLib` reports where MenhirLib is installed.
  This can be used to retrieve a snapshot of MenhirLib in source form
  and include it in your project (if you wish to use `--table` mode, yet
  do not wish to have a dependency on MenhirLib).
630

POTTIER Francois's avatar
POTTIER Francois committed
631
## 2015/10/26
632 633 634 635

* Allow `--list-errors` to work on 32-bit machines (with low hard limits).
  This should fix a problem whereby the 2015/10/23 release could not
  bootstrap on a 32-bit machine.
636

POTTIER Francois's avatar
POTTIER Francois committed
637
## 2015/10/23
638 639 640 641 642 643 644 645 646

* New declaration `%on_error_reduce foo`, where `foo` is a nonterminal symbol.
  This modifies the automaton as follows. In every state where a production of
  the form `foo -> ...` is ready to be reduced, every error action is replaced
  with a reduction of this production. (If there is a conflict between several
  productions that could be reduced in this manner, nothing is done.) This does
  not affect the language that is accepted by the automaton, but delays the
  detection of an error: more reductions take place before the error is
  detected.
POTTIER Francois's avatar
POTTIER Francois committed
647

648 649 650 651
* Fixed a bug whereby Menhir would warn about a useless `%prec` declaration,
  even though it was useful. This would happen when the declaration was
  duplicated (by inlining or by macro-expansion) and some but not all of
  the copies were useful.
652

653
* Added `has_default_reduction` to the incremental API.
654

655 656 657 658
* Modified the meaning of `--canonical` to allow default reductions to take
  place. This implies no loss of precision in terms of lookahead sets,
  and should allow gaining more contextual information when a syntax
  error is encountered. (It should also lead to a smaller automaton.)
659

660 661 662 663 664 665 666 667 668 669 670 671 672 673
* A brand new set of tools to work on syntax errors.
* New command `--list-errors`, which produces a list of input sentences which
  are representative of all possible syntax errors. (Costly.)
* New command `--interpret-error`, which confirms that one particular input
  sentence ends in a syntax error, and prints the number of the state in
  which this error occurs.
* New command `--compile-errors`, which compiles a list of erroneous sentences
  (together with error messages) to OCaml code.
* New command `--compare-errors`, which compares two lists of erroneous sentences
  to check if they cover the same error states.
* New command `--update-errors`, which updates the auto-generated comments in
  a list of erroneous sentences.
* New command `--echo-errors`, which removes all comments and messages from
  a list of erroneous sentences, and echoes just the sentences.
POTTIER Francois's avatar
POTTIER Francois committed
674

POTTIER Francois's avatar
POTTIER Francois committed
675
## 2015/10/16
676 677

* Additions to the incremental API.
678 679 680 681 682 683 684
  * A `supplier` is a function that produces tokens on demand.
  * `lexer_lexbuf_to_supplier` turns a lexer and a lexbuf into a supplier.
  * `loop` is a ready-made made main parsing loop.
  * `loop_handle` is a variant that lets the user do her own error handling.
  * `loop_handle_undo` is a variant that additionally allows undoing the last
    few "spurious" reductions.
  * `number` maps a state of the LR(1) automaton to its number.
685 686 687 688

* Incompatible change of the incremental API: renamed the type `'a result`
  to `'a checkpoint`. This is a better name anyway, and should help avoid
  confusion with the type `'a result` introduced in OCaml 4.03.
689

POTTIER Francois's avatar
POTTIER Francois committed
690
## 2015/10/12
691 692

* Avoid using `$(shell pwd)` in `Makefile`, for better Windows compatibility.
693

POTTIER Francois's avatar
POTTIER Francois committed
694
## 2015/10/05
695 696 697

* Fixed a bug where inconsistent OCaml code was generated when `--table`
  and `--external-tokens` were used together. (Reported by Darin Morrison.)
698

699 700
* In `--infer` mode, leave the `.ml` file around (instead of removing it) if
  `ocamlc` fails, so we have a chance to understand what's wrong.
701

POTTIER Francois's avatar
POTTIER Francois committed
702
## 2015/09/21
703 704 705

* Re-established some error messages concerning the mis-use of `$i` which
  had disappeared on 2015/06/29.
POTTIER Francois's avatar
POTTIER Francois committed
706

POTTIER Francois's avatar
POTTIER Francois committed
707
## 2015/09/11
708 709 710 711 712

* Fixed the mysterious message that would appear when a nonterminal symbol
  begins with an uppercase letter and `--infer` is turned on. Clarified the
  documentation to indicate that a (non-start) nonterminal symbol can begin
  with an uppercase letter, but this is not recommended.
713

POTTIER Francois's avatar
POTTIER Francois committed
714
## 2015/08/27
715 716 717 718 719 720

* New option `--inspection` (added last January, documented only now). This
  generates an inspection API which allows inspecting the automaton's stack,
  among other things. This API can in principle be used to write custom code
  for error reporting, error recovery, etc. It is not yet mature and may
  change in the future.
POTTIER Francois's avatar
POTTIER Francois committed
721

POTTIER Francois's avatar
POTTIER Francois committed
722
## 2015/07/20
723 724

* Added the command line options `--unused-token <symbol>` and `--unused-tokens`.
725

POTTIER Francois's avatar
POTTIER Francois committed
726
## 2015/06/29
727 728 729 730 731

* Changed the treatment of the positional keywords `$i`. They are now
  rewritten into variables of the form `_i` where `i` is an integer.
  Users are advised not to use variables of this form inside semantic
  actions.
Yann Régis-Gianas's avatar
Yann Régis-Gianas committed
732

POTTIER Francois's avatar
POTTIER Francois committed
733
## 2015/02/11
734 735 736 737 738

* Added support for anonymous rules. This allows writing, e.g.,
  `list(e = expression SEMI { e })`
  whereas previously one should have written
  `list(terminated(e, SEMI))`.
739

POTTIER Francois's avatar
POTTIER Francois committed
740
## 2015/02/09
741 742

* Moved all of the demos to `ocamlbuild` (instead of `make`).
743

POTTIER Francois's avatar
POTTIER Francois committed
744
## 2015/01/18
745 746 747

* Incompatible change of the incremental API.
  The incremental API now exposes shift events too.
748

POTTIER Francois's avatar
POTTIER Francois committed
749
## 2015/01/16
750 751 752 753

* Fixed a couple bugs in `Makefile` and `src/Makefile` which would cause
  compilation and installation to fail with `TARGET=byte`. (Reported
  by Jérémie Courrèges-Anglas and Daniel Dickman.)
754

POTTIER Francois's avatar
POTTIER Francois committed
755
## 2015/01/01
756 757 758

* Incompatible change of the incremental API.
  The entry point `main_incremental` is now named `Incremental.main`.
759

POTTIER Francois's avatar
POTTIER Francois committed
760
## 2014/12/29
761 762

* Incompatible change of the incremental API.
763 764 765 766 767
  * The API now exposes reduction events.
  * The type `'a result` is now private.
  * The type `env` is no longer parameterized.
  * `handle` is renamed to `resume`.
  * `offer` and `resume` now expect a result, not an environment.
768

POTTIER Francois's avatar
POTTIER Francois committed
769
## 2014/12/22
770 771

* Documented the Coq back-end (designed and implemented by Jacques-Henri Jourdan).
772

POTTIER Francois's avatar
POTTIER Francois committed
773
## 2014/12/15
774 775

* New incremental API (in `--table` mode only), inspired by Frédéric Bour.
POTTIER Francois's avatar
POTTIER Francois committed
776

POTTIER Francois's avatar
POTTIER Francois committed
777
## 2014/12/11
778

779 780 781 782 783 784 785
* Menhir now reports an error if one of the start symbols produces
  either the empty language or the singleton language {epsilon}.

* Although some people out there actually define a start symbol that recognizes
  {epsilon} (and use it as a way of initializing or re-initializing some global
  state), this is considered bad style. Furthermore, by ruling out this case, we
  are able to simplify the table back-end a little bit.
786

POTTIER Francois's avatar
POTTIER Francois committed
787
## 2014/12/12
788 789

* A speed improvement in the code back-end.
POTTIER Francois's avatar
POTTIER Francois committed
790

POTTIER Francois's avatar
POTTIER Francois committed
791
## 2014/12/08
792 793

* Menhir now requires OCaml 4.02 (instead of 3.09).
794

POTTIER Francois's avatar
POTTIER Francois committed
795
## 2014/12/02
796 797 798

* Removed support for the `$previouserror` keyword.
* Removed support for `--error-recovery` mode.
799

POTTIER Francois's avatar
POTTIER Francois committed
800
## 2014/02/18
801

POTTIER Francois's avatar
POTTIER Francois committed
802
* In the Coq back-end, use `'` instead of `_` as separator in identifiers.
803 804 805
  Also, correct a serious bug that was inadvertently introduced on
  2013/03/01 (r319).

POTTIER Francois's avatar
POTTIER Francois committed
806
## 2014/02/14
807 808 809

* Lexer fix so as to support an open variant type `[> ...]` within
  a `%type<...>` declaration.
810

POTTIER Francois's avatar
POTTIER Francois committed
811
## 2013/12/16
812 813 814 815 816

* Updated the `Makefile` so that `install` no longer depends on `all`.

* Updated the demos so that the lexer does not invoke `exit 0`
  when encoutering `eof`. (This should be more intuitive.)
fpottier's avatar
fpottier committed
817

POTTIER Francois's avatar
POTTIER Francois committed
818
## 2013/09/11
819 820 821

* Fixed a newline conversion problem that would prevent Menhir from
  building on Windows when using ocaml 4.01.
822

POTTIER Francois's avatar
POTTIER Francois committed
823
## 2013/03/02
824 825 826

* Switched to ocamlbuild. Many thanks to Daniel Weil for offering
  very useful guidance.
fpottier's avatar
fpottier committed
827

POTTIER Francois's avatar
POTTIER Francois committed
828
## 2013/01/16
829 830 831

* `menhir --depend` was broken since someone added new whitespace in the output
  of `ocamldep`. Fixed.
832

POTTIER Francois's avatar
POTTIER Francois committed
833
## 2012/12/19
834 835 836 837

* Fixed a compilation problem that would arise when a file produced
  by Menhir on a 64-bit platform was compiled by ocaml on a 32-bit
  platform.
838

POTTIER Francois's avatar
POTTIER Francois committed
839
## 2012/08/25
840 841 842 843

* Performance improvements in the computation of various information
  about the automaton (module `Invariant`). The improvements will be
  noticeable only for very large automata.
844

POTTIER Francois's avatar
POTTIER Francois committed
845
## 2012/06/07
846 847 848

* The option `--log-grammar 3` (and above) now causes the `FOLLOW` sets for
  terminal symbols to be computed and displayed.
849

POTTIER Francois's avatar
POTTIER Francois committed
850
## 2012/05/25
851 852 853 854 855

* Added the flag `--canonical`, which causes Menhir to produce a canonical LR(1)
  automaton in the style of Knuth. This means that no merging of states takes
  place during the construction of the automaton, and that no default reductions
  are allowed.
856

POTTIER Francois's avatar
POTTIER Francois committed
857
## 2012/01/23
858 859 860 861 862 863

* Fixed a bug whereby a `%nonassoc` declaration was not respected. This
  declaration requests that a shift/reduce conflict be reduced in favor of
  neither shifting nor reducing, that is, a syntax error must occur. However,
  due to an unforeseen interaction with the default reduction mechanism, this
  declaration was sometimes ignored and reduction would take place.
864

POTTIER Francois's avatar
POTTIER Francois committed
865
## 2012/01/09
866 867 868

* Changes in the (undocumented) Coq back-end so as to match the ESOP 2012
  paper.
869

POTTIER Francois's avatar
POTTIER Francois committed
870
## 2011/10/19
871 872 873

* The `Makefile` now tests whether Unix or Windows is used (the test is performed
  by evaluating `Sys.os_type` under `ocaml`) and changes a couple settings accordingly:
874 875
  * the executable file name is either `menhir` or `menhir.exe`
  * the object file suffix is either `.o` or `.obj`
876 877 878

* Added `--strict`, which causes many warnings about the grammar and about the
  automaton to be considered errors.
879

880 881 882 883 884 885
* The `#` annotations that are inserted in the generated `.ml` file now retain their
  full path. (That is, we no longer use `Filename.basename`.) This implies that
  the `#` annotations depend on how Menhir is invoked
  -- e.g., `menhir foo/bar.mly` and `cd foo && menhir bar.mly` will produce different
  results. Nevertheless, this seems reasonable and useful (e.g., in conjunction
  with `ocamlbuild` and a hierarchy of files). Thanks to Daniel Weil.
886

POTTIER Francois's avatar
POTTIER Francois committed
887
## 2011/10/06
888 889

* With the `-lg 1` switch, Menhir now indicates whether the grammar is SLR(1).
890

POTTIER Francois's avatar
POTTIER Francois committed
891
## 2011/05/24
892 893 894 895

* Removed the lock in `ocamldep.wrapper`. It is the responsibility of the user
  to avoid interferences with other processes (or other instances of the script)
  that create and/or remove files.
896

POTTIER Francois's avatar
POTTIER Francois committed
897
## 2011/04/28
898 899 900 901 902

* The (internal) computation of the automaton's invariant was broken and has
  been fixed. Surprisingly, this does not seem to affect the generated code,
  (which was correct,) so no observable bug is fixed. Hopefully no bug is
  introduced!
903

POTTIER Francois's avatar
POTTIER Francois committed
904
## 2011/04/07
905 906 907 908

* The grammar description files (`.mly`) are now read in up front and stored in
  memory while they are parsed. This allows us to avoid the use of `pos_in` and
  `seek_in`, which do not work correctly when CRLF conversion is being performed.
909

POTTIER Francois's avatar
POTTIER Francois committed
910
## 2011/04/05
911 912 913

* Fixed a bug in the type inference module (for parameterized non-terminals)
  which would cause an infinite loop.
914

POTTIER Francois's avatar
POTTIER Francois committed
915
## 2011/01/24
916 917 918 919 920

* Fixed a bug that would cause an assertion failure in the generated parser
  in some situations where the input stream was incorrect and the grammar
  involved the error token. The fix might cause grammars that use the error
  token to behave differently (hopefully more accurately) as of now.
921

POTTIER Francois's avatar
POTTIER Francois committed
922
## 2009/06/18
923 924 925

* `Makefile` changes: build and install only the bytecode version of MenhirLib
  when `TARGET=byte` is set.
926

POTTIER Francois's avatar
POTTIER Francois committed
927
## 2009/02/06
928 929 930

* Fixed `ocamldep.wrapper` to avoid quoting the name of the `ocaml` command.
  This is hoped to fix a compilation problem under MinGW.
931

POTTIER Francois's avatar
POTTIER Francois committed
932
## 2009/02/04
933 934 935

* A `Makefile` fix to avoid a problem under Windows/Cygwin.
* Renamed the `ocaml-check-version` script so as to avoid a warning.
936

POTTIER Francois's avatar
POTTIER Francois committed
937
## 2008/09/05
938 939

* Ocaml summer project: added `--interpret`, `--table`, and `--suggest-*`.
940

POTTIER Francois's avatar
POTTIER Francois committed
941
## 2008/08/06
942 943 944

* Fixed a problem that would cause the code inliner to abort when a semantic
  value and a non-terminal symbol happened to have the same name.
945

946
* Removed code sharing.
947

POTTIER Francois's avatar
POTTIER Francois committed
948
## 2008/06/20
949 950

* Removed an incorrect assertion that caused failures (`lr1.ml`, line 134).
951

POTTIER Francois's avatar
POTTIER Francois committed
952
## 2007/12/05
953 954 955

* Disabled code sharing by default, as it is currently broken. (See Yann's
  message; assertion failure at runtime.)
956

POTTIER Francois's avatar
POTTIER Francois committed
957
## 2007/12/01
958 959 960

* Added an optimization to share code among states that have identical
  outgoing transition tables.
961

POTTIER Francois's avatar
POTTIER Francois committed
962
## 2007/08/30
963 964 965

* Small `Makefile` change: create an executable file for `check-ocaml-version` in
  order to work around the absence of dynamic loading on some platforms.
966

POTTIER Francois's avatar
POTTIER Francois committed
967
## 2007/05/20
968 969 970 971

* Made a fundamental change in the construction of the LR(1) automaton
  in order to eliminate a bug that could lead to spurious conflicts --
  thanks to Ketti for submitting a bug report.
972

POTTIER Francois's avatar
POTTIER Francois committed
973
## 2007/05/18
974 975 976

* Added `--follow-construction` to help understand the construction of the
  LR(1) automaton (very verbose).
977

POTTIER Francois's avatar
POTTIER Francois committed
978
## 2007/05/11
979 980 981 982 983

* Code generation: more explicit qualifications with `Pervasives` so as
  to avoid capture when the user redefines some of the built-in operators,
  such as `(+)`.
* Added a new demo (`calc-param`) that shows how to use `%parameter`.
984

POTTIER Francois's avatar
POTTIER Francois committed
985
## 2007/03/22
986 987 988

* `Makefile` improvements (check for `PREFIX`; bootstrap in bytecode now
  also available). Slight changes to `OMakefile.shared`.
989

POTTIER Francois's avatar
POTTIER Francois committed
990
## 2007/02/15
991 992

* Portability fix in `Makefile` and `Makefile.shared` (avoided `which`).
993

POTTIER Francois's avatar
POTTIER Francois committed
994
## 2006/12/15
995 996

* Portability fix in `Makefile.shared` (replaced `&>` with `2>&1 >`).
997

POTTIER Francois's avatar
POTTIER Francois committed
998
## 2006/06/23
999 1000 1001 1002

* Made a slight restriction to Pager's criterion so as to never introduce
  fake conflict tokens (see `Lr0.compatible`). This might help make conflict
  explanations more accurate in the future.
1003

POTTIER Francois's avatar
POTTIER Francois committed
1004
## 2006/06/16
1005 1006

* Fixed bug that would cause positions to become invalid after inlining.
1007

POTTIER Francois's avatar
POTTIER Francois committed
1008
## 2006/06/15
1009 1010 1011 1012

* Fixed `--depend` to be more lenient when analyzing `ocamldep`'s output.
* Added `--raw-depend` which transmits `ocamldep`'s output unchanged (for
  use in conjunction with `omake`).
1013

POTTIER Francois's avatar
POTTIER Francois committed
1014
## 2006/06/12
1015 1016 1017 1018 1019 1020 1021 1022 1023 1024

* Fixed bug that would cause `--only-preprocess` to print `%token` declarations
  also for pseudo-tokens.
* Fixed bug that caused some precedence declarations to be incorrectly
  reported as useless.
* Improved things so that useless pseudo-tokens now also cause warnings.
* Fixed bug that would cause `%type` directives for terminal symbols to
  be incorrectly accepted.
* Fixed bug that would occur when a semantic action containing `$i` keywords
  was inlined.
1025

POTTIER Francois's avatar
POTTIER Francois committed
1026
## 2006/05/05
1027 1028 1029

* Fixed problem that caused some end-of-stream conflicts not to be reported.
* Fixed Pager's compatibility criterion to avoid creating end-of-stream conflicts.
1030