adjust documentation for the merge of the dstar parser

* NEWS: Mention the changes.
* doc/org/autfilt.org, doc/org/dstar2tgba.org,
doc/org/ltlcross.org, doc/org/tools.org, doc/org/tut20.org,
src/bin/man/dstar2tgba.x, src/bin/man/ltlcross.x: Adjust
documentation.
* src/bin/common_trans.cc: Use %O instead of %D, but keep %D
hidden for backward compatibility.

src/bin/common_trans.cc

@@ -427,9 +427,9 @@ static const argp_option options[] =
       0 },
     { "%F,%S,%L,%W", 0, 0, OPTION_DOC | OPTION_NO_USAGE,
       "the formula as a file in Spot, Spin, LBT, or Wring's syntax", 0 },
-    { "%O,%D", 0, 0, OPTION_DOC | OPTION_NO_USAGE,
-      "the automaton is output as either (%O) HOA/never claim/LBTT, or (%D) "
-      "in LTL2DSTAR's format", 0 },
+    { "%O", 0, 0, OPTION_DOC | OPTION_NO_USAGE,
+      "the automaton is output in HOA, never claim, LBTT, or ltl2dstar's "
+      "format", 0 },
     { "%%", 0, 0, OPTION_DOC | OPTION_NO_USAGE, "a single %", 0 },
     { 0, 0, 0, 0,
       "If either %l, %L, or %T are used, any input formula that does "

src/bin/man/dstar2tgba.x

@@ -1,5 +1,62 @@
 [NAME]
-dstar2tgba \- convert Rabin or Streett automata into Büchi automata
+dstar2tgba \- convert automata into Büchi automata
+[HISTORY]
+.B dstar2tgba
+was introduced in Spot 1.2 as a command that reads automata
+in
+.BR ltl2dstar 's
+format, and converts them into TGBA.  At this time it was
+the only command-line tool being able to read automata.
+.PP
+In Spot 1.99.1 the
+.B autfilt
+command was introduced, but could only read automata
+in the HOA format, or in
+.BR lbtt 's
+format, or as never claims.  So
+.B dstar2tgba
+was still the only way to process automata
+in
+.BR ltl2dstar 's
+format.
+.PP
+In Spot 1.99.4 the parser for
+.BR ltl2dstar 's
+format was finally merged with the parser
+used by
+.B autfilt
+for reading the other format.  This implies not only
+that
+.B autfilt
+can now read
+.BR ltl2dstar's
+format, but also that
+.B dstar2tgba
+can read the other formats as well.
+
+Nowadays, the command
+.PP
+.in +4n
+.nf
+.ft C
+% dstar2tgba some files
+.fi
+.PP
+can be used as a shorthand for
+.PP
+.in +4n
+.nf
+.ft C
+% autfilt \-\-tgba \-\-high \-\-small some files
+.fi
+.PP
+The name
+.B dstar2tgba
+is kept for backward compatibility and because it is used
+in at least one published paper, but naming this tool
+.B aut2tgba
+would make more sense.
+
 [BIBLIOGRAPHY]
 .TP
 1.

src/bin/man/ltlcross.x

@@ -204,22 +204,18 @@ Some development versions leading to 1.99.1 also featured
 An output file in the HOA format.
 .PP
 Different specifiers were needed because Spot implemented
-different parsers for these formats.  Nowadays, the parsers
-for never claims, lbtt's format, and HOA format have been merged into
-a single parser that is able to distinguish these three formats
-automatically.
+different parsers for these formats.  Nowadays, these parsers
+have been merged into a single parser that is able to
+distinguish these four formats automatically.
 .B ltlcross
-officially supports only two output specifiers
+officially supports only one output specifier:
 .TP
 %O
-An output file in either \fBlbtt\fR's format, as a never claim,
-or in the HOA format
-.TP
-%D
-An output file in \fBltl2dstar\fR's format.
+An output file in either \fBlbtt\fR's format, \fBltl2dstar\fR's format,
+as a never claim, or in the HOA format
 .P
-For backward compatibility, the sequences %N, %T, and %H are still
-supported (as aliases for %O), but are deprecated.
+For backward compatibility, the sequences %D, %H, %N, and %T, are
+still supported (as aliases for %O), but are deprecated.
 
 [SEE ALSO]
 .BR randltl (1),