On Wed, Aug 29, 2018 at 10:54:05AM -0700, Paul E. McKenney wrote: > On Tue, Aug 28, 2018 at 04:01:50PM -0700, Andrew Morton wrote: > > People often use the term "the foo() function". I don't know why - > > just say "foo()"! > > For whatever it is worth... > > I tend to use "The foo() function ..." instead of "foo() ..." in order > to properly capitalize the first word of the sentence. So I might say > "The call_rcu() function enqueues an RCU callback." rather than something > like "call_rcu() enqueues an RCU callback." Or I might use some other > trick to keep "call_rcu()" from being the first word of the sentence. I tend to write 'Use call_rcu() to enqueue a callback." or "When call_rcu() returns, the callback will have been enqueued".
