Merge branch 'dev' into mercury

nvim: add descriptions to keymaps
        remap Telescope functionalities
        add telescope.help_tags() map
        fix colorscheme-switching keymap

.config/nvim/lua/maps.lua

@@ -3,35 +3,78 @@
 -- License       : GPLv3
 -- Description   : neovim mappings file
 
-vim.keymap.set({ "n", "v" }, "<space>", "<Nop>", { silent = true })
+vim.keymap.set({ "n", "v" }, "<space>",
+    "<Nop>",
+    {
+        silent = true,
+        desc = "leader key"
+    })
 vim.g.mapleader = " "
 
 -- Dealing with word wrap
-vim.keymap.set("n", "k", "v:count == 0 ? 'gk' : 'k'",
-    { expr = true, silent = true })
-vim.keymap.set("n", "j", "v:count == 0 ? 'gj' : 'j'",
-    { expr = true, silent = true })
+vim.keymap.set("n", "k",
+    "v:count == 0 ? 'gk' : 'k'",
+    {
+        expr = true,
+        silent = true,
+        desc = "Smart up motion"
+    })
+vim.keymap.set("n", "j",
+    "v:count == 0 ? 'gj' : 'j'",
+    {
+        expr = true,
+        silent = true,
+        desc = "Smart down motion"
+    })
 
-vim.keymap.set("n", "<leader>y", "\"+y")
-vim.keymap.set("n", "<leader>p", "\"+P")
-vim.keymap.set("n", "<leader><enter>", "<cmd>w! | !compiler %<CR>")
-vim.keymap.set("n", "<leader>u", function() require("packer").sync() end)
+vim.keymap.set("n", "<leader>y",
+    "\"+y",
+    { desc = "Yank to clipboard"}
+)
+vim.keymap.set("n", "<leader>p",
+    "\"+P",
+    { desc = "Copy from clipboard"}
+)
+vim.keymap.set("n", "<leader><enter>",
+    "<cmd>w! | !compiler %<CR>",
+    { desc = "Compile current file using ~/.local/bin/compiler"}
+)
+vim.keymap.set("n", "<leader>u",
+    function() require("packer").sync() end,
+    { desc = "Sync packer config and update plugins"}
+)
 
 -- telescope
 vim.keymap.set("n", "<leader>tf",
-    function() require("telescope.builtin").find_files() end)
-vim.keymap.set("n", "<leader>tef",
-    function() require("telescope").extensions.file_browser.file_browser() end)
+    function() require("telescope.builtin").find_files() end,
+    { desc = "Fuzzy find files" }
+)
 vim.keymap.set("n", "<leader>tb",
-    function() require("telescope.builtin").buffers() end)
+    function() require("telescope").extensions.file_browser.file_browser() end,
+    { desc = "Open file browser" }
+)
+vim.keymap.set("n", "<leader>t/",
+    function() require("telescope.builtin").buffers() end,
+    { desc = "Grep through buffers" }
+)
 vim.keymap.set("n", "<leader>tg",
-    function() require("telescope.builtin").grep_string() end)
+    function() require("telescope.builtin").grep_string() end,
+    { desc = "Grep current word" }
+)
+vim.keymap.set("n", "<leader>th",
+    function() require("telescope.builtin").help_tags() end,
+    { desc = "Search through help" }
+)
 vim.keymap.set("n", "<leader>tl",
-    function() require("telescope.builtin").live_grep() end)
+    function() require("telescope.builtin").live_grep() end,
+    { desc = "Grep interactively" }
+)
 
 -- colorscheme
-vim.keymap.set("n", "<C-s>",
-    function() require("astronomy").toggle_variant() end)
+vim.keymap.set("n", "<leader>s",
+    function() require("astronomy").toggle_variant() end,
+    { desc = "Switch between dark and light colorscheme" }
+)
 
 -- snippets
 vim.keymap.set({ "i", "s" }, "<C-E>", "<Plug>luasnip-next-choice")