spot-x.7: new man page for common fine-tuning options

* src/bin/spot-x.cc, src/bin/man/spot-x.x: New files.
* src/bin/Makefile.am, src/bin/man/Makefile.am: Adjust.
* src/bin/man/ltl2tgba.x: Remove all fine-tuning options,
and make a reference spot spot-x (7).
* src/bin/common_setup.hh, src/bin/common_setup.cc: Add
a misc_argp_hidden version of the option, so that --help
and --version are not shown in the --help output used
by help2man to generate spot-x.7.
* src/bin/ltl2tgba.cc: Refer to spot-x.7.
This commit is contained in:
Alexandre Duret-Lutz 2013-03-23 17:08:28 +01:00
parent 1337c9c3e1
commit d78670ad44
9 changed files with 135 additions and 52 deletions

View file

@ -28,7 +28,8 @@ dist_man1_MANS = \
ltl2tgta.1 \
ltlcross.1 \
ltlfilt.1 \
randltl.1
randltl.1 \
spot-x.7
MAINTAINERCLEANFILES = $(dist_man1_MANS)
EXTRA_DIST = $(dist_man1_MANS:.1=.x)
@ -50,3 +51,6 @@ genltl.1: $(common_dep) $(srcdir)/genltl.x $(srcdir)/../genltl.cc
randltl.1: $(common_dep) $(srcdir)/randltl.x $(srcdir)/../randltl.cc
$(convman) ../randltl$(EXEEXT) $(srcdir)/randltl.x $@
spot-x.7: $(common_dep) $(srcdir)/spot-x.x $(srcdir)/../spot-x.cc
$(convman) ../spot-x$(EXEEXT) $(srcdir)/spot-x.x $@

View file

@ -2,51 +2,5 @@
ltl2tgba \- translate LTL/PSL formulas into Büchi automata
[DESCRIPTION]
.\" Add any additional description here
[FINE-TUNING OPTIONS]
The \fB\-\-extra\-options\fR argument is a comma-separated list of
\fIKEY\fR=\fIINT\fR assignments that are passed to the post-processing
routines (they may be passed to other algorithms in the future).
These options are mostly used for benchmarking and debugging
purpose. \fIKEY\fR (without any value) is a
shorthand for \fIKEY\fR=1, and !\fIKEY\fR is a shorthand for
\fIKEY\fR=0.
Supported options are:
.TP
\fBscc\-filter\fR
Set to 1 (the default) to enable SCC-pruning and acceptance
simplification at the beginning of post-processing. Transitions that
are outside of accepting SCC are removed from accepting sets, except
those that enter into an accepting SCC. Set to 2 to remove even these
entering transition from the accepting sets. Set to 0 to disable this
SCC-pruning and acceptance simpification pass.
.TP
\fBdegen\-reset\fR
If non-zero (the default), the degeneralization algorithm will reset
its level any time it exits a non-accepting SCC.
.TP
\fBdegen\-lcache\fR
If non-zero (the default), whenever the degeneralization algorithm enters
an SCC on a state that has already been associated to a level elsewhere,
it should reuse that level. The "lcache" stands for "level cache".
.TP
\fBdegen\-order\fR
If non-zero, the degeneralization algorithm will compute one degeneralization
order for each SCC it processes. This is currently disabled by default.
.TP
\fBsimul\fR
Set to 0 to disable simulation-based reductions. Set to 1 to use only
direct simulation. Set to 2 to use only reverse simulation. Set to 3
to iterate both direct and reverse simulations. Set to 4 to apply
only "don't care" direct simulation. Set to 5 to iterate "don't care"
direct simulation and reverse simulation. The default is 3, except
when option \fB\-\-low\fR is specified, in which case the default is
1.
.TP
\fBsimul-limit\fR
Can be set to a positive integer to cap the number of "don't care"
transitions considered by the "don't care"-simulation algorithm. A
negative value (the default) does not enforce any limit. Note that if
there are \fIN\fR "don't care" transitions, the algorithm may
potentially test 2^\fIN\fR configurations.
[SEE ALSO]
.BR spot-x (7)

10
src/bin/man/spot-x.x Normal file
View file

@ -0,0 +1,10 @@
[NAME]
spot-x \- Common fine-tuning options.
[SYNOPSIS]
.B \-\-extra-options STRING
.br
.B \-x STRING
[DESCRIPTION]
.\" Add any additional description here
[SEE ALSO]
.BR ltl2tgba (1)