p7: editorial suggestions

Mark Nottingham <mnot@mnot.net> Tue, 23 April 2013 03:48 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 0B84621F95E2 for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Mon, 22 Apr 2013 20:48:53 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -10.492
X-Spam-Level:
X-Spam-Status: No, score=-10.492 tagged_above=-999 required=5 tests=[AWL=0.107, 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 KGm+H3LO+syI for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Mon, 22 Apr 2013 20:48:52 -0700 (PDT)
Received: from frink.w3.org (frink.w3.org [128.30.52.56]) by ietfa.amsl.com (Postfix) with ESMTP id 0855021F95D2 for <httpbisa-archive-bis2Juki@lists.ietf.org>; Mon, 22 Apr 2013 20:48:52 -0700 (PDT)
Received: from lists by frink.w3.org with local (Exim 4.72) (envelope-from <ietf-http-wg-request@listhub.w3.org>) id 1UUUDY-0002jU-SY for ietf-http-wg-dist@listhub.w3.org; Tue, 23 Apr 2013 03:48:32 +0000
Resent-Date: Tue, 23 Apr 2013 03:48:32 +0000
Resent-Message-Id: <E1UUUDY-0002jU-SY@frink.w3.org>
Received: from maggie.w3.org ([128.30.52.39]) by frink.w3.org with esmtp (Exim 4.72) (envelope-from <mnot@mnot.net>) id 1UUUDU-0002iJ-KH for ietf-http-wg@listhub.w3.org; Tue, 23 Apr 2013 03:48:28 +0000
Received: from mxout-08.mxes.net ([216.86.168.183]) by maggie.w3.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.72) (envelope-from <mnot@mnot.net>) id 1UUUDU-0007y6-0a for ietf-http-wg@w3.org; Tue, 23 Apr 2013 03:48:28 +0000
Received: from [192.168.1.80] (unknown [118.209.190.66]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by smtp.mxes.net (Postfix) with ESMTPSA id B135B50A88 for <ietf-http-wg@w3.org>; Mon, 22 Apr 2013 23:48:02 -0400 (EDT)
From: Mark Nottingham <mnot@mnot.net>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Message-Id: <BBC3AF8C-03C1-4A1E-B406-7DCE44AB4B0E@mnot.net>
Date: Tue, 23 Apr 2013 13:48:02 +1000
To: "ietf-http-wg@w3.org Group" <ietf-http-wg@w3.org>
Mime-Version: 1.0 (Mac OS X Mail 6.3 \(1503\))
X-Mailer: Apple Mail (2.1503)
Received-SPF: pass client-ip=216.86.168.183; envelope-from=mnot@mnot.net; helo=mxout-08.mxes.net
X-W3C-Hub-Spam-Status: No, score=-3.4
X-W3C-Hub-Spam-Report: AWL=-3.384, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001
X-W3C-Scan-Sig: maggie.w3.org 1UUUDU-0007y6-0a bd42fbf6233540e521b8bd08865d93fc
X-Original-To: ietf-http-wg@w3.org
Subject: p7: editorial suggestions
Archived-At: <http://www.w3.org/mid/BBC3AF8C-03C1-4A1E-B406-7DCE44AB4B0E@mnot.net>
Resent-From: ietf-http-wg@w3.org
X-Mailing-List: <ietf-http-wg@w3.org> archive/latest/17478
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>

* 2.1 "It uses an extensible, case-insensitive token..."  I know what's meant here, but the token itself isn't extensible; it's an extension point. Suggest: :It uses a case-insensitive token as a means to identify..."

* 2.1 "...based upon a challenge received from the server..." --> "...based upon a challenge received in a response"  ("from the server" implies that the next inbound server generated the challenge, which isn't always the case).

* 2.2 "Note that there can be multiple challenges with the same auth-scheme..." --> "Note that a response can have multiple challenges..."

* 2.2 "Unless otherwise defined by the authentication scheme,..." --> "Unless specifically allowed by the authentication scheme..."

* 2.3.1 "... can only be used once per challenge/credentials."  --> "...once in a challenge or credential."

* 2.3.1 needs references to p6 for cache-control directives it talks about.

* 3.1 "The client MAY repeat the request with a new or replaced Authorisation header field."  s/client/user agent/

* 4.1 'The "Authorization" header field allows a user agent to authenticate itself with a server..."   s/server/origin server/

* 4.3 "Its value consists of credentials containing the authentication information of the user agent for the proxy..."   s/user agent/client/

* 6.2 First paragraph - all instances of 'server' to 'origin server'

* 6.2 "This is of particular concern when a server hosts resources for multiple parties..."   s/server/origin server/

* 6.2 "...by using a different host name for each party."   s/host name/origin/   (or similar; i.e. you can do this with ports too)

--
Mark Nottingham   http://www.mnot.net/