Quoting Matthew Wilcox (2019-07-30 14:12:50) > On Tue, Jul 30, 2019 at 02:07:52PM -0700, Stephen Boyd wrote: > > The documentation for these functions indicates that callers don't need > > to hold a lock while calling them, but that documentation is only in one > > place under "IDA Usage". Let's state the same information on each IDA > > function so that it's clear what the calling context requires. > > Furthermore, let's document ida_simple_get() with the same information > > so that callers know how this API works. > > I don't want people to use ida_simple_get() any more. Use ida_alloc() > instead. Fair enough. I'll document it as deprecated in another patch. > > > - * Context: Any context. > > + * Context: Any context. It is safe to call this function without > > + * synchronisation in your code. > > I prefer "without locking" to "without synchronisation" ... > Ok. Resending shortly.