emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: Scan of regexps in Emacs (March 17)


From: Drew Adams
Subject: RE: Scan of regexps in Emacs (March 17)
Date: Wed, 20 Mar 2019 15:59:26 -0700 (PDT)

(Caveat: I have not been following this thread, and I
have not looked at your change.)

> These new recommendations ("should"s in the attached patch)...
            ^^^^^^^^^^^^^^^   ^^^^^^

*Should* is a weasel word that should (!) generally
be avoided in technical doc (including user guides).

Either say "must" (e.g. if we raise an error otherwise)
or say that we "recommend"...  (And extra points for
saying _why_ it's recommended, something that users
generally deserve to understand.)


https://en.wikipedia.org/wiki/Weasel_word



reply via email to

[Prev in Thread] Current Thread [Next in Thread]