doc: Update docstrings for plugins' base classes

And some final docs fixups.

dnf5/include/dnf5/iplugin.hpp

@@ -34,6 +34,7 @@ struct PluginVersion {
     std::uint16_t micro;
 };
 
+/// @brief A base class for implementing DNF5 plugins that provide one or more commands to users.
 class IPlugin {
 public:
     IPlugin(Context & context) : context(&context) {}
@@ -65,10 +66,6 @@ class IPlugin {
 
     virtual std::vector<std::unique_ptr<Command>> create_commands() = 0;
 
-    /// It is called when a hook is reached. The argument describes what happened.
-    // TODO(jrohel): Design an API for a different plugin type than command. For example, to modify or log output.
-    //virtual bool hook(HookId hook_id) = 0;
-
     /// Finish the plugin and release all resources obtained by the init method and in hooks.
     virtual void finish() noexcept = 0;
 

dnf5/plugins.cpp

@@ -158,17 +158,6 @@ bool Plugins::init() {
     return true;
 }
 
-/*bool Plugins::hook(HookId id) {
-    for (auto & plugin : plugins) {
-        if (plugin->get_enabled()) {
-            if (!plugin->hook(id)) {
-                return false;
-            }
-        }
-    }
-    return true;
-}*/
-
 void Plugins::finish() noexcept {
     for (auto plugin = plugins.rbegin(), stop = plugins.rend(); plugin != stop; ++plugin) {
         if ((*plugin)->get_enabled()) {

doc/libdnf5_plugins/actions.8.rst

@@ -18,9 +18,9 @@
 
 .. _actions_plugin_ref-label:
 
-======================
-libdnf5 Actions Plugin
-======================
+==============
+Actions Plugin
+==============
 
 Description
 ===========

include/libdnf5/plugin/iplugin.hpp

@@ -44,6 +44,7 @@ struct Version {
     std::uint16_t micro;
 };
 
+/// @brief A base class for implementing LIBDNF5 plugins that introduce additional logic into the library using hooks.
 class IPlugin {
 public:
     IPlugin(Base & base) : base(&base) {}