Re: [apps-discuss] Working Group Last Call for draft-ietf-appsawg-file-scheme

Graham Klyne <gk@ninebynine.org> Tue, 24 November 2015 12:22 UTC

Return-Path: <gk@ninebynine.org>
X-Original-To: apps-discuss@ietfa.amsl.com
Delivered-To: apps-discuss@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9CB081A1BC2 for <apps-discuss@ietfa.amsl.com>; Tue, 24 Nov 2015 04:22:35 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.2
X-Spam-Level:
X-Spam-Status: No, score=-4.2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3] autolearn=ham
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 JKtLxZ5KLF6h for <apps-discuss@ietfa.amsl.com>; Tue, 24 Nov 2015 04:22:32 -0800 (PST)
Received: from relay12.mail.ox.ac.uk (relay12.mail.ox.ac.uk [129.67.1.163]) by ietfa.amsl.com (Postfix) with ESMTP id C60D11A1BBD for <apps-discuss@ietf.org>; Tue, 24 Nov 2015 04:22:32 -0800 (PST)
Received: from smtp4.mail.ox.ac.uk ([129.67.1.207]) by relay12.mail.ox.ac.uk with esmtp (Exim 4.80) (envelope-from <gk@ninebynine.org>) id 1a1CcB-0001n0-dw; Tue, 24 Nov 2015 12:22:31 +0000
Received: from gklyne38.plus.com ([81.174.129.24] helo=cheery.atuin.ninebynine.org) by smtp4.mail.ox.ac.uk with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from <gk@ninebynine.org>) id 1a1CcB-0003GQ-Do; Tue, 24 Nov 2015 12:22:31 +0000
Message-ID: <56545687.3010400@ninebynine.org>
Date: Tue, 24 Nov 2015 12:22:31 +0000
From: Graham Klyne <gk@ninebynine.org>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:31.0) Gecko/20100101 Thunderbird/31.3.0
MIME-Version: 1.0
To: "Murray S. Kucherawy" <superuser@gmail.com>, IETF Apps Discuss <apps-discuss@ietf.org>
References: <CAL0qLwb-p0zMpw3+YWRuFY+T5ZwOpWjDNpXehXXpS9WfwJkKqA@mail.gmail.com>
In-Reply-To: <CAL0qLwb-p0zMpw3+YWRuFY+T5ZwOpWjDNpXehXXpS9WfwJkKqA@mail.gmail.com>
Content-Type: text/plain; charset="windows-1252"; format="flowed"
Content-Transfer-Encoding: 8bit
X-Oxford-Username: zool0635
Archived-At: <http://mailarchive.ietf.org/arch/msg/apps-discuss/fGsPEiblQ6y0ppsV7SFB92U5ogs>
Subject: Re: [apps-discuss] Working Group Last Call for draft-ietf-appsawg-file-scheme
X-BeenThere: apps-discuss@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: General discussion of application-layer protocols <apps-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/apps-discuss/>
List-Post: <mailto:apps-discuss@ietf.org>
List-Help: <mailto:apps-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/apps-discuss>, <mailto:apps-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 24 Nov 2015 12:22:35 -0000

All,

Apologies for my late response - I missed the original last call, and early 
follow-up.

I would be happy for this to go forward as-is, but I do have a couple of minor 
comments to offer (if only to prove I actually read it again!).

...

[Minor] In section 3, I'm finding the reference to "implementation" a bit vague 
(does this mean URI generators, parsers, or what?), though I suppose it's easy 
enough to figure from the context.

Suggest:

OLD:
3.  Operations on file URIs

    Implementations SHOULD, at a minimum, provide a read-like operation
    to return the contents of a file located by a file URI.  Additional
    operations MAY be provided, such as writing to, creating, and
    deleting files.  See the POSIX file and directory operations [POSIX]
    for examples of standardized operations that can be performed on
    files.

NEW:
3.  Operations on file URIs

    Implementations that provide dereferencing operations on file: URIs
    SHOULD, at a minimum, provide a read-like operation
    to return the contents of a file located by a file URI.  Additional
    operations MAY be provided, such as writing to, creating, and
    deleting files.  See the POSIX file and directory operations [POSIX]
    for examples of standardized operations that can be performed on
    files.

(I hope it's clear that "dereference" is used here in the sense of section 1.2.2 
of RFC3986 - https://tools.ietf.org/html/rfc3986#section-1.2.2)

...

[Minor] In section 3, the text "can only be dereferenced" seems a bit strong - 
in that it appears to prohibit dereferencing lon-local file URIs.

Suggest:

OLD:
    A file URI can only be dereferenced or translated to a local file
    path if it is local.  A file URI is considered "local" if it has a
    blank or no authority, or the authority is the special string
    "localhost".


NEW:
    A file URI can be dependably dereferenced or translated to a local file
    path only if it is local.  A file URI is considered "local" if it has a
    blank or no authority, or the authority is the special string
    "localhost".

...

(Section 6, aside: it's really strange for me to read "HP OpenVMS Systems 
Documentation" -- but of course, it's quite correct.)

...

Good work!

#g
--


On 02/11/2015 03:50, Murray S. Kucherawy wrote:
> Colleagues,
>
> This note starts a Working Group Last Call for draft-ietf-appsawg-file-scheme.
> This document has been with us for a while and feedback has fallen to a
> trickle.  We've gotten all the feedback from W3C that we expect, so we'd like to
> move it toward publication.
>
> Please provide review comments or expressions of support for the current version
> either on this list or privately to
> draft-ietf-appsawg-file-scheme.all@tools.ietf.org
> <mailto:draft-ietf-appsawg-file-scheme.all@tools.ietf.org> on or before November
> 20, 2015.  Be as detailed as possible.  The co-chairs need to determine if the
> document has working group consensus, which means we need to know people have
> read the latest version and agree with its content and with the idea that it is
> ready to proceed.  A simple “+1” doesn’t tell us anything.
>
> Also, if any participant has knowledge of IPR that needs to be declared on this
> work, please do so, as required by BCPs 78 and 79.
>
> Dave Crocker is fulfilling the duties of document shepherd.
>
> -MSK, APPSAWG co-chair
>
>
> _______________________________________________
> apps-discuss mailing list
> apps-discuss@ietf.org
> https://www.ietf.org/mailman/listinfo/apps-discuss
>