From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752805Ab2A3MXo (ORCPT ); Mon, 30 Jan 2012 07:23:44 -0500 Received: from youngberry.canonical.com ([91.189.89.112]:38922 "EHLO youngberry.canonical.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751181Ab2A3MXm (ORCPT ); Mon, 30 Jan 2012 07:23:42 -0500 Message-ID: <4F268BCC.4000008@canonical.com> Date: Mon, 30 Jan 2012 14:23:40 +0200 From: Jussi Pakkanen User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:10.0) Gecko/20120127 Thunderbird/10.0 MIME-Version: 1.0 To: Henrik Rydberg CC: Dmitry Torokhov , linux-input@vger.kernel.org, linux-kernel@vger.kernel.org, Chase Douglas Subject: Re: [PATCH] Input: Document the device properties References: <1327912546-16960-1-git-send-email-rydberg@euromail.se> In-Reply-To: <1327912546-16960-1-git-send-email-rydberg@euromail.se> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 01/30/2012 10:35 AM, Henrik Rydberg wrote: > +INPUT_PROP_BUTTONPAD: > +-------------------- > +For touchpads where the button is placed under the touchpad, such as > +clickpads and macbooks, this property should be set. Common in devices from > +2009 and onwards. "Under" can be interpreted to mean "under as in towards the user when looking from above" as well as "under as in towards the Earth's core". A more unambiguous description would be something like "For touchpads where a physical button is beneath the pad's touch surface so that pushing down on the touchpad causes a button click". > +INPUT_PROP_SEMI_MT: > +------------------ > +Some touchpads, most common between 2008 and 2011, can detect the presence > +of multiple contacts without resolving the individual positions; only the > +number of contacts and the corresponding bounding box is known. For such > +touchpads, the semi-mt property should be set. A "corresponding bounding box" usually means "a bounding box that contains all touches on the touchpad". I've been told (though I have not checked it myself) that there are devices that don't do this. They only report a bounding box for some subset of touches. If this is the case, it should be documented here.