--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.--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.--timings-to <filename> causes internal timing information to be written to the file <filename>.fix is now vendored (included inside) Menhir. This should have no impact for end users, but implies that dune 2.2.0 or later is required.ocamlfind. This distinction disappears. The command line switch --suggest-ocamlfind is deprecated and causes Menhir to print false.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.)standard.mly. This removes the need to 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.)String.escaped. Fixed. (Reported by ELLIOTCABLE.)< > (with arbitrary whitespace inside the angle brackets) instead of just <>. (Suggested by Lélio Brun.)%inline nonterminal symbols is encountered, the error message now shows the entire cycle, as opposed to just one symbol that participates in the cycle.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.)Obj.magic in client code when the parser is used via extraction.--coq-no-version-check..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; a brief summary of the differences with respect to the old syntax is also available. The new syntax is considered experimental and is subject to change in the near future.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.)%inline symbols. This leads to slightly more readable code (more reasonable variables names, fewer let bindings)..messages files. (I hope I got it right, this time.)%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.); 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.--no-dollars, which disallows the use of $i in semantic actions. The default behavior remains to allow the use of $i.rev, flatten, append. Add a link from the manual to standard.mly in the repository.dune and menhir together..cmxs files for menhirLib and menhirSdk.Pervasives in the generated OCaml code. These references were infrequent anyway, and Pervasives is about to be deprecated in OCaml 4.08, it seems.--interpret mode, print Ready! once ready to accept input.-lg 2, for each nonterminal symbol N, display a sentence (composed of terminal symbols) of minimal length generated by N..cmly file, open it in binary mode. This should eliminate the failure that was observed under Windows: output_value: not a binary channel. (Reported by Bryan Phelps. A fix was present in the mingw patches for Menhir.)Makefile to deal with Unix and Windows in a uniform way. (Also inspired by the mingw patches for Menhir.).messages files. (Suggested by Xavier Leroy.)--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.--strict. No .conflicts file was created when --strict and --explain were both enabled. Also, some warnings were not properly turned into errors by --strict.man page, which was woefully out of date.$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.)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.--coq mode, Menhir now produces references to MenhirLib.Grammar instead of just Grammar, and similarly for all modules in Menhir's support library.--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.--coq-lib-path <path> to indicate under what name (or path) the support library has been installed. Its default value is MenhirLib.--infer-write-query, --infer-read-reply, and --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.)%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.--unused-precedence-levels to suppress all warnings about useless %left, %right, %nonassoc and %prec declarations. (Suggested by Zachary Tatlock.)%type declarations should carry types whose meaning does not depend on the headers %{ ... %}.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.).tar.gz archive. This should allow the manual to be included as part of the Debian package..mly files, in the manual..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.)--cmly, which causes Menhir to create a .cmly file, containing a description of the grammar and automaton. (Suggested by Frédéric Bour.).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.).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.)%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.)shifts, acceptable, current_state_number.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.)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.env becomes 'a env.has_default_reduction is renamed env_has_default_reduction.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.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.).mly file is incorrect: the previous and next token are shown.Basics was shadowed (that is, if the user's project happened to contain a toplevel module by this name, then it could not be referred to from a .mly file). (Reported by François Thiré.)$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.)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.)--only-preprocess-for-ocamlyacc mode: avoid printing newline characters inside a %type declaration, as this is forbidden by ocamlyacc. (Reported by Kenji Maillard.)--only-preprocess-for-ocamlyacc mode: avoid variable capture caused by ocamlyacc internally translating $i to _i. (Reported by Kenji Maillard.)--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.Fixes in the output of --only-preprocess:
%parameter directives are now printed. (They were not).%on_error_reduce directives are now printed. (They were not.)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.)%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.Error has the same name as the data constructor Error in OCaml's pervasive library. (Reported by Bernhard Schommer.)--only-preprocess options), remove the leading bar |, for compatibility with yacc and bison.ocamlbuild 4.03, which seems to have stricter hygiene rules than previous versions.USE_OCAMLFIND was given during make all but not during make install. Added a command line directive --suggest-ocamlfind.XXXXXXXX of menhir --table can now be linked only 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.$symbolstartpos, based on a couple of assumptions about the lexer. (See the manual.)%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.%inline that would lead to an incorrect position being computed when the caller and callee had a variable by the same name.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.lexbuf.lex_curr_p.Makefile in an attempt to allow installation under opam/Windows. Thanks to Daniel Weil for patient explanations and testing.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).--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.%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.%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.has_default_reduction to the incremental API.--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.)--list-errors, which produces a list of input sentences which are representative of all possible syntax errors. (Costly.)--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.--compile-errors, which compiles a list of erroneous sentences (together with error messages) to OCaml code.--compare-errors, which compares two lists of erroneous sentences to check if they cover the same error states.--update-errors, which updates the auto-generated comments in a list of erroneous sentences.--echo-errors, which removes all comments and messages from a list of erroneous sentences, and echoes just the sentences.Additions to the incremental API.
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.'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.$(shell pwd) in Makefile, for better Windows compatibility.--table and --external-tokens were used together. (Reported by Darin Morrison.)--infer mode, leave the .ml file around (instead of removing it) if ocamlc fails, so we have a chance to understand what's wrong.$i which had disappeared on 2015/06/29.--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.--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.--unused-token <symbol> and --unused-tokens.$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.list(e = expression SEMI { e }) whereas previously one should have written list(terminated(e, SEMI)).ocamlbuild (instead of make).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.)main_incremental is now named Incremental.main.Incompatible change of the incremental API.
'a result is now private.env is no longer parameterized.handle is renamed to resume.offer and resume now expect a result, not an environment.--table mode only), inspired by Frédéric Bour.$previouserror keyword.--error-recovery mode.' instead of _ as separator in identifiers. Also, correct a serious bug that was inadvertently introduced on 2013/03/01 (r319).[> ...] within a %type<...> declaration.Makefile so that install no longer depends on all.exit 0 when encoutering eof. (This should be more intuitive.)menhir --depend was broken since someone added new whitespace in the output of ocamldep. Fixed.Invariant). The improvements will be noticeable only for very large automata.--log-grammar 3 (and above) now causes the FOLLOW sets for terminal symbols to be computed and displayed.--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.%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.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:
menhir or menhir.exe.o or .obj--strict, which causes many warnings about the grammar and about the automaton to be considered errors.# 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.-lg 1 switch, Menhir now indicates whether the grammar is SLR(1).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..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.Makefile changes: build and install only the bytecode version of MenhirLib when TARGET=byte is set.ocamldep.wrapper to avoid quoting the name of the ocaml command. This is hoped to fix a compilation problem under MinGW.Makefile fix to avoid a problem under Windows/Cygwin.ocaml-check-version script so as to avoid a warning.--interpret, --table, and --suggest-*.lr1.ml, line 134).Makefile change: create an executable file for check-ocaml-version in order to work around the absence of dynamic loading on some platforms.--follow-construction to help understand the construction of the LR(1) automaton (very verbose).Pervasives so as to avoid capture when the user redefines some of the built-in operators, such as (+).calc-param) that shows how to use %parameter.Makefile improvements (check for PREFIX; bootstrap in bytecode now also available). Slight changes to OMakefile.shared.Makefile and Makefile.shared (avoided which).Makefile.shared (replaced &> with 2>&1 >).Lr0.compatible). This might help make conflict explanations more accurate in the future.--depend to be more lenient when analyzing ocamldep's output.--raw-depend which transmits ocamldep's output unchanged (for use in conjunction with omake).--only-preprocess to print %token declarations also for pseudo-tokens.%type directives for terminal symbols to be incorrectly accepted.$i keywords was inlined.--infer was omitted.ocamlyacc's diagnostics.FOLLOW sets when using --log-grammar 2.--graph option.--depend option.