bin: fix documentation of degeneralization option

Reported by Jan Strejček.

* src/bin/spot-x.cc: Fix documentation.
* src/twaalgos/degen.cc, src/twaalgos/degen.hh: Fix comments.
This commit is contained in:
Alexandre Duret-Lutz 2015-06-15 21:54:18 +02:00
parent b2e812b105
commit b7fbf72461
3 changed files with 12 additions and 10 deletions

View file

@ -65,17 +65,17 @@ accepting sets. Set to 0 to disable this SCC-pruning and acceptance \
simpification pass.") }, simpification pass.") },
{ DOC("degen-reset", "If non-zero (the default), the \ { DOC("degen-reset", "If non-zero (the default), the \
degeneralization algorithm will reset its level any time it exits \ degeneralization algorithm will reset its level any time it exits \
a non-accepting SCC.") }, an SCC.") },
{ DOC("degen-lcache", "If non-zero (the default), whenever the \ { DOC("degen-lcache", "If non-zero (the default is 1), whenever the \
degeneralization algorithm enters an SCC on a state that has already \ degeneralization algorithm enters an SCC on a state that has already \
been associated to a level elsewhere, it should reuse that level. \ been associated to a level elsewhere, it should reuse that level. \
Different values can be used to select which level to reuse: 1 always \ Different values can be used to select which level to reuse: 1 always \
uses the first level seen, 2 uses the minimum level seen so far, and \ uses the first level created, 2 uses the minimum level seen so far, and \
3 uses the maximum level seen so far. The \"lcache\" stands for \ 3 uses the maximum level seen so far. The \"lcache\" stands for \
\"level cache\".") }, \"level cache\".") },
{ DOC("degen-order", "If non-zero, the degeneralization algorithm \ { DOC("degen-order", "If non-zero, the degeneralization algorithm \
will compute one degeneralization order for each SCC it processes. \ will compute an independent degeneralization order for each SCC it \
This is currently disabled by default.") }, processes. This is currently disabled by default.") },
{ DOC("degen-lskip", "If non-zero (the default), the degeneralization \ { DOC("degen-lskip", "If non-zero (the default), the degeneralization \
algorithm will skip as much levels as possible for each transition. This \ algorithm will skip as much levels as possible for each transition. This \
is enabled by default as it very often reduce the number of resulting \ is enabled by default as it very often reduce the number of resulting \
@ -84,11 +84,13 @@ automaton tends to have smaller cycles around the accepting states. \
Disabling skipping will produce automata with large cycles, and often \ Disabling skipping will produce automata with large cycles, and often \
with more states.") }, with more states.") },
{ DOC("degen-lowinit", "Whenever the degeneralization algorihm enters \ { DOC("degen-lowinit", "Whenever the degeneralization algorihm enters \
a new SCC (or starts from the initial states), it starts on a level that \ a new SCC (or starts from the initial state), it starts on some level L that \
is compatible with all outgoing transitions. If degen-lowinit is zero \ is compatible with all outgoing transitions. If degen-lowinit is zero \
(the default) and the corresponding state (in the generalized automaton) \ (the default) and the corresponding state (in the generalized automaton) \
has an accepting self-loop, then the level is set to the accepting \ has an accepting self-loop, then level L is replaced by the accepting \
level, as it might favor finding accepting cycles earlier.") }, level, as it might favor finding accepting cycles earlier. If \
degen-lowinit is non-zero, then level L is always used without looking \
for the presence of an accepting self-loop.") },
{ DOC("simul", "Set to 0 to disable simulation-based reductions. \ { DOC("simul", "Set to 0 to disable simulation-based reductions. \
Set to 1 to use only direct simulation. Set to 2 to use only reverse \ 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. \ simulation. Set to 3 to iterate both direct and reverse simulations. \

View file

@ -426,7 +426,7 @@ namespace spot
acc = otheracc; acc = otheracc;
// If use_z_lvl is on, start with level zero 0 when // If use_z_lvl is on, start with level zero 0 when
// swhitching SCCs // switching SCCs
unsigned next = (!use_z_lvl || s_scc == scc) ? slevel : 0; unsigned next = (!use_z_lvl || s_scc == scc) ? slevel : 0;
// If using custom acc orders, get next level // If using custom acc orders, get next level

View file

@ -31,7 +31,7 @@ namespace spot
/// at most (N+1) times the number of states of the original automaton. /// at most (N+1) times the number of states of the original automaton.
/// ///
/// When \a use_z_lvl is set, the level of the degeneralized /// When \a use_z_lvl is set, the level of the degeneralized
/// automaton is reset everytime an accepting SCC is exited. If \a /// automaton is reset everytime an SCC is exited. If \a
/// use_cust_acc_orders is set, the degeneralization will compute a /// use_cust_acc_orders is set, the degeneralization will compute a
/// custom acceptance order for each SCC (this option is disabled by /// custom acceptance order for each SCC (this option is disabled by
/// default because our benchmarks show that it usually does more /// default because our benchmarks show that it usually does more