[quicwg/base-drafts] QPACK [editorial] Update text on wire instructions. (#2938)

Bence Béky <notifications@github.com> Wed, 31 July 2019 15:59 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 [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D83711202B5 for <quic-issues@ietfa.amsl.com>; Wed, 31 Jul 2019 08:59:00 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -7.998
X-Spam-Level:
X-Spam-Status: No, score=-7.998 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, FROM_EXCESS_BASE64=0.001, HTML_IMAGE_ONLY_32=0.001, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_HI=-5, SPF_HELO_NONE=0.001, SPF_PASS=-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 ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 7qDeebSpH90f for <quic-issues@ietfa.amsl.com>; Wed, 31 Jul 2019 08:58:58 -0700 (PDT)
Received: from out-6.smtp.github.com (out-6.smtp.github.com [192.30.252.197]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id DC45A1202B1 for <quic-issues@ietf.org>; Wed, 31 Jul 2019 08:58:57 -0700 (PDT)
Date: Wed, 31 Jul 2019 08:58:57 -0700
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1564588737; bh=/uBsm1tF6PtSB7puL5pHwh4O4XEUtROvB6AgPzIOEsg=; h=Date:From:Reply-To:To:Cc:Subject:List-ID:List-Archive:List-Post: List-Unsubscribe:From; b=dS9B3XnN10dXWgI9CcnwwXW4TUdelQ0enW83hb8zpFO1nkeKEmSEX0wOARH2XVldF j5cdLDx9U6qo7dsUS3hp7qQABg1Fvfa9pop3nYlBNjxlMjUmuoQVjTunRzAPsMT2WC H313fKV1rBPhjoFy49bg1k4i/UnYlp7c6Kq/rCtg=
From: Bence Béky <notifications@github.com>
Reply-To: quicwg/base-drafts <reply+AFTOJK6U7DH6PKIGKF3B2QV3J3WUDEVBNHHBYU3JAU@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/pull/2938@github.com>
Subject: [quicwg/base-drafts] QPACK [editorial] Update text on wire instructions. (#2938)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_5d41bac124900_161a3fab522cd96c52513"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: bencebeky
X-GitHub-Recipient: quic-issues
X-GitHub-Reason: subscribed
X-Auto-Response-Suppress: All
X-GitHub-Recipient-Address: quic-issues@ietf.org
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic-issues/Dk6OsVTfHzRrXmE9FB1o6I3W0V8>
X-BeenThere: quic-issues@ietf.org
X-Mailman-Version: 2.1.29
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, 31 Jul 2019 15:59:01 -0000

* Use more uniform language in description of instructions: "begin" instead of "start" everywhere (arbitrarily, but make it consistent); "follows" instead of "includes" or implicit mention of a field.
* Prefer internal references to external ones, also elsewhere.
* Prefer "instruction" to "representation" in low-level contexts focusing on wire format, but not in higher-level contexts.
* Avoid undefined term "header block representation" when it is used to mean "header block".
* Explicitly allow a header block to not have any instructions after the mandatory prefix.
* Refer to Literal Header Field With Name Reference section in Literal Header Field Without Name Reference instead of verbatim repeating text on 'N' bit.

You can view, comment on, or merge this pull request online at:

  https://github.com/quicwg/base-drafts/pull/2938

-- Commit Summary --

  * instructions

-- File Changes --

    M draft-ietf-quic-qpack.md (175)

-- Patch Links --

https://github.com/quicwg/base-drafts/pull/2938.patch
https://github.com/quicwg/base-drafts/pull/2938.diff

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/quicwg/base-drafts/pull/2938