Chuckling. it's a good thing then that the bleeding-edge Archlinux finally released it's 6.9 kernel package on May 18, 2024. Hate to be late to the party for this kind of thing... All joking aside, the new kernel documentation for the user-space ioctl is much improved. All this new-fangled electronic documentation seems to change overnight. And to think for the first few decades of my life all I had available were these things called books that had reprints every decade or soSorry, but I call BS. Maybe you are thinking of the old documentation? New documentation has been added for Linux 6.9. Before that there were multiple comments that the kernel documentation was basically only the header and that that was incomplete. Those comments were correct - we hadn't seriously expected that so many people would have an interest in writing directly to the ioctls, so documenting them was a lower priority than writing a library that used them.
The headers describe the data types, but they do not describe how the ioctls are to be used. At all. The documentation references the types in the header, cos surprise surprise, those are the types that the ioctls use. I didn't have to include the HTML form of the header types in the docs, but then the reader would've had to manually dig out the header to see what the documentation was referring to. And then there would be complaints about that - and rightfully so.
There really is no pleasing people, particularly Pi users.
.
What's the world coming to?
Statistics: Posted by drankinatty — Mon May 20, 2024 3:25 am