5f04b56229
Normally, this would be too small to warrant its own module, but smooth scrolling is one of those things that can tip large swaths of fence-sitting beginners into Emacs' camp. I can't help but imagine how many people get their impression that Emacs is "laggy" or "slow" solely from the way it scrolls. Don't get me wrong, there *are* good reasons to call Emacs slow, but startup and scrolling speed are not it, yet they are easily overblown because it's the first thing you see. I might even consider enabling this by default, but I'll make that decision later. Fix: #8335
:ui smooth-scroll
Description unfold
This module activates OS-independent smooth scrolling in Emacs. This primarily benefits trackpad and scroll wheel users (not so much those that scroll via their keyboards), by utilizing the ultra-scroll package.
For optimal performance from this module, it's highly recommended you use Emacs with native-compilation. MacOS users may also have a better experience using the emacs-mac fork of Emacs, available via Homebrew.
Maintainers
Module flags
This module has no flags.
Packages
Hacks
No hacks documented for this module.
TODO Changelog
This module does not have a changelog yet.
Installation
Enable this module in your doom! block.
This module has no external requirements.
Usage
This module only needs to be activated to experience its benefits.
TODO Configuration
This module has no configuration documentation yet. Write some?
Troubleshooting
This module should work on any platform that provides pixel-level scrolling information from your input hardware, but if you run into issues, here are some things to try:
- Use
M-x ultra-scroll-checkto diagnose common issues. Visit ultra-scroll's documentation for more on interpreting and acting on its results. - Read ultra-scroll's documentation on scrolling speed; it outlines common factors that may impact it and how to mitigate them.
- See Doom's "Why is Emacs/Doom slow?" write-up, where Doom's author documents common factors that can slow Emacs down in general (not specifically to do with scrolling) and what to do about them.
If all else fails, let us know on Discourse or Discord. Only file an issue if you have a good idea what's causing the problem or have an explicit error to report (performance issues, in general, tend to be the result of many factors and are the greatest source of false positives on our issue tracker).
Frequently asked questions
This module has no FAQs yet. Ask one?
TODO Appendix
This module has no appendix yet. Write one?