On Mon, Jul 20, 2020 at 12:07:31PM +1000, Dave Chinner wrote: > The whole serialisation/atomic/ordering APIs have fallen badly off > the macro cliff, to the point where finding out something as simple > as the order of parameters passed to cmpxchg and what semantics it > provides requires macro-spelunking 5 layers deep to find the generic > implementation function that contains a comment describing what it > does.... > > That's yet another barrier to understanding what all the different > synchronisation primitives do. Documentation/atomic_t.txt ?