[quicwg/base-drafts] f254fe: Clarify reserved values.

Mike Bishop <noreply@github.com> Wed, 29 April 2020 20:20 UTC

Return-Path: <noreply@github.com>
X-Original-To: quic-issues@ietfa.amsl.com
Delivered-To: quic-issues@ietfa.amsl.com
Received: from localhost (localhost []) by ietfa.amsl.com (Postfix) with ESMTP id B3CF43A1740 for <quic-issues@ietfa.amsl.com>; Wed, 29 Apr 2020 13:20:27 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.1
X-Spam-Status: No, score=-2.1 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=github.com
Received: from mail.ietf.org ([]) by localhost (ietfa.amsl.com []) (amavisd-new, port 10024) with ESMTP id RpnqJlYtTU_K for <quic-issues@ietfa.amsl.com>; Wed, 29 Apr 2020 13:20:22 -0700 (PDT)
Received: from out-7.smtp.github.com (out-7.smtp.github.com []) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 1093D3A173D for <quic-issues@ietf.org>; Wed, 29 Apr 2020 13:20:21 -0700 (PDT)
Received: from github-lowworker-e8b54ca.ac4-iad.github.net (github-lowworker-e8b54ca.ac4-iad.github.net []) by smtp.github.com (Postfix) with ESMTP id B86702C1901 for <quic-issues@ietf.org>; Wed, 29 Apr 2020 13:20:20 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1588191620; bh=SrRblsvr3lcSUoi2ps+he/wlqpHjE/VrPhs3UUuCflk=; h=Date:From:To:Subject:From; b=ZXSwdzmO5LriaCuhaCEi4Xva4qVCgZE63yb1NowdEkIT9KWb2/BuG/XjQf9QoOtwn 5+XeqiuJZsPFJOnLFDDT/WaBJei64vU9w5Z3tdhZjscxb/SW+bH78Yj/nBnXdlROoR iahMHU6iVbssVCQ4nkmAR2VywVnd8peDcHzjaIBk=
Date: Wed, 29 Apr 2020 13:20:20 -0700
From: Mike Bishop <noreply@github.com>
To: quic-issues@ietf.org
Message-ID: <quicwg/base-drafts/push/refs/heads/master/da3ad0-f254fe@github.com>
Subject: [quicwg/base-drafts] f254fe: Clarify reserved values.
Mime-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-GitHub-Recipient-Address: quic-issues@ietf.org
X-Auto-Response-Suppress: All
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic-issues/v9DD6mNXR1zm7x-sQ9_OgXbdZW4>
X-BeenThere: quic-issues@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Notification list for GitHub issues related to the QUIC WG <quic-issues.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/quic-issues>, <mailto:quic-issues-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/quic-issues/>
List-Post: <mailto:quic-issues@ietf.org>
List-Help: <mailto:quic-issues-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/quic-issues>, <mailto:quic-issues-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 29 Apr 2020 20:20:28 -0000

  Branch: refs/heads/master
  Home:   https://github.com/quicwg/base-drafts
  Commit: f254feb0490fb248aa0a4ccd6351072e8e9206b6
  Author: Bence Béky <bnc@google.com>
  Date:   2020-04-29 (Wed, 29 Apr 2020)

  Changed paths:
    M draft-ietf-quic-http.md

  Log Message:
  Clarify reserved values.

Clarify reserved values for stream types, settings identifiers, frame
types, and error codes.

0x1f * N + 0x21 for the value of N = -1 is 0x02.  Literal interpretation
of the current text includes this as a reserved value.  The
parenthetical examples given in Section 11.2 make it clear that this was
not the intention, rendering this PR editorial.

The main motivation of this PR is not that the current text is
inconsistent, but that parenthetical examples from 11.2 are necessary to
correctly interpret the definitions in sections 6.2.3,, 7.2.8,
and 8.1.

Alternative wordings could be:
"0x1f * N + 0x21 for N = 0, 1, 2, ..."
"0x1f * N + 0x02 for positive integer values of N"
"0x1f * N + 0x02 for N = 1, 2, 3, ..."
"0x21, 0x21 + 0x1f, 0x21 + 2 * 0x1f, ..."
"a value of at least 0x21 with a remainder of 0x02 modulo 0x1f"
"a value of at least 0x21 that is congruent to 0x21 modulo 0x1f"
none of which is better than what this PR proposes.