xf86 input driver API question

[Peter Hutterer]

On Mon, May 15, 2017 at 08:25:07AM +0200, Martin Kepplinger wrote:
> Am 2017-05-15 um 06:02 schrieb Alan Coopersmith:
> > On 05/14/17 08:48 AM, Martin Kepplinger wrote:
> >> might be a dumb question, but I don't find resources: If an Xorg input
> >> driver supports GET_ABI_MAJOR() < 14, what exactly does that mean?
> >> xserver < 1.14 is supported? Where is the documentation on this driver
> >> ABI?
> > 
> > It's out of date, but https://www.x.org/wiki/XorgModuleABIVersions/ has a
> > table mapping the various ABI versions to Xorg server versions.
> > 
> > The ABI documentation is mostly in the headers and sources for the X
> > server.
> > 
> 
> Please update that :) Furthermore. I'd need a list of API symbols and
> functions with the server version they got introduced.

the server's API isn't like a library one, it's mostly a successino of 'we
need that symbol' or a 'that one needs to change'. So there's no real list
of API symbols, though sdksyms.sh will produce something resembling it. That
won't tell you the details on the ABI though (it won't pick up on parameter
changes).

yes, we know that is terrible, such is life. if we had a time machine, it'd
be different. (Then again, if we really had a time machine, fixing the
xserver driver ABI mess likely wouldn't be much of a priority) 

> Specifically, since when exist:
> 
> xf86IDrvMsg()
> xf86PostTouchEvent()

iirc that one was introduced in 1.12

> but also the property labels.

I'm not sure what you mean by property labels, but button and axis labels
were added in 1.7 with XI2.0 support (iirc).

> https://www.x.org/wiki/Development/Documentation/Multitouch/ says 2.2,
> does that mean, xserver minimum version 1.6?

2.2 refers to the inputproto version.

Cheers,
   Peter

> It'd make development very much easier if there'd be just one
> documentation page with this kept up to date. It really could be clearer.
> 
> thanks for getting back at me!
> 
>                                  martin