Commit 1ec9cebe authored by Alexandre Duret-Lutz's avatar Alexandre Duret-Lutz
Browse files

Move \ingroup before \brief in all Doxygen comments.

Using \ingroup between \brief and the rest of the documentation causes
Doxygen to concatenate the brief with the rest of the doc.

* src/sanity/style.test: Warn when \ingroup is found
on the line after \brief.
* src/kripke/fairkripke.hh, src/kripke/kripke.hh,
src/kripke/kripkeprint.hh, src/ltlast/atomic_prop.hh,
src/ltlast/automatop.hh, src/ltlast/binop.hh, src/ltlast/bunop.hh,
src/ltlast/constant.hh, src/ltlast/formula.hh, src/ltlast/multop.hh,
src/ltlast/refformula.hh, src/ltlast/unop.hh, src/ltlast/visitor.hh,
src/ltlenv/declenv.hh, src/ltlenv/defaultenv.hh,
src/ltlenv/environment.hh, src/ltlparse/ltlfile.hh,
src/ltlvisit/clone.hh, src/ltlvisit/destroy.hh, src/ltlvisit/dotty.hh,
src/ltlvisit/dump.hh, src/ltlvisit/length.hh, src/ltlvisit/lunabbrev.hh,
src/ltlvisit/mark.hh, src/ltlvisit/nenoform.hh, src/ltlvisit/postfix.hh,
src/ltlvisit/randomltl.hh, src/ltlvisit/reduce.hh,
src/ltlvisit/relabel.hh, src/ltlvisit/simpfg.hh,
src/ltlvisit/simplify.hh, src/ltlvisit/tunabbrev.hh,
src/ltlvisit/wmunabbrev.hh, src/misc/bddalloc.hh, src/misc/bddlt.hh,
src/misc/freelist.hh, src/misc/hash.hh, src/misc/ltstr.hh,
src/misc/minato.hh, src/misc/modgray.hh, src/misc/optionmap.hh,
src/misc/version.hh, src/saba/explicitstateconjunction.hh,
src/saba/saba.hh, src/saba/sabacomplementtgba.hh, src/saba/sabastate.hh,
src/saba/sabasucciter.hh, src/sabaalgos/sabadotty.hh,
src/sabaalgos/sabareachiter.hh, src/ta/ta.hh, src/ta/taproduct.hh,
src/ta/tgta.hh, src/taalgos/reachiter.hh, src/taalgos/tgba2ta.hh,
src/tgba/futurecondcol.hh, src/tgba/sba.hh, src/tgba/state.hh,
src/tgba/succiter.hh, src/tgba/tgba.hh, src/tgba/tgbabddconcrete.hh,
src/tgba/tgbabddconcreteproduct.hh, src/tgba/tgbakvcomplement.hh,
src/tgba/tgbaproduct.hh, src/tgba/tgbasafracomplement.hh,
src/tgba/tgbascc.hh, src/tgba/tgbasgba.hh, src/tgba/tgbatba.hh,
src/tgba/tgbaunion.hh, src/tgba/wdbacomp.hh, src/tgbaalgos/bfssteps.hh,
src/tgbaalgos/degen.hh, src/tgbaalgos/dotty.hh,
src/tgbaalgos/dottydec.hh, src/tgbaalgos/dupexp.hh,
src/tgbaalgos/eltl2tgba_lacim.hh, src/tgbaalgos/lbtt.hh,
src/tgbaalgos/ltl2taa.hh, src/tgbaalgos/ltl2tgba_fm.hh,
src/tgbaalgos/ltl2tgba_lacim.hh, src/tgbaalgos/neverclaim.hh,
src/tgbaalgos/powerset.hh, src/tgbaalgos/projrun.hh,
src/tgbaalgos/randomgraph.hh, src/tgbaalgos/reachiter.hh,
src/tgbaalgos/reducerun.hh, src/tgbaalgos/replayrun.hh,
src/tgbaalgos/rundotdec.hh, src/tgbaalgos/save.hh,
src/tgbaalgos/stripacc.hh, src/tgbaalgos/translate.hh: Move \ingroup
before \brief.
parent 0ec3f784
...@@ -28,8 +28,8 @@ namespace spot ...@@ -28,8 +28,8 @@ namespace spot
{ {
class fair_kripke; class fair_kripke;
/// \brief Iterator code for a Fair Kripke structure.
/// \ingroup kripke /// \ingroup kripke
/// \brief Iterator code for a Fair Kripke structure.
/// ///
/// This iterator can be used to simplify the writing /// This iterator can be used to simplify the writing
/// of an iterator on a Fair Kripke structure (or lookalike). /// of an iterator on a Fair Kripke structure (or lookalike).
...@@ -62,8 +62,8 @@ namespace spot ...@@ -62,8 +62,8 @@ namespace spot
bdd acc_cond_; bdd acc_cond_;
}; };
/// \brief Interface for a Fair Kripke structure.
/// \ingroup kripke /// \ingroup kripke
/// \brief Interface for a Fair Kripke structure.
/// ///
/// A Kripke structure is a graph in which each node (=state) is /// A Kripke structure is a graph in which each node (=state) is
/// labeled by a conjunction of atomic proposition, and a set of /// labeled by a conjunction of atomic proposition, and a set of
......
...@@ -23,8 +23,8 @@ ...@@ -23,8 +23,8 @@
namespace spot namespace spot
{ {
/// \brief Iterator code for Kripke structure
/// \ingroup kripke /// \ingroup kripke
/// \brief Iterator code for Kripke structure
/// ///
/// This iterator can be used to simplify the writing /// This iterator can be used to simplify the writing
/// of an iterator on a Kripke structure (or lookalike). /// of an iterator on a Kripke structure (or lookalike).
...@@ -55,8 +55,8 @@ namespace spot ...@@ -55,8 +55,8 @@ namespace spot
bdd cond_; bdd cond_;
}; };
/// \brief Interface for a Kripke structure
/// \ingroup kripke /// \ingroup kripke
/// \brief Interface for a Kripke structure
/// ///
/// A Kripke structure is a graph in which each node (=state) is /// A Kripke structure is a graph in which each node (=state) is
/// labeled by a conjunction of atomic proposition. /// labeled by a conjunction of atomic proposition.
......
...@@ -26,6 +26,7 @@ namespace spot ...@@ -26,6 +26,7 @@ namespace spot
class kripke; class kripke;
/// \ingroup tgba_io
/// \brief Save the reachable part of Kripke structure in text format. /// \brief Save the reachable part of Kripke structure in text format.
/// ///
/// The states will be named with the value returned by the /// The states will be named with the value returned by the
...@@ -34,9 +35,9 @@ namespace spot ...@@ -34,9 +35,9 @@ namespace spot
/// function only for debugging. Use /// function only for debugging. Use
/// kripke_save_reachable_renumbered() for large output. /// kripke_save_reachable_renumbered() for large output.
/// ///
/// \ingroup tgba_io
std::ostream& kripke_save_reachable(std::ostream& os, const kripke* k); std::ostream& kripke_save_reachable(std::ostream& os, const kripke* k);
/// \ingroup tgba_io
/// \brief Save the reachable part of Kripke structure in text format. /// \brief Save the reachable part of Kripke structure in text format.
/// ///
/// States will be renumbered with sequential number. This is much /// States will be renumbered with sequential number. This is much
...@@ -44,7 +45,6 @@ namespace spot ...@@ -44,7 +45,6 @@ namespace spot
/// state names. The drawback is that any information carried by /// state names. The drawback is that any information carried by
/// the state name is lost. /// the state name is lost.
/// ///
/// \ingroup tgba_io
std::ostream& kripke_save_reachable_renumbered(std::ostream& os, std::ostream& kripke_save_reachable_renumbered(std::ostream& os,
const kripke* k); const kripke* k);
......
...@@ -36,8 +36,8 @@ namespace spot ...@@ -36,8 +36,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief Atomic propositions.
/// \ingroup ltl_ast /// \ingroup ltl_ast
/// \brief Atomic propositions.
class atomic_prop : public ref_formula class atomic_prop : public ref_formula
{ {
public: public:
......
...@@ -32,8 +32,8 @@ namespace spot ...@@ -32,8 +32,8 @@ namespace spot
{ {
namespace ltl namespace ltl
{ {
/// \brief Automaton operators.
/// \ingroup eltl_ast /// \ingroup eltl_ast
/// \brief Automaton operators.
/// ///
class automatop : public ref_formula class automatop : public ref_formula
{ {
......
...@@ -37,8 +37,8 @@ namespace spot ...@@ -37,8 +37,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief Binary operator.
/// \ingroup ltl_ast /// \ingroup ltl_ast
/// \brief Binary operator.
class binop : public ref_formula class binop : public ref_formula
{ {
public: public:
......
...@@ -31,8 +31,8 @@ namespace spot ...@@ -31,8 +31,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief Bounded unary operator.
/// \ingroup ltl_ast /// \ingroup ltl_ast
/// \brief Bounded unary operator.
class bunop : public ref_formula class bunop : public ref_formula
{ {
public: public:
......
...@@ -29,8 +29,8 @@ namespace spot ...@@ -29,8 +29,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief A constant (True or False)
/// \ingroup ltl_ast /// \ingroup ltl_ast
/// \brief A constant (True or False)
class constant : public formula class constant : public formula
{ {
public: public:
......
...@@ -62,9 +62,9 @@ namespace spot ...@@ -62,9 +62,9 @@ namespace spot
/// \ingroup ltl_algorithm /// \ingroup ltl_algorithm
/// \brief An LTL formula.
/// \ingroup ltl_essential /// \ingroup ltl_essential
/// \ingroup ltl_ast /// \ingroup ltl_ast
/// \brief An LTL formula.
/// ///
/// The only way you can work with a formula is to /// The only way you can work with a formula is to
/// build a spot::ltl::visitor or spot::ltl::const_visitor. /// build a spot::ltl::visitor or spot::ltl::const_visitor.
...@@ -353,8 +353,8 @@ namespace spot ...@@ -353,8 +353,8 @@ namespace spot
opkind kind_; opkind kind_;
}; };
/// \brief Strict Weak Ordering for <code>const formula*</code>.
/// \ingroup ltl_essentials /// \ingroup ltl_essentials
/// \brief Strict Weak Ordering for <code>const formula*</code>.
/// ///
/// This is meant to be used as a comparison functor for /// This is meant to be used as a comparison functor for
/// STL \c map whose key are of type <code>const formula*</code>. /// STL \c map whose key are of type <code>const formula*</code>.
...@@ -394,9 +394,9 @@ namespace spot ...@@ -394,9 +394,9 @@ namespace spot
} }
}; };
/// \brief Hash Function for <code>const formula*</code>.
/// \ingroup ltl_essentials /// \ingroup ltl_essentials
/// \ingroup hash_funcs /// \ingroup hash_funcs
/// \brief Hash Function for <code>const formula*</code>.
/// ///
/// This is meant to be used as a hash functor for /// This is meant to be used as a hash functor for
/// Sgi's \c hash_map whose key are of type <code>const formula*</code>. /// Sgi's \c hash_map whose key are of type <code>const formula*</code>.
......
...@@ -34,8 +34,8 @@ namespace spot ...@@ -34,8 +34,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief Multi-operand operators.
/// \ingroup ltl_ast /// \ingroup ltl_ast
/// \brief Multi-operand operators.
class multop : public ref_formula class multop : public ref_formula
{ {
public: public:
......
...@@ -32,8 +32,8 @@ namespace spot ...@@ -32,8 +32,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief A reference-counted LTL formula.
/// \ingroup ltl_ast /// \ingroup ltl_ast
/// \brief A reference-counted LTL formula.
class ref_formula : public formula class ref_formula : public formula
{ {
protected: protected:
......
...@@ -34,8 +34,8 @@ namespace spot ...@@ -34,8 +34,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief Unary operators.
/// \ingroup ltl_ast /// \ingroup ltl_ast
/// \brief Unary operators.
class unop : public ref_formula class unop : public ref_formula
{ {
public: public:
......
...@@ -30,8 +30,8 @@ namespace spot ...@@ -30,8 +30,8 @@ namespace spot
{ {
namespace ltl namespace ltl
{ {
/// \brief Formula visitor
/// \ingroup ltl_essential /// \ingroup ltl_essential
/// \brief Formula visitor
/// ///
/// Implementing visitors is the prefered way /// Implementing visitors is the prefered way
/// to traverse a formula, since it does not /// to traverse a formula, since it does not
......
...@@ -33,8 +33,8 @@ namespace spot ...@@ -33,8 +33,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief A declarative environment.
/// \ingroup ltl_environment /// \ingroup ltl_environment
/// \brief A declarative environment.
/// ///
/// This environment recognizes all atomic propositions /// This environment recognizes all atomic propositions
/// that have been previously declared. It will reject other. /// that have been previously declared. It will reject other.
......
...@@ -30,8 +30,8 @@ namespace spot ...@@ -30,8 +30,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief A laxist environment.
/// \ingroup ltl_environment /// \ingroup ltl_environment
/// \brief A laxist environment.
/// ///
/// This environment recognizes all atomic propositions. /// This environment recognizes all atomic propositions.
/// ///
......
...@@ -29,8 +29,8 @@ namespace spot ...@@ -29,8 +29,8 @@ namespace spot
{ {
namespace ltl namespace ltl
{ {
/// \brief An environment that describes atomic propositions.
/// \ingroup ltl_essential /// \ingroup ltl_essential
/// \brief An environment that describes atomic propositions.
class environment class environment
{ {
public: public:
......
...@@ -27,8 +27,8 @@ namespace spot ...@@ -27,8 +27,8 @@ namespace spot
namespace ltl namespace ltl
{ {
/// \brief Read LTL formulae from a file, one by one
/// \ingroup ltl_io /// \ingroup ltl_io
/// \brief Read LTL formulae from a file, one by one
class ltl_file class ltl_file
{ {
public: public:
......
...@@ -30,8 +30,8 @@ namespace spot ...@@ -30,8 +30,8 @@ namespace spot
{ {
namespace ltl namespace ltl
{ {
/// \brief Clone a formula.
/// \ingroup ltl_visitor /// \ingroup ltl_visitor
/// \brief Clone a formula.
/// ///
/// This visitor is public, because it's convenient /// This visitor is public, because it's convenient
/// to derive from it and override part of its methods. /// to derive from it and override part of its methods.
...@@ -60,13 +60,13 @@ namespace spot ...@@ -60,13 +60,13 @@ namespace spot
}; };
#if __GNUC__ #if __GNUC__
/// \brief Clone a formula.
/// \ingroup ltl_essential /// \ingroup ltl_essential
/// \brief Clone a formula.
/// \deprecated Use f->clone() instead. /// \deprecated Use f->clone() instead.
const formula* clone(const formula* f) __attribute__ ((deprecated)); const formula* clone(const formula* f) __attribute__ ((deprecated));
#else #else
/// \brief Clone a formula.
/// \ingroup ltl_essential /// \ingroup ltl_essential
/// \brief Clone a formula.
/// \deprecated Use f->clone() instead. /// \deprecated Use f->clone() instead.
const formula* clone(const formula* f); const formula* clone(const formula* f);
#endif #endif
......
...@@ -29,13 +29,13 @@ namespace spot ...@@ -29,13 +29,13 @@ namespace spot
namespace ltl namespace ltl
{ {
#if __GNUC__ #if __GNUC__
/// \brief Destroys a formula
/// \ingroup ltl_essential /// \ingroup ltl_essential
/// \brief Destroys a formula
/// \deprecated Use f->destroy() instead. /// \deprecated Use f->destroy() instead.
void destroy(const formula *f) __attribute__ ((deprecated)); void destroy(const formula *f) __attribute__ ((deprecated));
#else #else
/// \brief Destroys a formula
/// \ingroup ltl_essential /// \ingroup ltl_essential
/// \brief Destroys a formula
/// \deprecated Use f->destroy() instead. /// \deprecated Use f->destroy() instead.
void destroy(const formula *f); void destroy(const formula *f);
#endif #endif
......
...@@ -27,8 +27,8 @@ namespace spot ...@@ -27,8 +27,8 @@ namespace spot
{ {
namespace ltl namespace ltl
{ {
/// \brief Write a formula tree using dot's syntax.
/// \ingroup ltl_io /// \ingroup ltl_io
/// \brief Write a formula tree using dot's syntax.
/// \param os The stream where it should be output. /// \param os The stream where it should be output.
/// \param f The formula to translate. /// \param f The formula to translate.
/// ///
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment