* Jason McIntyre <j...@kerhand.co.uk> [140625 00:41]: > On Tue, Jun 24, 2014 at 09:13:47AM +0200, Alexandre Ratchov wrote: > > I see what you mean. As the manual describes the interface between > > two layers we may need to be more precise about who calls who. > > Wouldn't the following be less ambigous? > > > > When the hardware is ready to accept more samples the driver shall > > call the > > .Fa intr > > function with the argument > > .Fa intrarg . > > > > the use of "will" is perfectly fine here - it's basically a conditional > sentence structure. > > "shall" sounds awful. it sounds formal, dated, and like a document > produced by posix. please don;t make this change. > > what is simpler, i think, and easier for most folks to understand, is > using a present tense: > > When the hardware is ready to accept more samples, > the driver calls the > .Fa intr > function with the argument > .Fa intrarg . > > it's all a matter of taste, i suppose, but present tense structure does > seem to be easier to read for non-native speakers (in my experience).
I agree, this one looks even better.
