[netmod] Quirky tree diagrams [was: Re: "input"/"output" in tree diagrams]

Jernej Tuljak <jernej.tuljak@mg-soft.si> Thu, 25 October 2018 08:01 UTC

Return-Path: <jernej.tuljak@mg-soft.si>
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 278A8128CF2 for <netmod@ietfa.amsl.com>; Thu, 25 Oct 2018 01:01:13 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2
X-Spam-Level:
X-Spam-Status: No, score=-2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=mg-soft.si
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 o6oshsWC3C7z for <netmod@ietfa.amsl.com>; Thu, 25 Oct 2018 01:01:10 -0700 (PDT)
Received: from galileo.mg-soft.si (gate.mg-soft.si [212.30.73.66]) by ietfa.amsl.com (Postfix) with ESMTP id 12C8B12D4F2 for <netmod@ietf.org>; Thu, 25 Oct 2018 01:01:08 -0700 (PDT)
Received: from [10.0.3.146] (dhcp-146.mg-soft.si [10.0.3.146]) by galileo.mg-soft.si (Postfix) with ESMTP id DE9B2C4175C2; Thu, 25 Oct 2018 10:01:07 +0200 (CEST)
DKIM-Filter: OpenDKIM Filter v2.10.3 galileo.mg-soft.si DE9B2C4175C2
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mg-soft.si; s=default; t=1540454467; bh=VRxjoL5s0yIapgAMOgCIUa+BPVQ4mxIFxngw8tIaCUM=; h=Subject:To:Cc:References:From:Date:In-Reply-To:From; b=ESuoBvIhdbRS9Og7LNHoDSCP6VbPkjXVToPwRKRVDznaay7ZAUpn/NWnYx5wRVr3F UPaut3b+27SygTwcUtBEAkTjLmvbaGCTnKVfH7PdoKwEui8toRiDXZ1aarPhOgOuaT cIpI+tUT3+j8BLbrJ+XNstHArWKthkHc+N76Kl0TFdCHAD4Cqwoc4SD1b15IX3W5ID MtSFyysnOSXXfNQ5xy6f4HxxLKGwFWN1Sj2SyyC5Zvf7X6WGZ72Gt8RBNTLPPcSN6g t9ZfWvQ6iGgY/TOs2sFoA2xUDhPeTg3IbNL8Dkk6Txq42/mDARvummqBhqkwPk7nrS MDRHMayie+KTg==
To: Martin Bjorklund <mbj@tail-f.com>
Cc: netmod@ietf.org
References: <f567e98a-8e8c-2ea7-c5f5-f2288b275174@mg-soft.si> <20181023.161158.1837797983440028086.mbj@tail-f.com>
From: Jernej Tuljak <jernej.tuljak@mg-soft.si>
Message-ID: <5b521a81-98cb-8af4-f093-f514f035fcc4@mg-soft.si>
Date: Thu, 25 Oct 2018 10:01:06 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.2.1
MIME-Version: 1.0
In-Reply-To: <20181023.161158.1837797983440028086.mbj@tail-f.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/YFmh8WFjuR1Bmze1vGYw4qBMVzo>
Subject: [netmod] Quirky tree diagrams [was: Re: "input"/"output" in tree diagrams]
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: Thu, 25 Oct 2018 08:01:13 -0000

What about inner groupings? Are inner groupings supposed to be displayed 
if top-level ones are? If so, how? RFC7895 (YANG library module) is an 
example - if you choose to display but not to expand groupings, you may 
get "+---u"'s that refer to groupings which may never be part of the 
diagram.

Jernej


On 23/10/2018 16:11, Martin Bjorklund wrote:
> Hi,
>
> Jernej Tuljak <jernej.tuljak@mg-soft.si> wrote:
>> Hi,
>>
>> am I reading RFC8340 correctly by assuming "input" and "output" nodes
>> are not to be part of tree diagrams and that instead input/output
>> parameters are now children to the "rpc" or "action" node,
>> distinguished solely via -w/ro flags?
> I hope not, or that was not the intention anyway.
>
>>    rpcs:
>>      +---x get-schema
>>         +---w identifier! string
>>         +---w version?    string
>>         +---w format?     identityref
>>         +--ro data?
> pyang outputs
>
>      +---x get-schema
>         +---w input
>         |  +---w identifier    string
>         |  +---w version?      string
>         |  +---w format?       identityref
>         +--ro output
>            +--ro data?   <anyxml>
>
>
>> Only "input parameters" and "output parameters" are mentioned, which
>> seems to suggest data node children of "input" and "output", but not
>> themselves. It also says nothing about which flag they receive, if
>> they are intended to appear.
> Yes I can see how this could be clarified.
>
>
> /martin