Re: [yang-doctors] reference in import statement

Ladislav Lhotka <lhotka@nic.cz> Fri, 16 February 2018 15:56 UTC

Return-Path: <lhotka@nic.cz>
X-Original-To: yang-doctors@ietfa.amsl.com
Delivered-To: yang-doctors@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0EBD6120454 for <yang-doctors@ietfa.amsl.com>; Fri, 16 Feb 2018 07:56:12 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9] autolearn=ham autolearn_force=no
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 z34MEiIjOsn3 for <yang-doctors@ietfa.amsl.com>; Fri, 16 Feb 2018 07:56:10 -0800 (PST)
Received: from trail.lhotka.name (trail.lhotka.name [77.48.224.143]) by ietfa.amsl.com (Postfix) with ESMTP id 0F8091201F2 for <yang-doctors@ietf.org>; Fri, 16 Feb 2018 07:56:10 -0800 (PST)
Received: by trail.lhotka.name (Postfix, from userid 109) id 62DEA1820413; Fri, 16 Feb 2018 16:54:01 +0100 (CET)
Received: from localhost (nat-2.nic.cz [217.31.205.2]) by trail.lhotka.name (Postfix) with ESMTPSA id 7981018203DE; Fri, 16 Feb 2018 16:53:59 +0100 (CET)
From: Ladislav Lhotka <lhotka@nic.cz>
To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>, yang-doctors@ietf.org
In-Reply-To: <20180215083130.uagwwr5huxgs5qst@elstar.local>
References: <20180215083130.uagwwr5huxgs5qst@elstar.local>
Date: Fri, 16 Feb 2018 16:56:06 +0100
Message-ID: <87mv09nd2h.fsf@nic.cz>
MIME-Version: 1.0
Content-Type: text/plain
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/XnZ5NDCpgH_7TwSfYWyfmnB-Lu8>
Subject: Re: [yang-doctors] reference in import statement
X-BeenThere: yang-doctors@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: Email list of the yang-doctors directorate <yang-doctors.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/yang-doctors/>
List-Post: <mailto:yang-doctors@ietf.org>
List-Help: <mailto:yang-doctors-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 16 Feb 2018 15:56:12 -0000

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> writes:

> Hi,
>
> I have just seen this pattern
>
>    import ietf-inet-types {
>      prefix "inet";
>      reference "RFC 6991";
>    }
>
> and I wonder how people understand this. From the way this import

I would say this tries to instruct the implementor that *at least*
the revision from RFC 6991 has to be used, perhaps because the new types
like "ip-address-no-zone" are used.

Using import by revision would mean that newer versions cannot be used
even though they are OK.

Lada

> works, any (newer) version of ietf-inet-types is OK to use to resolve
> the import but I could see that this statement makes people believe
> they have to use the version of ietf-inet-types contained in RFC 6991
> (but then this should have been import by revision). I know that we
> had a common practice to have comments before this was possible, like
>
>    import ietf-inet-types {             // RFC 6991
>      prefix "inet";
>    }
>
> but then this was a comment, now the RFC numbers becomes part of the
> definition. Should we be concerned about this? Or should we suggest
> to be more clear about this, e.g.:
>
>    import ietf-inet-types {
>      prefix "inet";
>      reference "RFC 6991 (at the time of this writing)";
>    }
>
> /js
>
> -- 
> Juergen Schoenwaelder           Jacobs University Bremen gGmbH
> Phone: +49 421 200 3587         Campus Ring 1 | 28759 Bremen | Germany
> Fax:   +49 421 200 3103         <https://www.jacobs-university.de/>
>
> _______________________________________________
> yang-doctors mailing list
> yang-doctors@ietf.org
> https://www.ietf.org/mailman/listinfo/yang-doctors

-- 
Ladislav Lhotka
Head, CZ.NIC Labs
PGP Key ID: 0xB8F92B08A9F76C67