From 17cf5375d09c917c75d5624fae01de4376fb7533 Mon Sep 17 00:00:00 2001
From: Jinyang Li <jinyangustc@users.noreply.github.com>
Date: Sat, 8 Feb 2025 06:27:01 -0600
Subject: [PATCH] Document the pixel scroll option for `emacs-mac` build (#28)

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 205ce20..7353767 100644
--- a/README.md
+++ b/README.md
@@ -655,8 +655,18 @@ And [add the elpaca bootstrap code](https://github.com/progfolio/elpaca?tab=read
   :config
   (which-key-mode))
 
+;; Disable momentum-based scrolling for precise control and enable smoother scrolling.
 (setq pixel-scroll-precision-use-momentum nil)
 (pixel-scroll-precision-mode 1)
+;; Note: If you're using the pre-built `emacs-mac` (version <= 29.1), pixel-based smooth scrolling
+;; is handled by the Mac port code instead of `pixel-scroll-precision-mode`. In this case, use the
+;; following line instead of the two lines above:
+;;
+;; (pixel-scroll-mode 1)
+;;
+;; For more details, see:
+;; https://bitbucket.org/mituharu/emacs-mac/commits/65c6c96f27afa446df6f9d8eff63f9cc012cc738
+
 
 (display-time-mode)
 (show-paren-mode +1)  ; Paren match highlighting