Une MAJ de sécurité est nécessaire sur notre version actuelle. Elle sera effectuée lundi 02/08 entre 12h30 et 13h. L'interruption de service devrait durer quelques minutes (probablement moins de 5 minutes).

CHANGES.md 29.3 KB
Newer Older
1 2
# Changes

3 4
## 2018/10/24

5 6 7 8 9 10 11
* 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.

12
* New flag `--no-dollars`, which disallows the use of `$i` in semantic actions.
13
  The default behavior remains to allow the use of `$i`.
14 15 16 17 18

* 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.

19
## 2018/10/06
POTTIER Francois's avatar
POTTIER Francois committed
20

21
* Standard library: add `rev`, `flatten`, `append`.
22 23
  Add a link from the manual to `standard.mly` in the repository.

24 25
* Update the manual to explain how to use `dune` and `menhir` together.

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

28 29 30 31
* 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.

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

34 35 36 37 38 39
* 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:
40 41 42 43 44
  `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.)
45

46 47 48
* Coq back-end: add a few newlines in the generated file for readability.
  (Suggested by Bernhard Schommer.)

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

52 53 54 55 56 57 58 59 60 61
## 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`.

62 63 64 65
## 2018/07/04

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

66 67 68 69 70 71 72 73
## 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.)

74 75 76 77 78 79 80 81
## 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.

82 83 84 85 86 87 88 89 90 91 92 93 94 95
## 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
96 97 98
## 2018/05/23

* New commands `--infer-write-query`, `--infer-read-reply`, and
99 100 101 102 103 104 105 106 107 108 109 110
  `--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
111

112 113 114 115 116 117
## 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
118 119 120 121
## 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
122 123 124
  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
125

POTTIER Francois's avatar
POTTIER Francois committed
126 127 128 129 130
## 2017/11/12

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

131 132 133 134 135 136
## 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.)

137 138 139 140 141 142 143
## 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
144 145 146 147 148 149 150 151
## 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.

152 153 154 155 156
## 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
157 158 159 160 161 162 163 164
## 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
165
## 2017/04/18
POTTIER Francois's avatar
POTTIER Francois committed
166

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

POTTIER Francois's avatar
POTTIER Francois committed
170 171 172 173 174 175 176 177 178 179 180 181 182 183 184
* 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.)

185 186 187
* 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.)
188

POTTIER Francois's avatar
POTTIER Francois committed
189 190 191 192 193 194 195 196 197
* 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.)
198

199 200 201 202 203
* 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.

204 205 206 207
* 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`.
208

209 210 211 212 213
* 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
214 215 216 217 218
* 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
219 220 221
* Improved the syntax error message that is displayed when a `.mly` file
  is incorrect: the previous and next token are shown.

222 223
* 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
224
  be referred to from a `.mly` file). (Reported by François Thiré.)
225

POTTIER Francois's avatar
POTTIER Francois committed
226
## 2017/01/01
227 228 229 230 231

* 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
232

233 234 235
* `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.)
236

POTTIER Francois's avatar
POTTIER Francois committed
237
## 2016/12/01
238 239 240

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

POTTIER Francois's avatar
POTTIER Francois committed
242
## 2016/11/15
243 244 245 246 247 248

* 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.)
249

POTTIER Francois's avatar
POTTIER Francois committed
250
## 2016/09/01
251 252 253 254 255

* 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
256

POTTIER Francois's avatar
POTTIER Francois committed
257
## 2016/08/26
258 259

* Fixes in the output of `--only-preprocess`:
260 261 262 263
  * 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.)
264

POTTIER Francois's avatar
POTTIER Francois committed
265
## 2016/08/25
266 267 268 269

* `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.)
270

POTTIER Francois's avatar
POTTIER Francois committed
271
## 2016/08/05
272 273 274 275 276

* `%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
277

POTTIER Francois's avatar
POTTIER Francois committed
278
## 2016/06/23
279 280 281 282 283 284

* 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.)
285

POTTIER Francois's avatar
POTTIER Francois committed
286
## 2016/05/18
287 288 289 290 291

* 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.
292

POTTIER Francois's avatar
POTTIER Francois committed
293
## 2016/05/04
294 295 296 297 298

* In the Coq backend, split the largest definitions into smaller
  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
299

POTTIER Francois's avatar
POTTIER Francois committed
300
## 2016/04/10
301 302 303

* 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
304

POTTIER Francois's avatar
POTTIER Francois committed
305
## 2016/03/11
306 307 308 309 310

* 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.
311

POTTIER Francois's avatar
POTTIER Francois committed
312
## 2016/03/03
313 314 315

* 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
316

POTTIER Francois's avatar
POTTIER Francois committed
317
## 2015/12/30
318 319 320 321

* 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`.
322

POTTIER Francois's avatar
POTTIER Francois committed
323
## 2015/11/11
324 325 326 327

* 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
328

329
* The code produced by version `XXXXXXXX` of `menhir --table` can now be linked only
330 331 332
  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.
