From: Peter Hutterer Date: Tue, 9 Jun 2015 21:52:52 +0000 (+1000) Subject: doc: provide an outline of which scroll method is available where X-Git-Tag: 0.18.0~23 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=91c4770ce6d96045b90189b0088b677c70841353;p=platform%2Fupstream%2Flibinput.git doc: provide an outline of which scroll method is available where Signed-off-by: Peter Hutterer --- diff --git a/doc/scrolling.dox b/doc/scrolling.dox index 61d58f38..e73ba894 100644 --- a/doc/scrolling.dox +++ b/doc/scrolling.dox @@ -2,8 +2,18 @@ @page scrolling Scrolling libinput supports three different types of scrolling methods: @ref -twofinger_scrolling, @ref edge_scrolling and @ref button_scrolling. Some devices -support multiple methods, though only one can be enabled at a time. See +twofinger_scrolling, @ref edge_scrolling and @ref button_scrolling. Some +devices support multiple methods, though only one can be enabled at a time. +As a general overview: +- touchpad devices with physical buttons below the touchpad support edge and + two-finger scrolling +- touchpad devices without physical buttons (@ref clickpad_softbuttons + "clickpads") support two-finger scrolling only +- pointing sticks provide on-button scrolling by default +- mice and other pointing devices support on-button scrolling but it is not + enabled by default + +A device may differ from the above based on its capabilities. See libinput_device_config_scroll_set_method() for documentation on how to switch methods and libinput_device_config_scroll_get_methods() for documentation on how to query a device for available scroll methods.