Input: document the units for resolution of size axes
authorSiarhei Vishniakou <svv@google.com>
Sat, 9 Jul 2022 04:59:23 +0000 (21:59 -0700)
committerDmitry Torokhov <dmitry.torokhov@gmail.com>
Sat, 9 Jul 2022 05:02:00 +0000 (22:02 -0700)
commit2a96271fb66c499e4a89d76a89d3d01170c10bef
tree6c9b0c307da7c342dc5e6fb754d59057aa684a22
parent3de93e6ed2df6521e3f68fb45eec0bb4fe1bb218
Input: document the units for resolution of size axes

Today, the resolution of size axes is not documented. As a result, it's
not clear what the canonical interpretation of this value should be. On
Android, there is a need to calculate the size of the touch ellipse in
physical units (millimeters).

After reviewing linux source, it turned out that most of the existing
usages are already interpreting this value as "units/mm". This
documentation will make it explicit. This will help device
implementations with correctly following the linux specs, and will
ensure that the devices will work on Android without needing further
customized parameters for scaling of major/minor values.

Signed-off-by: Siarhei Vishniakou <svv@google.com>
Reviewed-by: Jeff LaBundy <jeff@labundy.com>
Link: https://lore.kernel.org/r/20220520084514.3451193-1-svv@google.com
Signed-off-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
include/uapi/linux/input.h