feat: generate plugins help pages tags on install/update

Adds a new configuration option `generate_help_pages` which defaults to `true`.

lua/rocks/config/check.lua

@@ -37,6 +37,7 @@ function check.validate(cfg)
         luarocks_binary = { cfg.luarocks_binary, "string" },
         lazy = { cfg.lazy, "boolean" },
         dynamic_rtp = { cfg.dynamic_rtp, "boolean" },
+        generate_help_pages = { cfg.generate_help_pages, "boolean" },
     })
     if not ok then
         return false, err

lua/rocks/config/internal.lua

@@ -36,6 +36,8 @@ local default_config = {
     lazy = false,
     ---@type boolean Whether to automatically add freshly installed plugins to the 'runtimepath'
     dynamic_rtp = true,
+    ---@type boolean Whether to re-generate plugins help pages after installation/upgrade
+    generate_help_pages = true,
     ---@class RocksConfigDebugInfo
     debug_info = {
         ---@type boolean

lua/rocks/operations.lua

@@ -125,6 +125,11 @@ operations.install = function(rock_spec, progress_handle)
                 runtime.packadd(name)
             end
 
+            -- Re-generate help tags
+            if config.generate_help_pages then
+                vim.cmd("heltags ALL")
+            end
+
             future.set(installed_rock)
         end
     end)
@@ -438,6 +443,11 @@ operations.sync = function(user_rocks)
             progress_handle:finish()
         end
         cache.populate_removable_rock_cache()
+
+        -- Re-generate help tags
+        if config.generate_help_pages then
+            vim.cmd("heltags ALL")
+        end
     end)
 end
 
@@ -529,6 +539,11 @@ operations.update = function()
             progress_handle:finish()
         end
         cache.populate_removable_rock_cache()
+
+        -- Re-generate help tags
+        if config.generate_help_pages then
+            vim.cmd("heltags ALL")
+        end
     end)
 end