Skip to content

Commit 6003831

Browse files
committed
Update README.md
1 parent 5ccc8a0 commit 6003831

File tree

1 file changed

+27
-0
lines changed

1 file changed

+27
-0
lines changed

README.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,7 @@ In addition to *minimal-emacs.d*, startup speed is influenced by your computer's
7777
- [Configuring straight.el?](#configuring-straightel)
7878
- [Configuring elpaca (package manager)](#configuring-elpaca-package-manager)
7979
- [Frequently asked questions](#frequently-asked-questions)
80+
- [Customizing Scroll Recentering](#customizing-scroll-recentering)
8081
- [How to display Emacs startup duration?](#how-to-display-emacs-startup-duration)
8182
- [How to use MELPA stable?](#how-to-use-melpa-stable)
8283
- [How to load a local lisp file for machine-specific configurations?](#how-to-load-a-local-lisp-file-for-machine-specific-configurations)
@@ -1145,6 +1146,32 @@ And [add the elpaca bootstrap code](https://github.com/progfolio/elpaca?tab=read
11451146

11461147
## Frequently asked questions
11471148

1149+
### Customizing Scroll Recentering
1150+
1151+
By default, minimal-emacs.d sets `scroll-conservatively` to `101`:
1152+
1153+
```emacs-lisp
1154+
(setq scroll-conservatively 101) ; Default minimal-emacs.d value
1155+
```
1156+
1157+
A value of `101` minimizes screen movement and maintains point visibility with minimal adjustment, which many users find optimal for rapid navigation.
1158+
1159+
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:
1160+
1161+
```emacs-lisp
1162+
(setq scroll-conservatively 0) ; NOT RECOMMENDED. SET IT TO 101 INSTEAD.
1163+
```
1164+
1165+
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.
1166+
1167+
Most users prefer `101`. Some select `10` as a compromise:
1168+
1169+
```emacs-lisp
1170+
(setq scroll-conservatively 10) ; Note: You might prefer 101 over 10.
1171+
```
1172+
1173+
A value of `10` permits occasional recentering for additional context but introduces more movement than `101`.
1174+
11481175
### How to display Emacs startup duration?
11491176

11501177
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.

0 commit comments

Comments
 (0)