Re: [netmod] IETF 108: Summary of insignificant whitespace changes and versioning

Martin Björklund <mbj+ietf@4668.se> Wed, 12 August 2020 08:34 UTC

Return-Path: <mbj+ietf@4668.se>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id BB9CF3A0DFB for <netmod@ietfa.amsl.com>; Wed, 12 Aug 2020 01:34:16 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=4668.se header.b=fA+HFH8j; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=LXhAGats
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 alc-5xisRAgG for <netmod@ietfa.amsl.com>; Wed, 12 Aug 2020 01:34:15 -0700 (PDT)
Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 6D8133A0E63 for <netmod@ietf.org>; Wed, 12 Aug 2020 01:34:14 -0700 (PDT)
Received: from compute2.internal (compute2.nyi.internal [10.202.2.42]) by mailout.nyi.internal (Postfix) with ESMTP id AA1F25C00EE; Wed, 12 Aug 2020 04:34:13 -0400 (EDT)
Received: from mailfrontend2 ([10.202.2.163]) by compute2.internal (MEProxy); Wed, 12 Aug 2020 04:34:13 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=4668.se; h=date :message-id:to:cc:subject:from:in-reply-to:references :mime-version:content-type:content-transfer-encoding; s=fm2; bh= vk5fbBhvONkfxEUC11fFT0IXnLKDLuQki2Kg1IrzR4w=; b=fA+HFH8jGuOnLO1N 4R0EwTkFywW9nEt1UA4vfCuLPc/Qm4wSFiCKd1V35P425lScXyyBM3ZS0qHjkXjz pPllJCJnd5dRX7Kv5yJ1GywXZ1Pyck425D4Tt67BCqhSXEI+cpyaR4MnpCJ+npZh bbQduCplKfZN3dQUJ1pMYVtsklQc6IcmysZrUqCuEoKNa4LYmmqd4N9Z03d+rIwp OW8yeLXH7Ic9j67kZVhQpGd39vYou9n9QC/Zx6K76MaqHLzKb2nC446Jb2UsEUfw AEDeEWK1m+moddVLN9DNK/71T4oGuNrv7QhKnZ3wEasc8eyUmNbc5INfbTNMnMQs eGRN2A==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=vk5fbBhvONkfxEUC11fFT0IXnLKDLuQki2Kg1IrzR 4w=; b=LXhAGats99smJhJwxCWgFMSIoqToolM+Oc3E2G3pxCbuQVgJPCPWxAGse +mstoadBi8O4FfV3AaUeVqOI/nZgoEqxTUWbCgTzZQOj4MMscalq/FR5kRWdA6V8 JAgxAvnyEe7jZn++NyOLyHxFwZ1KblCPrDBPWh1IDagiOYZGSwYAlFSJRNqF1s1r +9OVncbv1PtZKwiclQYX+z4JfU9tkfnCGPALawp4rk6H0d6Es876/pY3gWYSi2l5 b/G/9xLzPP7YW9mBDopVPab+I471sgk8p70roWKwmHSqXBHKyZp8jpgzWZemjQok m817MbJIql70hmU0aBTq3xiiXEghg==
X-ME-Sender: <xms:hKkzX3cs2ybTdXBh6fz40rD-9viQOXOaXhNaJC3YncvFqyqeMlpGEw>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduiedrledvgddtiecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepfffkvffuhfgjfhfogggtgfesthhqre dtredtudenucfhrhhomhepofgrrhhtihhnuceujhpnrhhklhhunhguuceomhgsjhdoihgv thhfseegieeikedrshgvqeenucggtffrrghtthgvrhhnpeekleevhfevtdduvdfhuddvvd efuddvueeftdfgheelgeffjeeiteelffeigfetjeenucffohhmrghinhepjhgrtghosghs qdhunhhivhgvrhhsihhthidruggvnecukfhppeduheekrddujeegrdegrdeggeenucevlh hushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehmsghjodhivght fhesgeeiieekrdhsvg
X-ME-Proxy: <xmx:hKkzX9P07uw6ias6Ee_-hN-QAN_wKHqnvhlPZoD0PaYL69pvesk9kw> <xmx:hKkzXwgomDUiNn3JIFNxs3WJplLZfCTFJQPAl-xnYMdfM1kHLoJv1A> <xmx:hKkzX4-nA6KHh3omQtqpIGKsSKl6QAZDeyFfYuNoayJitPn_uy6dVQ> <xmx:hakzXx0-71LaPkv6LXi6YLD0kTeGLmo_ZrQsqvwn8DhtylWnDLqXXA>
Received: from localhost (unknown [158.174.4.44]) by mail.messagingengine.com (Postfix) with ESMTPA id 2222C30600B1; Wed, 12 Aug 2020 04:34:12 -0400 (EDT)
Date: Wed, 12 Aug 2020 10:34:10 +0200 (CEST)
Message-Id: <20200812.103410.1214747298363462899.id@4668.se>
To: j.schoenwaelder@jacobs-university.de
Cc: ladislav.lhotka@nic.cz, jclarke=40cisco.com@dmarc.ietf.org, netmod@ietf.org
From: Martin =?iso-8859-1?Q?Bj=F6rklund?= <mbj+ietf@4668.se>
In-Reply-To: <20200811161307.v3j7lhap7cd7qwse@anna.jacobs.jacobs-university.de>
References: <19f17f7b-a48a-add0-351d-7a93e959dd7b@nic.cz> <20200811.170613.15308869624694470.id@4668.se> <20200811161307.v3j7lhap7cd7qwse@anna.jacobs.jacobs-university.de>
X-Mailer: Mew version 6.8 on Emacs 26.3
Mime-Version: 1.0
Content-Type: Text/Plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/--G7jcjGsvTbINIHOLyjhAQPUdQ>
Subject: Re: [netmod] IETF 108: Summary of insignificant whitespace changes and versioning
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 12 Aug 2020 08:34:17 -0000

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> wrote:
> On Tue, Aug 11, 2020 at 05:06:13PM +0200, Martin Björklund wrote:
> > 
> > I think that any change in an argument string is an editorial change.
> > 
> > For example, compare these two changes:
> > 
> >    A1.  description "a server.";
> >    A2.  description "A server.";
> > 
> >    B1.  description "A  server.";
> >    B2.  description "A server.";
> > 
> > These are editorial changes, and thus the revision should be changed.
> > 
> > Note however that the following change might look like an editorial
> > whitespace change in the argument, but in fact it is not:
> > 
> >   C1.
> >       description
> >           "A server and
> >            its data.";
> > 
> >   C2.
> >       description
> >         "A server and
> >          its data.";
> 
> +1
> 
> I agree since whitespace outside YANG strings is insignificant.
> 
> Lets raise this to the next level. What about the following?
> 
>    D1. description "A server.";
>    D2. description "A server.";  // not very descriptive
> 
>    E1. description "A server.";  // not	very descriptive
>    E2. // not very descriptive
>        description "A server.";

I think that comments should be treated as insignificant whitespace.

Comments in YANG are not tied to a specific statement, so it is
difficult to e.g. translate them to YIN properly.  For example to
which statement does the comment below belong?

  container foo {
     container bar; /* beware */ container baz;
  }


/martin



> 
> /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/>