docs(builtin.tags): add show_kind option (#3304)

* docs(builtin.tags): add `show_kind` option

* [docgen] Update doc/telescope.txt
skip-checks: true

---------

Co-authored-by: Github Actions <actions@github>

Author: jamestrew

doc/telescope.txt

@@ -1012,6 +1012,8 @@ builtin.tags({opts})                                *telescope.builtin.tags()*
         {show_line}      (boolean)  if true, shows the content of the line the
                                     tag is found on in the picker (default:
                                     true)
+        {show_kind}      (boolean)  if true and kind info is available, show
+                                    the kind of the tag (default: true)
         {only_sort_tags} (boolean)  if true we will only sort tags (default:
                                     false)
         {fname_width}    (number)   defines the width of the filename section
@@ -1033,6 +1035,8 @@ builtin.current_buffer_tags({opts})  *telescope.builtin.current_buffer_tags()*
         {show_line}      (boolean)  if true, shows the content of the line the
                                     tag is found on in the picker (default:
                                     true)
+        {show_kind}      (boolean)  if true and kind info is available, show
+                                    the kind of the tag (default: true)
         {only_sort_tags} (boolean)  if true we will only sort tags (default:
                                     false)
         {fname_width}    (number)   defines the width of the filename section

lua/telescope/builtin/init.lua

@@ -114,6 +114,7 @@ builtin.current_buffer_fuzzy_find = require_on_exported_call("telescope.builtin.
 ---@field cwd string: root dir to search from (default: cwd, use utils.buffer_dir() to search relative to open buffer)
 ---@field ctags_file string: specify a particular ctags file to use
 ---@field show_line boolean: if true, shows the content of the line the tag is found on in the picker (default: true)
+---@field show_kind boolean: if true and kind info is available, show the kind of the tag (default: true)
 ---@field only_sort_tags boolean: if true we will only sort tags (default: false)
 ---@field fname_width number: defines the width of the filename section (default: 30)
 builtin.tags = require_on_exported_call("telescope.builtin.__files").tags
@@ -123,6 +124,7 @@ builtin.tags = require_on_exported_call("telescope.builtin.__files").tags
 ---@field cwd string: root dir to search from (default: cwd, use utils.buffer_dir() to search relative to open buffer)
 ---@field ctags_file string: specify a particular ctags file to use
 ---@field show_line boolean: if true, shows the content of the line the tag is found on in the picker (default: true)
+---@field show_kind boolean: if true and kind info is available, show the kind of the tag (default: true)
 ---@field only_sort_tags boolean: if true we will only sort tags (default: false)
 ---@field fname_width number: defines the width of the filename section (default: 30)
 builtin.current_buffer_tags = require_on_exported_call("telescope.builtin.__files").current_buffer_tags