[antlr3] 14/17: Updated the man page

[Emmanuel Bourg]

This is an automated email from the git hooks/post-receive script.

ebourg-guest pushed a commit to branch master
in repository antlr3.

commit d0e481241711e57a38b1328b07377ef06f9f86c9
Author: Emmanuel Bourg <ebourg at apache.org>
Date:   Wed Jul 22 14:01:55 2015 +0200

    Updated the man page
---
 debian/changelog        |  1 +
 debian/scripts/antlr3.1 | 75 +++++++++++++++++++++++++++++++++++++++++++------
 2 files changed, 68 insertions(+), 8 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 2e96487..efa5553 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,6 +5,7 @@ antlr3 (3.5.2-1) UNRELEASED; urgency=medium
     - Ignore the new modules: antlr-complete, antlr3-maven-archetype
     - Added a dependency on libstringtemplate4-java
     - Refreshed debian/generated-sources
+    - Updated the man page
   * debian/rules:
     - Changed the bnd command to work with any upstream version
     - Remove the antlr3 artifacts from debian/maven-repo before invoking Maven
diff --git a/debian/scripts/antlr3.1 b/debian/scripts/antlr3.1
index b23e322..8cd0b37 100644
--- a/debian/scripts/antlr3.1
+++ b/debian/scripts/antlr3.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH ANTLR 3 "June 27, 2010" GNU antlr
+.TH ANTLR 3 "July 22, 2015" antlr
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -18,16 +18,15 @@
 .SH "NAME"
 ANTLR \- ANother Tool for Language Recognition, version 3
 .SH "SYNOPSIS"
-.B java org.antlr.Tool
-.B or
 .B antlr3
 [\fIargs\fR] \fIfile.g\fR [ \fIfile2.g\fR \fIfile3.g\fR ...]
 .br
 .SH "DESCRIPTION"
-ANTLR, ANother Tool for Language Recognition, (formerly PCCTS) is a
-language tool that provides a framework for constructing recognizers,
-compilers, and translators from grammatical descriptions containing
-C++ or Java actions.
+ANTLR (ANother Tool for Language Recognition) is a parser generator
+for reading, processing, executing, or translating structured text
+or binary files. It's widely used to build languages, tools, and
+frameworks. From a grammar, ANTLR generates a parser that can build
+and walk parse trees.
 .TP
 \fB\-o\fR \fIoutputDir\fR
 specify output directory where all output generated.
@@ -53,6 +52,9 @@ generate a parser that emits debugging events.
 \fB\-profile\fR
 generate a parser that computes profiling information.
 .TP
+\fB\-trace\fR
+generate a recognizer that traces rule entry/exit.
+.TP
 \fB\-nfa\fR
 generate an NFA for each rule.
 .TP
@@ -71,8 +73,65 @@ only build if generated files older than grammar.
 \fB\-version\fR
 print the version of ANTLR and exit.
 .TP
+\fB\-language\fR \fIL\fR
+override language grammar option; generate L
+.TP
 \fB\-X\fR
-display extended argument list.
+display the list of extended arguments
+.TP
+\fB\-Xgrtree\fR
+print the grammar AST
+.TP
+\fB\-Xdfa\fR
+print DFA as text
+.TP
+\fB\-Xnoprune\fR
+test lookahead against EBNF block exit branches
+.TP
+\fB\-Xnocollapse\fR
+collapse incident edges into DFA states
+.TP
+\fB\-Xdbgconversion\fR
+dump lots of info during NFA conversion
+.TP
+\fB\-Xconversiontimeout\fR
+use to restrict NFA conversion exponentiality
+.TP
+\fB\-Xmultithreaded\fR
+run the analysis in 2 threads
+.TP
+\fB\-Xnomergestopstates\fR
+do not merge stop states
+.TP
+\fB\-Xdfaverbose\fR
+generate DFA states in DOT with NFA configs
+.TP
+\fB\-Xwatchconversion\fR
+print a message for each NFA before converting
+.TP
+\fB\-XdbgST\fR
+put tags at start/stop of all templates in output
+.TP
+\fB\-Xnfastates\fR
+for nondeterminisms, list NFA states for each path
+.TP
+\fB\-Xm\fR \fIm\fR
+max number of rule invocations during conversion [4]
+.TP
+\fB\-Xmaxdfaedges\fR \fIm\fR
+max "comfortable" number of edges for single DFA state [65534]
+.TP
+\fB\-Xmaxinlinedfastates\fR \fIm\fR
+max DFA states before table used rather than inlining [60]
+.TP
+\fB\-Xmaxswitchcaselabels\fR \fIm\fR
+don't generate switch() statements for dfas bigger than m [300]
+.TP
+\fB\-Xminswitchalts\fR \fIm\fR
+don't generate switch() statements for dfas smaller than m [3]
+.TP
+\fB\-Xsavelexer\fR
+don't delete temporary lexers generated from combined grammars
 
 .SH "AUTHOR"
 This manual page was written by Ludovic Claude <ludovic.claude at laposte.net>

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-java/antlr3.git