Re: RFC 2119 terms, ALL CAPS vs lower case

Brian E Carpenter <brian.e.carpenter@gmail.com> Wed, 16 May 2012 18:11 UTC

Return-Path: <brian.e.carpenter@gmail.com>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2128021F86B7 for <ietf@ietfa.amsl.com>; Wed, 16 May 2012 11:11:21 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -101.587
X-Spam-Level:
X-Spam-Status: No, score=-101.587 tagged_above=-999 required=5 tests=[AWL=0.104, BAYES_00=-2.599, RCVD_ILLEGAL_IP=1.908, RCVD_IN_DNSWL_LOW=-1, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Ur4jJd1+-oKr for <ietf@ietfa.amsl.com>; Wed, 16 May 2012 11:11:15 -0700 (PDT)
Received: from mail-wg0-f44.google.com (mail-wg0-f44.google.com [74.125.82.44]) by ietfa.amsl.com (Postfix) with ESMTP id 5C9AF21F8625 for <ietf@ietf.org>; Wed, 16 May 2012 11:11:15 -0700 (PDT)
Received: by wgbdr13 with SMTP id dr13so696060wgb.13 for <ietf@ietf.org>; Wed, 16 May 2012 11:11:14 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:organization:user-agent:mime-version:to:cc :subject:references:in-reply-to:content-type :content-transfer-encoding; bh=Frt7h1A22h5WlSwg08b/3I/3yBzAQO84qGCFLJO71VA=; b=mlg5smgWiGLizcKLrngaUdzU/H2X3s0+uYX5LGOnyzZhkJ/w/MkNqOdE8Qm2sCWleL 9vqeV++9vTrE91dC6PWaN+9rvs+ajZwJZerjNEdCsYwTeZkDQ08sYK2ve0HIhp3ZLXDR iFRaxZSwP97kWOuYLf7Rm+cNjV/D2XMgHOJqhnMvh6RilgkKmbNlHUByxB6cLI2AC7iR aAnMXwaFbNCvsOgo9OiJXUcK61Rt3oB3fwgfakPOCzZHpy6jylkSugbNkuii4G3FTLj0 na7M1kpxGiWDcrZr9HEkKLBGLAMISd9UE2EnIE1+COx4irpO7RXrq+2nmrR/zIFWriBm QgYg==
Received: by 10.180.102.101 with SMTP id fn5mr10372637wib.6.1337191874476; Wed, 16 May 2012 11:11:14 -0700 (PDT)
Received: from [192.168.1.65] (host-2-102-216-67.as13285.net. [2.102.216.67]) by mx.google.com with ESMTPS id ga8sm11374372wib.5.2012.05.16.11.11.11 (version=SSLv3 cipher=OTHER); Wed, 16 May 2012 11:11:13 -0700 (PDT)
Message-ID: <4FB3EDB8.60809@gmail.com>
Date: Wed, 16 May 2012 19:11:04 +0100
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Organization: University of Auckland
User-Agent: Thunderbird 2.0.0.6 (Windows/20070728)
MIME-Version: 1.0
To: Peter Saint-Andre <stpeter@stpeter.im>
Subject: Re: RFC 2119 terms, ALL CAPS vs lower case
References: <562A61B995B24BD854A4D154@[192.168.0.2]> <m262bwchr9.wl%randy@psg.com> <08ab01cd3372$65934110$30b9c330$@olddog.co.uk> <tslaa18w21n.fsf@mit.edu> <4FB3E99D.1040606@stpeter.im>
In-Reply-To: <4FB3E99D.1040606@stpeter.im>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Cc: adrian@olddog.co.uk, Sam Hartman <hartmans-ietf@mit.edu>, ietf@ietf.org
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ietf>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 16 May 2012 18:11:21 -0000

On 2012-05-16 18:53, Peter Saint-Andre wrote:
> On 5/16/12 9:58 AM, Sam Hartman wrote:

...
>> I'll note that  in my normal reading mode I  do not distinguish case,
>> but even so I find the ability to use may and should in RFC text without
>> the 2119 implications valuable.

Agreed. But as a gen-art reviewer, I have several times had to ask
authors whether a particular lower case "may" was intended to be normative
or normal English. Authors must be fastidious about this.

> Your mileage may (or is that MAY?) vary, but to forestall confusion I've
> settled on the practice of using "can" and "might" instead of lowercase
> "may", "ought to" and "is suggested to" instead of lowercase "should",
> and "needs to" or "has to" instead of lowercase "must" (etc.). I'm not
> saying that anyone else SHOULD or MUST use that convention, but you
> might consider it in your own spec-writing.

It is indeed very important not to use "may" when it's ambiguous.
"It may rain today" is fine; "you may leave now" is not (I can think
of three different meanings). In RFC2119-talk, "you MAY leave now"
only has one meaning.

   Brian