333

POTTIER Francois's avatar
POTTIER Francois committed
334
## 2015/11/10
335 336 337

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

POTTIER Francois's avatar
POTTIER Francois committed
339
## 2015/11/04
340 341 342 343 344

* 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
345

346 347 348
* 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
349

350 351 352 353 354 355 356 357
* 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
358

359 360 361
* 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`.
362

POTTIER Francois's avatar
POTTIER Francois committed
363
## 2015/11/03
364 365 366

* 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.
367

POTTIER Francois's avatar
POTTIER Francois committed
368
## 2015/10/29
369 370 371 372 373 374

* 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).
375

POTTIER Francois's avatar
POTTIER Francois committed
376
## 2015/10/26
377 378 379 380

* 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.
381

POTTIER Francois's avatar
POTTIER Francois committed
382
## 2015/10/23
383 384 385 386 387 388 389 390 391

* 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
392

393 394 395 396
* 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.
397

398
* Added `has_default_reduction` to the incremental API.
399

400 401 402 403
* 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.)
404

405 406 407 408 409 410 411 412 413 414 415 416 417 418
* 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
419

POTTIER Francois's avatar
POTTIER Francois committed
420
## 2015/10/16
421 422

* Additions to the incremental API.
423 424 425 426 427 428 429
  * 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.
430 431 432 433

* 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.
434

POTTIER Francois's avatar
POTTIER Francois committed
435
## 2015/10/12
436 437

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

POTTIER Francois's avatar
POTTIER Francois committed
439
## 2015/10/05
440 441 442

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

444 445
* 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.
446

POTTIER Francois's avatar
POTTIER Francois committed
447
## 2015/09/21
448 449 450

* 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
451

POTTIER Francois's avatar
POTTIER Francois committed
452
## 2015/09/11
453 454 455 456 457

* 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.
458

POTTIER Francois's avatar
POTTIER Francois committed
459
## 2015/08/27
460 461 462 463 464 465

* 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
466

POTTIER Francois's avatar
POTTIER Francois committed
467
## 2015/07/20
468 469

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

POTTIER Francois's avatar
POTTIER Francois committed
471
## 2015/06/29
472 473 474 475 476

* 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
477

POTTIER Francois's avatar
POTTIER Francois committed
478
## 2015/02/11
479 480 481 482 483

* 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))`.
484

POTTIER Francois's avatar
POTTIER Francois committed
485
## 2015/02/09
486 487

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

POTTIER Francois's avatar
POTTIER Francois committed
489
## 2015/01/18
490 491 492

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

POTTIER Francois's avatar
POTTIER Francois committed
494
## 2015/01/16
495 496 497 498

* 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.)
499

POTTIER Francois's avatar
POTTIER Francois committed
500
## 2015/01/01
501 502 503

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

POTTIER Francois's avatar
POTTIER Francois committed
505
## 2014/12/29
506 507

* Incompatible change of the incremental API.
508 509 510 511 512
  * 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.
513

POTTIER Francois's avatar
POTTIER Francois committed
514
## 2014/12/22
515 516

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

POTTIER Francois's avatar
POTTIER Francois committed
518
## 2014/12/15
519 520

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

POTTIER Francois's avatar
POTTIER Francois committed
522
## 2014/12/11
523

524 525 526 527 528 529 530
* 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.
531

POTTIER Francois's avatar
POTTIER Francois committed
532
## 2014/12/12
533 534

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

POTTIER Francois's avatar
POTTIER Francois committed
536
## 2014/12/08
537 538

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

POTTIER Francois's avatar
POTTIER Francois committed
540
## 2014/12/02
541 542 543

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

POTTIER Francois's avatar
POTTIER Francois committed
545
## 2014/02/18
546

547 548 549 550
* In the Coq backend, use `'` instead of `_` as separator in identifiers.
  Also, correct a serious bug that was inadvertently introduced on
  2013/03/01 (r319).

POTTIER Francois's avatar
POTTIER Francois committed
551
## 2014/02/14
552 553 554

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

POTTIER Francois's avatar
POTTIER Francois committed
556
## 2013/12/16
557 558 559 560 561

* 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
562

POTTIER Francois's avatar
POTTIER Francois committed
563
## 2013/09/11
564 565 566

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

POTTIER Francois's avatar
POTTIER Francois committed
568
## 2013/03/02
569 570 571

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

POTTIER Francois's avatar
POTTIER Francois committed
573
## 2013/01/16
574 575 576

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

POTTIER Francois's avatar
POTTIER Francois committed
578
## 2012/12/19
579 580 581 582

* 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.
583

POTTIER Francois's avatar
POTTIER Francois committed
584
## 2012/08/25
585 586 587 588

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

POTTIER Francois's avatar
POTTIER Francois committed
590
## 2012/06/07
591 592 593

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

POTTIER Francois's avatar
POTTIER Francois committed
595
## 2012/05/25
596 597 598 599 600

