From 238f41e79f1fe20f15a4c4cac5bdfac7f0659fb4 Mon Sep 17 00:00:00 2001 From: James Cherti <60946298+jamescherti@users.noreply.github.com> Date: Sun, 7 Sep 2025 15:16:00 -0400 Subject: [PATCH] Update README.md --- README.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 0ba15e7..ea791e9 100644 --- a/README.md +++ b/README.md @@ -1811,15 +1811,15 @@ And [add the Elpaca bootstrap code](https://github.com/progfolio/elpaca?tab=read ### Customizing Scroll Recentering -By default, minimal-emacs.d sets `scroll-conservatively` to `101`: +By default, minimal-emacs.d sets `scroll-conservatively` to `20`: ```emacs-lisp -(setq scroll-conservatively 101) ; Default minimal-emacs.d value +(setq scroll-conservatively 20) ; Default minimal-emacs.d value ``` -A value of `101` minimizes screen movement and maintains point visibility with minimal adjustment, which many users find optimal for rapid navigation. +This makes Emacs recenters the window when the cursor moves past `scroll-conservatively` lines beyond the window edge. -You can override this in your `post-init.el` file. Setting it to `0` forces Emacs to recenter the point aggressively, typically positioning it in the middle of the window: +You can override this in your `post-init.el` file. Setting it to `0` forces Emacs to recenter the point aggressively, typically positioning it in the middle of the window (NOT RECOMMENDED): ```emacs-lisp (setq scroll-conservatively 0) ; NOT RECOMMENDED. SET IT TO 101 INSTEAD. @@ -1827,14 +1827,12 @@ You can override this in your `post-init.el` file. Setting it to `0` forces Emac Although this offers more surrounding context, it results in frequent and pronounced screen movement, which can disrupt navigation. A value of `0` is generally discouraged unless this behavior is explicitly desired. -Most users prefer `101`. Some select `10` as a compromise: +A value of `101` minimizes screen movement and maintains point visibility with minimal adjustment: ```emacs-lisp -(setq scroll-conservatively 10) ; Note: You might prefer 101 over 10. +(setq scroll-conservatively 101) ``` -A value of `10` permits occasional recentering for additional context but introduces more movement than `101`. - ### How to display Emacs startup duration? To measure and display the time taken for Emacs to start, you can use the following Emacs Lisp function. This function will report both the startup duration and the number of garbage collections that occurred during initialization.