General refactor, cleanup & commenting

modules/completion/ivy/autoload/ivy.el

@@ -86,8 +86,11 @@ limit to buffers in the current workspace."
 ;;;###autoload
 (defun +ivy*counsel-ag-function (string base-cmd extra-ag-args)
   "Advice to 1) get rid of the character limit from `counsel-ag-function' and 2)
-disable ivy's over-zealous parentheses quoting behavior, both of which
-interferes with my custom :[ar]g ex command `+ivy:file-search'."
+disable ivy's over-zealous parentheses quoting behavior (if i want literal
+parentheses, I'll escape them myself).
+
+NOTE This may need to be updated frequently, to meet changes upstream (in
+counsel-rg)."
   (when (null extra-ag-args)
     (setq extra-ag-args ""))
   (if (< (length string) 1)  ;; #1

modules/completion/ivy/config.el

@@ -57,7 +57,10 @@ session)."
         [remap projectile-switch-project] #'counsel-projectile-switch-project
         [remap projectile-find-file]      #'counsel-projectile-find-file
         [remap imenu-anywhere]            #'ivy-imenu-anywhere
-        [remap execute-extended-command]  #'counsel-M-x)
+        [remap execute-extended-command]  #'counsel-M-x
+        [remap describe-function]         #'counsel-describe-function
+        [remap describe-variable]         #'counsel-describe-variable
+        [remap describe-face]             #'counsel-describe-face)
 
   (when (featurep! :feature workspaces)
     (nconc ivy-sort-functions-alist