Re: Editorial Issues: Section 4.2.2

Martin Thomson <martin.thomson@gmail.com> Wed, 24 April 2013 18:14 UTC

Return-Path: <ietf-http-wg-request@listhub.w3.org>
X-Original-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Delivered-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id C193221F8D92 for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Wed, 24 Apr 2013 11:14:48 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -7
X-Spam-Level:
X-Spam-Status: No, score=-7 tagged_above=-999 required=5 tests=[AWL=3.599, BAYES_00=-2.599, RCVD_IN_DNSWL_HI=-8]
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 s2Yxe-6YQ1uK for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Wed, 24 Apr 2013 11:14:48 -0700 (PDT)
Received: from frink.w3.org (frink.w3.org [128.30.52.56]) by ietfa.amsl.com (Postfix) with ESMTP id 0E1B321F8D31 for <httpbisa-archive-bis2Juki@lists.ietf.org>; Wed, 24 Apr 2013 11:14:48 -0700 (PDT)
Received: from lists by frink.w3.org with local (Exim 4.72) (envelope-from <ietf-http-wg-request@listhub.w3.org>) id 1UV4Cl-0007SY-Dt for ietf-http-wg-dist@listhub.w3.org; Wed, 24 Apr 2013 18:14:07 +0000
Resent-Date: Wed, 24 Apr 2013 18:14:07 +0000
Resent-Message-Id: <E1UV4Cl-0007SY-Dt@frink.w3.org>
Received: from lisa.w3.org ([128.30.52.41]) by frink.w3.org with esmtp (Exim 4.72) (envelope-from <martin.thomson@gmail.com>) id 1UV4Ch-0007QN-7b for ietf-http-wg@listhub.w3.org; Wed, 24 Apr 2013 18:14:03 +0000
Received: from mail-la0-f44.google.com ([209.85.215.44]) by lisa.w3.org with esmtps (TLS1.0:RSA_ARCFOUR_SHA1:16) (Exim 4.72) (envelope-from <martin.thomson@gmail.com>) id 1UV4Cc-0006WA-35 for ietf-http-wg@w3.org; Wed, 24 Apr 2013 18:14:03 +0000
Received: by mail-la0-f44.google.com with SMTP id ed20so1897735lab.17 for <ietf-http-wg@w3.org>; Wed, 24 Apr 2013 11:13:31 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=QFrsx/VsAnS2YZ5w6jTI72aHB0TLZtseCg1IQ4KyFoA=; b=R4jZYeO4hPEtOaWVNNENOa3EhaVctFZ4XE9nXUkjbfQqfqajLYMPsnmurx7xGc40Tj qXlMQA/NFLOVAiREYD7kHDqPxp1gs9RW/nUkypNJSPQl54kpEKYLAgpqxjpmL9H8t1py pB1kEwbg6jOQaA4J5KhGzRBX2/6bR9jEgklQO5dk/C/dlVHSQ4DhGUIgCVwE+Thh7llE mHePajPQ29Itk9Vvs+bi9Sw/jBtwXfN/6ysGjky7Z3pcgFwcFmCqHEsZFogkhzw3fMKb zljjizufEknghJFouCk/PB09FTkgOXWy78JvEgkQKt8fqc7Byhy5t1/G/WzUMsz7QoE/ xf5Q==
MIME-Version: 1.0
X-Received: by 10.112.130.40 with SMTP id ob8mr18144793lbb.55.1366827211459; Wed, 24 Apr 2013 11:13:31 -0700 (PDT)
Received: by 10.112.151.171 with HTTP; Wed, 24 Apr 2013 11:13:31 -0700 (PDT)
In-Reply-To: <CABP7Rbfh_V0GVameQzF-5RC+GQa7=XTQoZ3E4vZ5Uu+PL_1w8g@mail.gmail.com>
References: <CABP7Rbfh_V0GVameQzF-5RC+GQa7=XTQoZ3E4vZ5Uu+PL_1w8g@mail.gmail.com>
Date: Wed, 24 Apr 2013 11:13:31 -0700
Message-ID: <CABkgnnXATq1RPUe8ZmzZdUNO6weXE9+Q-nYjJOEMa0NJbJkiHQ@mail.gmail.com>
From: Martin Thomson <martin.thomson@gmail.com>
To: James M Snell <jasnell@gmail.com>
Cc: "ietf-http-wg@w3.org" <ietf-http-wg@w3.org>
Content-Type: text/plain; charset=UTF-8
Received-SPF: pass client-ip=209.85.215.44; envelope-from=martin.thomson@gmail.com; helo=mail-la0-f44.google.com
X-W3C-Hub-Spam-Status: No, score=-3.5
X-W3C-Hub-Spam-Report: AWL=-2.696, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001
X-W3C-Scan-Sig: lisa.w3.org 1UV4Cc-0006WA-35 602203b2c5e484f492280053ace2d0fb
X-Original-To: ietf-http-wg@w3.org
Subject: Re: Editorial Issues: Section 4.2.2
Archived-At: <http://www.w3.org/mid/CABkgnnXATq1RPUe8ZmzZdUNO6weXE9+Q-nYjJOEMa0NJbJkiHQ@mail.gmail.com>
Resent-From: ietf-http-wg@w3.org
X-Mailing-List: <ietf-http-wg@w3.org> archive/latest/17550
X-Loop: ietf-http-wg@w3.org
Resent-Sender: ietf-http-wg-request@w3.org
Precedence: list
List-Id: <ietf-http-wg.w3.org>
List-Help: <http://www.w3.org/Mail/>
List-Post: <mailto:ietf-http-wg@w3.org>
List-Unsubscribe: <mailto:ietf-http-wg-request@w3.org?subject=unsubscribe>

