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

CHANGES.md

 # Changes
 
+## 2018/07/04
+
+* Update the `man` page, which was woefully out of date.
+
 ## 2018/07/03
 
 * New location keywords.

doc/menhir.1

 .\"                                      Hey, EMACS: -*- nroff -*-
-.TH MENHIR 1 "April 19, 2006"
+.TH MENHIR 1 "July 03, 2018"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -15,18 +15,18 @@
 
 
 .SH NAME
-menhir \- parser generator for OCaml
-
+menhir \- an LR(1) parser generator for OCaml
 
 .SH SYNOPSIS
 .B menhir
 .RI [ options ] " files"
 .SH DESCRIPTION
 .B menhir
-is a LR(1) parser generator for the Objective Caml programming language. That is, Menhir compiles LR(1) grammar specifications down to Objective Caml code. It is mostly compatible with
+is an LR(1) parser generator for the OCaml programming language.
+That is, Menhir compiles LR(1) grammar specifications down to
+OCaml code. It is mostly compatible with
 .BR ocamlyacc (1).
 
-
 .SH OPTIONS
 .TP
 .B \-h, \-\-help
@@ -35,9 +35,37 @@ Show summary of options.
 .BI \-b,\ \-\-base\  basename
 Specifies a base name for the output file(s).
 .TP
+.B \-\-canonical
+Construct a canonical Knuth LR(1) automaton.
+.TP
+.B \-\-cmly
+Write the grammar and automaton to
+.IR basename .cmly.
+.TP
 .B \-\-comment
 Include comments in the generated code.
 .TP
+.BI \-\-compare\-errors\  file1\  \-\-compare\-errors\  file2
+Compare two .messages files.
+.TP
+.BI \-\-compile\-errors\  file
+Compile a .messages file to OCaml code.
+.TP
+.B \-\-coq
+Generate a formally verified parser, in Coq.
+.TP
+.BI \-\-coq\-lib\-path\  path
+How to qualify references to MenhirLib.
+.TP
+.B \-\-coq\-lib\-no\-path
+Do not qualify references to MenhirLib.
+.TP
+.B \-\-coq\-no\-actions
+Ignore semantic actions in the Coq output.
+.TP
+.B \-\-coq\-no\-complete
+Do not generate a proof of completeness.
+.TP
 .B \-\-depend
 Invoke ocamldep and display dependencies.
 .TP
@@ -45,8 +73,8 @@ Invoke ocamldep and display dependencies.
 Describe the automaton in
 .IR basename .automaton.
 .TP
-.B \-\-error\-recovery
-Attempt recovery by discarding tokens after errors.
+.BI \-\-echo\-errors\  file
+Echo the sentences in a .messages file.
 .TP
 .B \-\-explain
 Explain conflicts in
@@ -56,6 +84,9 @@ Explain conflicts in
 Import token type definition from
 .IR module .
 .TP
+.B \-\-fixed\-exception
+Declares Error = Parsing.Parse_error.
+.TP
 .B \-\-graph
 Write grammar's dependency graph to
 .IR basename .dot.
@@ -63,12 +94,30 @@ Write grammar's dependency graph to
 .B \-\-infer
 Invoke ocamlc for ahead of time type inference.
 .TP
+.B \-\-infer\-protocol\-supported
+Stop with exit code 0.
+.TP
+.BI \-\-infer\-write\-query\  file
+Write mock .ml file.
+.TP
+.BI \-\-infer\-read\-reply\  file
+Read inferred .mli file.
+.TP
+.B \-\-inspection
+Generate the inspection API.
+.TP
 .B \-\-interpret
 Interpret the sentences provided on stdin.
 .TP
 .B \-\-interpret\-show\-cst
 Show a concrete syntax tree upon acceptance.
 .TP
+.B \-\-interpret\-error
+Interpret an error sentence provided on stdin.
+.TP
+.B \-\-lalr
+Construct an LALR(1) automaton.
+.TP
 .BI \-la,\ \-\-log\-automaton\  level
 Log information about the automaton.
 .TP
@@ -78,6 +127,9 @@ Log information about the generated code.
 .BI \-lg,\ \-\-log\-grammar\  level
 Log information about the grammar.
 .TP
+.B \-\-list\-errors
+Produce a list of erroneous inputs.
+.TP
 .B \-\-no\-inline
 Ignore the %inline keyword.
 .TP
@@ -93,6 +145,15 @@ Specifies how ocamldep should be invoked.
 .B \-\-only\-preprocess
 Print a simplified grammar and exit.
 .TP
+.B \-\-only\-preprocess\-for\-ocamlyacc
+Print grammar in ocamlyacc format and exit.
+.TP
+.B \-\-only\-preprocess\-u
+Print grammar with unit actions and exit.
+.TP
+.B \-\-only\-preprocess\-uu
+Print grammar with unit actions and tokens and exit.
+.TP
 .B \-\-only\-tokens
 Generate token type definition only, no code.
 .TP
@@ -102,6 +163,9 @@ Invoke ocamldep and echo its raw output.
 .BI \-\-stdlib\  directory
 Specify where the standard library lies.
 .TP
+.B \-\-strict
+Warnings about the grammar are errors.
+.TP
 .B \-\-suggest\-comp\-flags
 Suggest compilation flags for ocaml{c,opt}.
 .TP
@@ -111,6 +175,12 @@ Suggest link flags for ocamlc.
 .B \-\-suggest\-link\-flags-opt
 Suggest link flags for ocamlopt.
 .TP
+.B \-\-suggest\-menhirLib
+Suggest where MenhirLib was installed in source form.
+.TP
+.B \-\-suggest\-ocamlfind
+Show if Menhir was installed using ocamlfind.
+.TP
 .B \-t, \-\-table
 Use the table-based back-end.
 .TP
@@ -120,6 +190,20 @@ Display internal timings.
 .B \-\-trace
 Include tracing instructions in the generated code.
 .TP
+.B \-\-unused\-precedence\-levels
+Do not warn about unused precedence levels.
+.TP
+.BI \-\-unused\-token\  token
+Do not warn that
+.IR token
+is unused.
+.TP
+.B \-\-unused\-tokens
+Do not warn about any unused token.
+.TP
+.BI \-\-update\-errors\  file
+Update auto-comments in a .messages file.
+.TP
 .B \-\-version
 Show version number and exit.
 .TP
@@ -136,5 +220,5 @@ Synonymous with
 .B menhir
 was written by Fran\(,cois Pottier and Yann R\('egis-Gianas.
 .PP
-This manual page was written by Samuel Mimram <smimram@debian.org>,
+This manual page was originally written by Samuel Mimram <smimram@debian.org>
 for the Debian project (but may be used by others).