From ae76d9fdf2148d07d9043462f4de14640ba1778a Mon Sep 17 00:00:00 2001 From: Marc Fehling Date: Tue, 22 Mar 2022 12:49:08 -0600 Subject: [PATCH] cell_weight: added documentation for LegacySignal. --- include/deal.II/grid/tria.h | 40 ++++++++++++++++++++++++++++++++++--- 1 file changed, 37 insertions(+), 3 deletions(-) diff --git a/include/deal.II/grid/tria.h b/include/deal.II/grid/tria.h index ded1714a33..822204f343 100644 --- a/include/deal.II/grid/tria.h +++ b/include/deal.II/grid/tria.h @@ -2211,9 +2211,10 @@ public: CellWeightSum> weight; -#ifndef DOXYGEN /** - * Legacy constructor that connects deprecated signals to their new ones. + * Constructor. + * + * Connects a deprecated signal to its successor. */ Signals() : cell_weight(weight) @@ -2233,16 +2234,28 @@ public: using slot_type = boost::signals2::slot; + /** + * Constructor. + */ LegacySignal( boost::signals2::signal &new_signal) : new_signal(new_signal) {} + /** + * Destructor. + */ ~LegacySignal() { base_weight.disconnect(); } + /** + * Connects a function to the signal. + * + * Connects an additional base weight function if signal was previously + * empty. + */ DEAL_II_DEPRECATED_EARLY boost::signals2::connection connect( @@ -2262,6 +2275,10 @@ public: return new_signal.connect(slot, position); } + /** + * Returns the number of connected functions without the base + * weight. + */ DEAL_II_DEPRECATED_EARLY std::size_t num_slots() const @@ -2270,6 +2287,9 @@ public: static_cast(base_weight.connected()); } + /** + * Checks if there are any connected functions to the signal. + */ DEAL_II_DEPRECATED_EARLY bool empty() const @@ -2282,6 +2302,12 @@ public: return false; } + /** + * Disconnects a function from the signal. + * + * Also disconnects the base weight function if it is the last connected + * function. + */ template DEAL_II_DEPRECATED_EARLY void disconnect(const S &connection) @@ -2296,6 +2322,9 @@ public: } } + /** + * Triggers the signal. + */ DEAL_II_DEPRECATED_EARLY unsigned int operator()(const cell_iterator &iterator, const CellStatus status) @@ -2304,11 +2333,16 @@ public: } private: + /** + * Monitors the connection of the base weight function. + */ boost::signals2::connection base_weight; + /** + * Reference to the successor signal. + */ boost::signals2::signal &new_signal; }; -#endif /** * @copydoc weight -- 2.39.5