docs: add module prefix (#1847)

lua/telescope/actions/generate.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.actions.generate
+---@config { ["module"] = "telescope.actions.generate" }
 
 ---@brief [[
 --- Module for convenience to override defaults of corresponding |telescope.actions| at |telescope.setup()|.

lua/telescope/actions/history.lua

@@ -4,6 +4,9 @@ local utils = require "telescope.utils"
 
 local uv = vim.loop
 
+---@tag telescope.actions.history
+---@config { ["module"] = "telescope.actions.history" }
+
 ---@brief [[
 --- A base implementation of a prompt history that provides a simple history
 --- and can be replaced with a custom implementation.
@@ -22,7 +25,6 @@ local uv = vim.loop
 ---
 --- See github.com/nvim-telescope/telescope-smart-history.nvim
 ---@brief ]]
----@tag telescope.actions.history
 
 -- TODO(conni2461): currently not present in plenary path only sync.
 -- But sync is just unnecessary here

lua/telescope/actions/init.lua

@@ -1,7 +1,5 @@
 ---@tag telescope.actions
-
+---@config { ["module"] = "telescope.actions" }
--- TODO: Add @module to make it so we can have the prefix.
---@module telescope.actions
 
 ---@brief [[
 --- Actions functions that are useful for people creating their own mappings.
@@ -12,41 +10,39 @@
 --- (1) The `prompt_bufnr` of a normal function denotes the identifier of your
 --- picker which can be used to access the picker state. In practice, users
 --- most commonly access from both picker and global state via the following:
----
 --- <code>
---- -- for utility functions
+---   -- for utility functions
---- local action_state = require "telescope.actions.state"
+---   local action_state = require "telescope.actions.state"
 ---
---- local actions = {}
+---   local actions = {}
---- actions.do_stuff = function(prompt_bufnr)
+---   actions.do_stuff = function(prompt_bufnr)
----   local current_picker = action_state.get_current_picker(prompt_bufnr) -- picker state
+---     local current_picker = action_state.get_current_picker(prompt_bufnr) -- picker state
----   local entry = action_state.get_selected_entry()
+---     local entry = action_state.get_selected_entry()
---- end
+---   end
 --- </code>
 ---
 --- See |telescope.actions.state| for more information.
 ---
 --- (2) To transform a module of functions into a module of "action"s, you need
 --- to do the following:
----
 --- <code>
---- local transform_mod = require("telescope.actions.mt").transform_mod
+---   local transform_mod = require("telescope.actions.mt").transform_mod
 ---
---- local mod = {}
+---   local mod = {}
---- mod.a1 = function(prompt_bufnr)
+---   mod.a1 = function(prompt_bufnr)
----   -- your code goes here
+---     -- your code goes here
----   -- You can access the picker/global state as described above in (1).
+---     -- You can access the picker/global state as described above in (1).
---- end
+---   end
 ---
---- mod.a2 = function(prompt_bufnr)
+---   mod.a2 = function(prompt_bufnr)
----   -- your code goes here
+---     -- your code goes here
---- end
+---   end
---- mod = transform_mod(mod)
+---   mod = transform_mod(mod)
 ---
---- -- Now the following is possible. This means that actions a2 will be executed
+---   -- Now the following is possible. This means that actions a2 will be executed
---- -- after action a1. You can chain as many actions as you want.
+---   -- after action a1. You can chain as many actions as you want.
---- local action = mod.a1 + mod.a2
+---   local action = mod.a1 + mod.a2
---- action(bufnr)
+---   action(bufnr)
 --- </code>
 ---
 --- Another interesing thing to do is that these actions now have functions you

lua/telescope/actions/layout.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.actions.layout
+---@config { ["module"] = "telescope.actions.layout" }
 
 ---@brief [[
 --- The layout actions are actions to be used to change the layout of a picker.

lua/telescope/actions/set.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.actions.set
+---@config { ["module"] = "telescope.actions.set" }
 
 ---@brief [[
 --- Telescope action sets are used to provide an interface for managing

lua/telescope/actions/state.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.actions.state
+---@config { ["module"] = "telescope.actions.state" }
 
 ---@brief [[
 --- Functions to be used to determine the current state of telescope.

lua/telescope/actions/utils.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.actions.utils
+---@config { ["module"] = "telescope.actions.utils" }
 
 ---@brief [[
 --- Utilities to wrap functions around picker selections and entries.

lua/telescope/builtin/init.lua

@@ -1,6 +1,6 @@
 ---@tag telescope.builtin
 
----@config { ['field_heading'] = "Options" }
+---@config { ['field_heading'] = "Options", ["module"] = "telescope.builtin" }
 
 ---@brief [[
 --- Telescope Builtins is a collection of community maintained pickers to support common workflows. It can be used as

lua/telescope/command.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.command
+---@config { ["module"] = "telescope.command" }
 
 ---@brief [[
 ---

lua/telescope/config/resolve.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.resolve
+---@config { ["module"] = "telescope.resolve" }
 
 ---@brief [[
 --- Provides "resolver functions" to allow more customisable inputs for options.

lua/telescope/pickers/layout_strategies.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.layout
+---@config { ["module"] = "telescope.layout" }
 
 ---@brief [[
 --- The layout of telescope pickers can be adjusted using the

lua/telescope/previewers/init.lua

@@ -1,4 +1,5 @@
 ---@tag telescope.previewers
+---@config { ["module"] = "telescope.previewers" }
 
 ---@brief [[
 --- Provides a Previewer table that has to be implemented by each previewer.

lua/telescope/themes.lua

@@ -4,6 +4,7 @@
 -- local opts = themes.get_dropdown { winblend = 3 }
 
 ---@tag telescope.themes
+---@config { ["module"] = "telescope.themes" }
 
 ---@brief [[
 --- Themes are ways to combine several elements of styling together.