slot, signal: Fix the Doxygen documentation

kjellahl · kjellahl · commit bcf206539049 · 2018-09-10T15:52:29.000+02:00
Hide the forward declarations of sigc::slot and sigc::signal from Doxygen.
If Doxygen sees the forward declarations, it does not care about what's
in the complete class definitions.
diff --git a/sigc++/functors/slot.h b/sigc++/functors/slot.h
@@ -190,8 +190,10 @@ struct slot_call
  *
  * @ingroup slot
  */
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
 template <typename T_return, typename... T_arg>
 class slot;
+#endif // DOXYGEN_SHOULD_SKIP_THIS
 
 template <typename T_return, typename... T_arg>
 class slot<T_return(T_arg...)> : public slot_base
diff --git a/sigc++/signal.h b/sigc++/signal.h
@@ -529,8 +529,10 @@ class signal_with_accumulator : public signal_base
  *
  * @ingroup signal
  */
+#ifndef DOXYGEN_SHOULD_SKIP_THIS
 template <typename T_return, typename... T_arg>
 class signal;
+#endif // DOXYGEN_SHOULD_SKIP_THIS
 
 template <typename T_return, typename... T_arg>
 class signal<T_return(T_arg...)> : public signal_with_accumulator<T_return, void, T_arg...>