Hey James,


On 24 April 2013 10:11, James M Snell <jasnell@gmail.com>; wrote:
> Recommend reworking this to:
>
>   The following fields MUST be present in all HTTP requests:
>
>   ":method":  the HTTP method for this request (e.g.  "GET", "POST",
>   "HEAD", etc) ([HTTP-p2], Section 4)
>
>   ":path":  the request-target for this URI with "/"
>   prefixed (see [HTTP-p1], Section 3.1.1).  For example, for
>   "http://www.google.com/search?q=dogs" the path would be
>   "/search?q=dogs". [[anchor26: what forms of the HTTPbis
>   request-target are allowed here?]]
>
>   ":host":  the host and optional port portions (see [RFC3986],
>   Section 3.2) of the URI for this request (e.g. "www.google.com:
>   1234").  This header field is the same as the HTTP 'Host'
>   header field ([HTTP-p1], Section 5.4).
>
>   ":scheme":  the scheme portion of the URI for this request (e.g.
>   "https")

Feel free to send a pull request for this.  I see no reason not to
make this sort of change.

There are a lot of less obvious edits of this nature.  From my
perspective, there are too many to fix at once.  For instance, the
entirety of Section 5 needs to be moved to more relevant locations.

There's no reason why you can't just raise an issue or pull request
for editorial stuff that bugs you.

> Also, I recommend removing the additional requirement given in the
> paragraph that follows:
>
>   All header field names starting with ":" (whether defined in this
>   document or future extensions to this document) MUST appear before
>   any other header fields.
>
> The challenge with this is that if we go with any of the proposed
> Delta-based header encoding schemes currently on the table, it is
> difficult to ensure that : prefixed headers are encoded first in the
> header block. It may even be counter productive to the task of
> producing an optimized serialization.

I'm going to suggest that we defer this and remove it when we edit in
header compression, if necessary.  There may be a way to retain this
property.  For instance, we might require operations on ':'-headers to
occur before non-':'-headers.  That might not surface in some
implementations (I wouldn't see why this is something that you would
preserve in your Java implementation, it's just unnecessary
complication), but it might make a routing intermediary marginally
more performant.

--Martin