Use man-db instead of default macos man program

emacs/.emacs.d/config/init-defaults.el

@@ -19,7 +19,8 @@
         display-buffer-alist '((".*"
                                 (display-buffer-reuse-window display-buffer-same-window)
                                 (reusable-frames . t)))
-        even-window-sizes nil)
+        even-window-sizes nil
+        manual-program "gman")
   (setq-default indent-tabs-mode nil)
 
   ;; Always display line numbers in text/programming modes

homebrew/Brewfile

@@ -18,6 +18,7 @@ brew "jdtls"
 brew "jq"
 brew "kubectx"
 brew "llvm"
+brew "man-db"
 brew "maven"
 brew "metals"
 brew "msmtp"

launchd/Library/LaunchAgents/mandb.plist

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Applice//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>Label</key>
+    <string>local.jdormit.mandb</string>
+    <key>ProgramArguments</key>
+    <array>
+      <string>/opt/homebrew/bin/mandb</string>
+    </array>
+    <key>StartInterval</key>
+    <integer>300</integer>
+  </dict>
+</plist>

zsh/.zshrc

@@ -115,6 +115,10 @@ alias kns="kubens"
 alias kctx="kubectx"
 alias tf="terraform"
 
+if type gman &>/dev/null; then
+    alias man="gman"
+fi
+
 # zsh-completions homebrew package
 if type brew &>/dev/null; then
     FPATH=$(brew --prefix)/share/zsh-completions:$FPATH