Re: RFC 2119 terms, ALL CAPS vs lower case

Marshall Eubanks <marshall.eubanks@gmail.com> Fri, 18 May 2012 17:04 UTC

Return-Path: <marshall.eubanks@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 6AE1A21F857A for <ietf@ietfa.amsl.com>; Fri, 18 May 2012 10:04:13 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -103.653
X-Spam-Level:
X-Spam-Status: No, score=-103.653 tagged_above=-999 required=5 tests=[AWL=-0.054, BAYES_00=-2.599, 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 W1S4W7hh-JN2 for <ietf@ietfa.amsl.com>; Fri, 18 May 2012 10:04:12 -0700 (PDT)
Received: from mail-lb0-f172.google.com (mail-lb0-f172.google.com [209.85.217.172]) by ietfa.amsl.com (Postfix) with ESMTP id 627F121F853F for <ietf@ietf.org>; Fri, 18 May 2012 10:04:12 -0700 (PDT)
Received: by lbbgo11 with SMTP id go11so2576979lbb.31 for <ietf@ietf.org>; Fri, 18 May 2012 10:04:11 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; bh=tb8u3ghla3SefuPLKhF0VE58lgZiXp5+1zf36avWiEY=; b=D3ugTbKlz3k/0VOkWOPcjgrXtPuJfgECgKElrGWWw51R0qUrCcvIjIgqMxGJRp926C GdKgMep55tthVol74FRRGscJXxuRAniqtNWeWw4BjZkR5D6OTMamaJeXK9ea4Z//VtMY KyD5QLBrwl57U1qzVxkjP2MPpGOVHpqo4XOtK32bKHtx9I5if5znFj8eDfmCrj4YxBDq 3qN6rp5tfLM/QDDpR9oMc1qKEDU3EYqNyJ82sFirx/h19cHD7xQeCPBInvaABg6yBIcv RVX2tMWy7eKIh+YYqtk+liIXPfNzNxqCoMDEk8k8B7JpaoOvnY3ETWs+HMge4tw+3qDi GyiQ==
MIME-Version: 1.0
Received: by 10.112.98.225 with SMTP id el1mr1786783lbb.30.1337360651247; Fri, 18 May 2012 10:04:11 -0700 (PDT)
Received: by 10.112.56.13 with HTTP; Fri, 18 May 2012 10:04:11 -0700 (PDT)
In-Reply-To: <384732C7-C0D6-4D00-B1A8-2B9B86587264@gmail.com>
References: <562A61B995B24BD854A4D154@192.168.0.2> <m262bwchr9.wl%randy@psg.com> <01OFJXXZJB2I0006TF@mauve.mrochek.com> <3AAB0DB9-5E51-4117-B2BB-851700FD9CDC@gmail.com> <01OFK8GNXASC0006TF@mauve.mrochek.com> <384732C7-C0D6-4D00-B1A8-2B9B86587264@gmail.com>
Date: Fri, 18 May 2012 13:04:11 -0400
Message-ID: <CAJNg7VLPALpjN4MGDfPj1i41aPw8St0Pg6OyCcgV-t6d_2teHg@mail.gmail.com>
Subject: Re: RFC 2119 terms, ALL CAPS vs lower case
From: Marshall Eubanks <marshall.eubanks@gmail.com>
To: Ralph Droms <rdroms.ietf@gmail.com>
Content-Type: text/plain; charset="ISO-8859-1"
Content-Transfer-Encoding: quoted-printable
Cc: IETF list discussion <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: Fri, 18 May 2012 17:04:13 -0000

On Fri, May 18, 2012 at 12:41 PM, Ralph Droms <rdroms.ietf@gmail.com> wrote:
>
> On May 16, 2012, at 10:22 PM 5/16/12, Ned Freed wrote:
>
>>
>>> On May 16, 2012, at 5:22 PM 5/16/12, ned+ietf@mauve.mrochek.com wrote:
>>
>>>>>>  The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
>>>>>>  "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
>>>>>>  document are to be interpreted as described in [RFC2119] when they
>>>>>>  appear in ALL CAPS.  These words may also appear in this document in
>>>>>>  lower case as plain English words, absent their normative meanings.
>>>>
>>>>> i like this a lot
>>>>
>>>> I agree. In fact I just incorporated it into the media types registration
>>>> update.
>>
>>> To be sure of meaning and help confusion avoidance, I would prefer that the
>>> key words not appear in the document in lower case and that authors use the
>>> suggested replacement words (or break out the thesaurus?).
>>
>> Preferring it is one thing; I'm OK with that. Making it some sort of
>> hard-and-fast rule is another matter entirely. We have too many of those
>> as it is.
>
> Well, here's another example of imprecision in the written word.  What I meant is that my preference would be a requirement that RFC 2119 key words not appear in lower case at all.
>
> Seems to me that precision of meaning overrides graceful use of the language.  Making the requirement something like "RFC 2119 key words SHOULD NOT appear in lower case unless the lower case usage is clearly non-normative" means we have to think a lot harder about some details and (AD hat and reading glasses firmly in place) we have enough details to think about already.  So, I recommend an errata to RFC 2119: "These words MUST NOT appear in a document in lower case."

...except in a direct quote of another document.

Regards
Marshall

>
> - Ralph
>
>>
>>                               Ned
>