On 2025-01-03 13:09, Bruno Haible wrote:
Paul Eggert wrote:
* The comments in string.in.h should be imperative sentences. E.g., say
"Return true if ..." not "Returns true if ...". Doing it this way is a
bit briefer and is more likely to result in valid English sentences.
You know that I disagree with that.
I may have known that at some time, but I had forgotten it.
I'm more familiar with the longstanding tradition of Emacs, where the
manual says "This function returns X." and the doc strings (which is
closer to what we're talking about here) say "Return X." In both cases
English-language sentences are used.
Of course other styles are possible.
