From eaa5621b36472f1f9f80ef1d09b0e120a7761961 Mon Sep 17 00:00:00 2001
From: Henrik Lissner <henrik@lissner.net>
Date: Sun, 15 Dec 2019 23:51:59 -0500
Subject: [PATCH] Update comments

---
 core/core.el                     | 4 +++-
 modules/completion/ivy/config.el | 3 ++-
 modules/tools/lookup/packages.el | 6 +++---
 3 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/core/core.el b/core/core.el
index b66bf2581..20babb950 100644
--- a/core/core.el
+++ b/core/core.el
@@ -481,7 +481,9 @@ to least)."
                   load-path doom--initial-load-path
                   process-environment doom--initial-process-environment)
 
-    ;; Load shell environment, optionally generated from 'doom env'
+    ;; Load shell environment, optionally generated from 'doom env'. No need to
+    ;; do so if we're in terminal Emacs, because Emacs will correctly inherit
+    ;; your shell environment there.
     (when (and (or (display-graphic-p)
                    (daemonp))
                (file-exists-p doom-env-file))
diff --git a/modules/completion/ivy/config.el b/modules/completion/ivy/config.el
index 9826545b2..1d2777d0e 100644
--- a/modules/completion/ivy/config.el
+++ b/modules/completion/ivy/config.el
@@ -235,7 +235,8 @@ evil-ex-specific constructs, so we disable it solely in evil-ex."
     ;; Persist `counsel-compile' history
     (add-to-list 'savehist-additional-variables 'counsel-compile-history))
 
-  ;; Use spotlight on mac for `counsel-locate' by default
+  ;; Use spotlight on mac for `counsel-locate' by default, since it doesn't need
+  ;; any additional setup.
   (when IS-MAC
     (setq counsel-locate-cmd #'counsel-locate-cmd-mdfind))
 
diff --git a/modules/tools/lookup/packages.el b/modules/tools/lookup/packages.el
index fdc7a1416..6c0b50565 100644
--- a/modules/tools/lookup/packages.el
+++ b/modules/tools/lookup/packages.el
@@ -1,9 +1,9 @@
 ;; -*- no-byte-compile: t; -*-
 ;;; tools/lookup/packages.el
 
-;; `dumb-jump' uses the `helm-build-sync-source' macro, but this requires helm
-;; be loaded before `dumb-jump' is byte-compiled during installation. To ensure
-;; this, we declare helm before dumb-jump.
+;; HACK `dumb-jump' uses the `helm-build-sync-source' macro, but this requires
+;;      helm be loaded before `dumb-jump' is byte-compiled during installation.
+;;      To ensure this, we declare helm before dumb-jump.
 (when (featurep! :completion helm)
   (package! helm))