[swift-evolution] [Review] SE-0006 Apply API Guidelines to the Standard Library

Dave Abrahams dabrahams at apple.com
Wed Jan 27 02:48:29 CST 2016


on Tue Jan 26 2016, Guillaume Lessard <swift-evolution at swift.org> wrote:

>> On 27 janv. 2016, at 00:07, Dave Abrahams via swift-evolution
>> <swift-evolution at swift.org> wrote:
>> 
>> Does anybody on this list feel that "precondition" is too inaccessible?
>
> I don’t, but I do like “require”. Unlike “precondition”, “require” is
> straightforward language. 

...which is why I originally requested the change.

> That particular use of “precondition” isn’t necessarily
> “pre”-anything; nothing prevents anyone from sticking a precondition()
> call just before returning from a function; then it becomes a weird
> misnomer.

Sort of, sort of not.  It happens that sometimes you can't tell that the
precondition is violated until sometime late in the function.  So it may
be a surprising place to see the word "precondition," but it still can
be a precondition check.

> I am skeptical of “term of art” as a justification, because it is
> nearly a synonym of “jargon”, and that is not a good thing.

It *is* a synonym for "jargon," which is neither a good nor a bad thing.
Jargon exists for a reason: to allow us to communicate precisely about
topics in specialized domains.  Can you imagine where we'd be if doctors
couldn't use medical jargon to describe symptoms and procedures?

-- 
-Dave



More information about the swift-evolution mailing list