         ;;              to fetch a modeline config. Set in `doom-popup-mode'.
         ;;  :autokill   If non-nil, the buffer in these popups will be killed
         ;;              when their popup is closed. Used by
-        ;;              `doom*delete-popup-window'
+        ;;              `doom*delete-popup-window'. NOTE This will render
+        ;;              `doom/popup-restore' unusable for this buffer.
         ;;  :autoclose  If non-nil, close popup if ESC is pressed from any buffer.
-        ;;  :noclone    If non-nil, don't try to clone the buffer. This helps with
-        ;;              buffers with buttons/links that, when followed, should
-        ;;              open within the popup, rather than outside of it. Like
-        ;;              help buffers or eshell-term buffers.
         shackle-rules
         '(("^ ?\\*doom:.+\\*$"      :size 25  :modeline minimal :regexp t :noesc t)
           ("^ ?\\*doom .+\\*$"      :size 10  :noselect t :regexp t)

          ("*Apropos*"              :size 0.3)
          ("*Backtrace*"            :size 25  :noselect t)
          ("*Buffer List*"          :size 20  :autokill t)
          ("*Help*"                 :size 16  :noclone t)
          ("*Messages*"             :size 10  :noselect t)
          ("*Warnings*"             :size 10  :noselect t :autokill t)
          ("*command-log*"          :size 28  :noselect t :align right)

                          (shackle-match (window-buffer (car args))))
                         ((bufferp (car args))
                          (shackle-match (car args))))))
        (buffer (get-buffer (car args)))
        window)
    (when (and (doom-real-buffer-p buffer)
               (get-buffer-window-list buffer nil t))
      (setq plist (append (list :autokill t) plist))
      (setcar args (clone-indirect-buffer (buffer-name (car args)) nil t)))
    (unless (setq window (apply orig-fn args))