* 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.
601

POTTIER Francois's avatar
POTTIER Francois committed
602
## 2012/01/23
603 604 605 606 607 608

* 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.
609

POTTIER Francois's avatar
POTTIER Francois committed
610
## 2012/01/09
611 612 613

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

POTTIER Francois's avatar
POTTIER Francois committed
615
## 2011/10/19
616 617 618

* 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:
619 620
  * the executable file name is either `menhir` or `menhir.exe`
  * the object file suffix is either `.o` or `.obj`
621 622 623

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

625 626 627 628 629 630
* 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.
631

POTTIER Francois's avatar
POTTIER Francois committed
632
## 2011/10/06
633 634

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

POTTIER Francois's avatar
POTTIER Francois committed
636
## 2011/05/24
637 638 639 640

* 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.
641

POTTIER Francois's avatar
POTTIER Francois committed
642
## 2011/04/28
643 644 645 646 647

* 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!
648

POTTIER Francois's avatar
POTTIER Francois committed
649
## 2011/04/07
650 651 652 653

* 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.
654

POTTIER Francois's avatar
POTTIER Francois committed
655
## 2011/04/05
656 657 658

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

POTTIER Francois's avatar
POTTIER Francois committed
660
## 2011/01/24
661 662 663 664 665

* 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.
666

POTTIER Francois's avatar
POTTIER Francois committed
667
## 2009/06/18
668 669 670

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

POTTIER Francois's avatar
POTTIER Francois committed
672
## 2009/02/06
673 674 675

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

POTTIER Francois's avatar
POTTIER Francois committed
677
## 2009/02/04
678 679 680

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

POTTIER Francois's avatar
POTTIER Francois committed
682
## 2008/09/05
683 684

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

POTTIER Francois's avatar
POTTIER Francois committed
686
## 2008/08/06
687 688 689

* 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.
690

691
* Removed code sharing.
692

POTTIER Francois's avatar
POTTIER Francois committed
693
## 2008/06/20
694 695

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

POTTIER Francois's avatar
POTTIER Francois committed
697
## 2007/12/05
698 699 700

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

POTTIER Francois's avatar
POTTIER Francois committed
702
## 2007/12/01
703 704 705

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

POTTIER Francois's avatar
POTTIER Francois committed
707
## 2007/08/30
708 709 710

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

POTTIER Francois's avatar
POTTIER Francois committed
712
## 2007/05/20
713 714 715 716

* 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.
717

POTTIER Francois's avatar
POTTIER Francois committed
718
## 2007/05/18
719 720 721

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

POTTIER Francois's avatar
POTTIER Francois committed
723
## 2007/05/11
724 725 726 727 728

* 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`.
729

POTTIER Francois's avatar
POTTIER Francois committed
730
## 2007/03/22
731 732 733

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

POTTIER Francois's avatar
POTTIER Francois committed
735
## 2007/02/15
736 737

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

POTTIER Francois's avatar
POTTIER Francois committed
739
## 2006/12/15
740 741

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

POTTIER Francois's avatar
POTTIER Francois committed
743
## 2006/06/23
744 745 746 747

* 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.
748

POTTIER Francois's avatar
POTTIER Francois committed
749
## 2006/06/16
750 751

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

POTTIER Francois's avatar
POTTIER Francois committed
753
## 2006/06/15
754 755 756 757

* 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`).
758

POTTIER Francois's avatar
POTTIER Francois committed
759
## 2006/06/12
760 761 762 763 764 765 766 767 768 769

* 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.
770

POTTIER Francois's avatar
POTTIER Francois committed
771
## 2006/05/05
772 773 774

* 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.
775

POTTIER Francois's avatar
POTTIER Francois committed
776
## 2006/04/21
777 778 779 780

* Fixed problem that allowed generating incorrect but apparently well-typed
  Objective Caml code when a semantic action was ill-typed and `--infer` was
  omitted.
781

POTTIER Francois's avatar
POTTIER Francois committed
782
## 2006/03/29
783 784

* Improved conflict reports by factoring out maximal common derivation contexts.
785

POTTIER Francois's avatar
POTTIER Francois committed
786
## 2006/03/28
787 788

* Fixed bug that could arise when explaining a conflict in a non-LALR(1) grammar.
789

POTTIER Francois's avatar
POTTIER Francois committed
790
## 2006/03/27
791

792 793
* Changed count of reduce/reduce conflicts to allow a comparison
  with `ocamlyacc`'s diagnostics.
794
* When refusing to resolve a conflict, report all diagnostics before dying.
795

POTTIER Francois's avatar
POTTIER Francois committed
796
## 2006/03/18
797 798 799 800

* Added display of `FOLLOW` sets when using `--log-grammar 2`.
* Added `--graph` option.
* Fixed behavior of `--depend` option.
801

POTTIER Francois's avatar
POTTIER Francois committed
802
## 2006/01/06
803 804

* Removed reversed lists from the standard library.