Update comments

This commit is contained in:
James Cherti
2025-03-11 14:49:50 -04:00
parent c8424cb94c
commit 70d5507ed1
2 changed files with 65 additions and 72 deletions

38
init.el
View File

@@ -178,8 +178,7 @@
(setq auto-save-no-message t)
;; Do not auto-disable auto-save after deleting large chunks of
;; text. The purpose of auto-save is to provide a failsafe, and
;; disabling it contradicts this objective.
;; text.
(setq auto-save-include-big-deletions t)
(setq auto-save-list-file-prefix
@@ -206,8 +205,7 @@
;;; recentf
;; `recentf' is an that maintains a list of recently accessed files, making it
;; easier to reopen files you have worked on recently.
;; `recentf' is an that maintains a list of recently accessed files.
(setq recentf-max-saved-items 300) ; default is 20
(setq recentf-max-menu-items 15)
(setq recentf-auto-cleanup (if (daemonp) 300 'never))
@@ -217,8 +215,7 @@
;;; saveplace
;; `save-place-mode' enables Emacs to remember the last location within a file
;; upon reopening.
;; Enables Emacs to remember the last location within a file upon reopening.
(setq save-place-file (expand-file-name "saveplace" user-emacs-directory))
(setq save-place-limit 600)
@@ -254,25 +251,20 @@
;;; Scrolling
;; Enables faster scrolling through unfontified regions. This may result in
;; brief periods of inaccurate syntax highlighting immediately after scrolling,
;; which should quickly self-correct.
;; Enables faster scrolling. This may result in brief periods of inaccurate
;; syntax highlighting, which should quickly self-correct.
(setq fast-but-imprecise-scrolling t)
;; Move point to top/bottom of buffer before signaling a scrolling error.
(setq scroll-error-top-bottom t)
;; Keeps screen position if the scroll command moved it vertically out of the
;; window.
;; Keep screen position if scroll command moved it vertically out of the window.
(setq scroll-preserve-screen-position t)
;; Emacs spends excessive time recentering when the cursor moves more than N
;; lines past the window edges (N is the value of `scroll-conservatively'). This
;; can be slow in larger files. If `scroll-conservatively' is set above 100, the
;; window is never automatically recentered.
;; If `scroll-conservatively' is set above 100, the window is never
;; automatically recentered, which decreases the time spend recentering.
(setq scroll-conservatively 101)
;; Reduce cursor lag by:
;; 1. Preventing automatic adjustments to `window-vscroll' for long lines.
;; 2. Resolving the issue of random half-screen jumps during scrolling.
(setq auto-window-vscroll nil)
@@ -319,9 +311,8 @@
;; Avoid automatic frame resizing when adjusting settings.
(setq global-text-scale-adjust-resizes-frames nil)
;; This controls how long Emacs will blink to show the deleted pairs with
;; `delete-pair'. A longer delay can be annoying as it causes a noticeable pause
;; after each deletion, disrupting the flow of editing.
;; A longer delay can be annoying as it causes a noticeable pause after each
;; deletion, disrupting the flow of editing.
(setq delete-pair-blink-delay 0.03)
(setq-default left-fringe-width 8)
@@ -427,9 +418,8 @@
(setq apropos-do-all t)
;; Fixes #11: Prevents help command completion from triggering autoload.
;; (e.g., apropos-command, apropos-variable, apropos...)
;; Loading additional files for completion can slow down help commands
;; and may unintentionally execute initialization code from some libraries.
;; Loading additional files for completion can slow down help commands and may
;; unintentionally execute initialization code from some libraries.
(setq help-enable-completion-autoload nil)
(setq help-enable-autoload nil)
(setq help-enable-symbol-autoload nil)
@@ -449,9 +439,7 @@
(setq eglot-report-progress nil) ; Prevent Eglot minibuffer spam
;; Eglot optimization: Disable `eglot-events-buffer' to maintain consistent
;; performance in long-running Emacs sessions. By default, it retains 2,000,000
;; lines, and each new event triggers pretty-printing of the entire buffer,
;; leading to a gradual performance decline.
;; performance in long-running Emacs sessions.
(setq eglot-events-buffer-config '(:size 0 :format full))
;;; Flymake