summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPeter Hutterer <peter.hutterer@who-t.net>2023-04-18 13:52:49 +1000
committerPeter Hutterer <peter.hutterer@who-t.net>2023-04-18 16:54:57 +1000
commit8e34037dcd1d4fc1bd266ccbdfc117985ee4ef03 (patch)
tree37270242ccf50781484ecd3ab0e1487f31a51ea8
parent7073a39ec020b9dc148cf477260453fe4e583510 (diff)
downloadlibinput-8e34037dcd1d4fc1bd266ccbdfc117985ee4ef03.tar.gz
doc/user: add a section on natural scrolling
Just for completeness, turns out we were missing that one. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
-rw-r--r--doc/user/scrolling.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/user/scrolling.rst b/doc/user/scrolling.rst
index e568755d..2adec76f 100644
--- a/doc/user/scrolling.rst
+++ b/doc/user/scrolling.rst
@@ -150,3 +150,23 @@ See the **libinput_event_pointer_get_axis_source()** for details on the
behavior of each scroll source.
See also http://who-t.blogspot.com.au/2015/03/libinput-scroll-sources.html
+
+.. _natural_scrolling:
+
+------------------------------------------------------------------------------
+Natural scrolling vs. traditional scrolling
+------------------------------------------------------------------------------
+
+Natural scrolling is the term (probably) coined by Apple for matching
+the motion of the scroll device with the direction of the **content**.
+
+In traditional scrolling, moving the wheel down causes the scroll bar
+indicators to move down and the content to move up. In natural scrolling,
+moving the wheel down causes the content to move down and the scroll bar
+indicators to move up. This method of scrolling matches the interaction
+with content on touch screens where a movement down also moves the content
+down.
+
+libinput supports natural scrolling for all its scroll methods; it can
+be enabled with the
+**libinput_device_config_scroll_set_natural_scroll_enabled()** function.