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. > - * 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" ...