Messages in this thread | | | Subject | Re: [PATCH v4 3/4] futex: Document ordering guarantees | From | Darren Hart <> | Date | Thu, 19 Dec 2013 15:19:59 -0800 |
| |
On Thu, 2013-12-19 at 15:05 -0800, Randy Dunlap wrote: > On 12/19/13 13:07, Darren Hart wrote: > > On Thu, 2013-12-19 at 13:00 -0800, Davidlohr Bueso wrote: > >> On Thu, 2013-12-19 at 12:51 -0800, Randy Dunlap wrote: > >>> On 12/19/13 12:45, Davidlohr Bueso wrote: > >>>> From: Thomas Gleixner <tglx@linutronix.de> > >>>> > >>>> That's essential, if you want to hack on futexes. > >>>> > >>>> Cc: Ingo Molnar <mingo@kernel.org> > >>>> Cc: Darren Hart <dvhart@linux.intel.com> > >>>> Acked-by: Peter Zijlstra <peterz@infradead.org> > >>>> Cc: Thomas Gleixner <tglx@linutronix.de> > >>>> Cc: Paul E. McKenney <paulmck@linux.vnet.ibm.com> > >>>> Cc: Mike Galbraith <efault@gmx.de> > >>>> Cc: Jeff Mahoney <jeffm@suse.com> > >>>> Cc: Linus Torvalds <torvalds@linux-foundation.org> > >>>> Cc: Scott Norton <scott.norton@hp.com> > >>>> Cc: Tom Vaden <tom.vaden@hp.com> > >>>> Cc: Aswin Chandramouleeswaran <aswin@hp.com> > >>>> Cc: Waiman Long <Waiman.Long@hp.com> > >>>> Cc: Jason Low <jason.low2@hp.com> > >>>> Signed-off-by: Thomas Gleixner <tglx@linutronix.de> > >>>> Signed-off-by: Davidlohr Bueso <davidlohr@hp.com> > >>>> --- > >>>> kernel/futex.c | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ > >>>> 1 file changed, 57 insertions(+) > >>>> > >>>> diff --git a/kernel/futex.c b/kernel/futex.c > >>>> index 577481d..af1fc31 100644 > >>>> --- a/kernel/futex.c > >>>> +++ b/kernel/futex.c > >>>> @@ -69,6 +69,63 @@ > >>>> > >>>> #include "locking/rtmutex_common.h" > >>>> > >>>> +/* > >>>> + * Basic futex operation and ordering guarantees: > >>>> + * > >>>> + * The waiter reads the futex value in user space and calls > >>>> + * futex_wait(). It computes the hash bucket and acquires the hash > >>> > >>> does It > >>> refer to "the waiter" or to futex_wait()? > >>> I read it as referring to the waiter, but ISTM that the comments are using It > >>> to refer to futex_wait()... ??? > >>> > >> > >> Yes, it refers to futex_wait(), which IMO in a futex context is pretty > >> clear. > > > > > > Agreed. > > > > > > I'll just have to get by with disagreeing with both of you then. > I say that the pronoun's antecedent is ambiguous (unclear). >
You are correct from a purely grammatical perspective, no argument there. I just feel that the comment is clear enough from the context - although perhaps people that hack on futexes should be excluded from having an opinion here as we are biased :-)
If Davidlohr is going to resubmit for other reasons, then by all means, please correct this per Randy's suggestion - I just didn't want to put him (Davidlohr ;-) through another round of patches for this alone.
Thanks for ensuring our docs are as clear as possible Randy!
-- Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel
| |