Jernej Tuljak <jernej.tul...@mg-soft.si> writes:

> Hi,
>
> current text in 6087bis-04 (Section 5.6.4):
>
>     XPath expressions for 'when' statements SHOULD NOT reference the
>     context node or any descendant nodes of the context node.  They MAY
>     reference descendant nodes if the 'when' statement is contained
>     within an 'augment' statement, and the referenced nodes are not
>     defined within the 'augment' statement.
>
> This is OK. But the text never mentions an analogous case, which is when 
> a when-stmt is defined for a uses-stmt. I think this should be 
> corrected. Note that finding the initial context node for the expression 
> uses an algorithm that is virtually equal to the 'augment' case (first 
> data node ancestor), therefore the first sentence in the above text 
> discourages use of 'when' statements within a 'uses' statement, which I 
> don't think was the intention.
>
>    grouping special-params {
>      leaf param1 {
>        type string;
>      }
>      leaf param2 {
>        type string;
>      }
>    }
>
>    container foo {
>      leaf enable-special {
>        type boolean;
>      }
>      uses special-params {
>        when "enable-special = 'true'";
>      }
>    }
>
> In my example the expression references a descendant of the initial 
> context node, which should be OK. What would be problematic is 
> referencing descendants that are defined in the grouping.
>
> OLD:
>
>     XPath expressions for 'when' statements SHOULD NOT reference the
>     context node or any descendant nodes of the context node.  They MAY
>     reference descendant nodes if the 'when' statement is contained
>     within an 'augment' statement, and the referenced nodes are not
>     defined within the 'augment' statement.
>
> NEW:
>
>     XPath expressions for 'when' statements SHOULD NOT reference the
>     context node or any descendant nodes of the context node.  They MAY
>     reference descendant nodes if the 'when' statement is contained
>     within an 'augment' statement, and the referenced nodes are not
>     defined within the 'augment' statement. They MAY also reference
>     descendant nodes if the 'when' statement is contained within a
>     'uses' statement, and the referenced nodes are not defined within
>     the 'grouping' statement being referred to by the 'uses' statement.
>

+1

Lada

> Or something similar.
>
> Jernej
>
>
> internet-dra...@ietf.org je 6.7.2015 ob 19:14 napisal:
>> A New Internet-Draft is available from the on-line Internet-Drafts 
>> directories.
>>   This draft is a work item of the NETCONF Data Modeling Language Working 
>> Group of the IETF.
>>
>>          Title           : Guidelines for Authors and Reviewers of YANG Data 
>> Model Documents
>>          Author          : Andy Bierman
>>      Filename        : draft-ietf-netmod-rfc6087bis-04.txt
>>      Pages           : 52
>>      Date            : 2015-07-06
>>
>> Abstract:
>>     This memo provides guidelines for authors and reviewers of Standards
>>     Track specifications containing YANG data model modules.  Applicable
>>     portions may be used as a basis for reviews of other YANG data model
>>     documents.  Recommendations and procedures are defined, which are
>>     intended to increase interoperability and usability of Network
>>     Configuration Protocol (NETCONF) implementations that utilize YANG
>>     data model modules.
>>
>>
>> The IETF datatracker status page for this draft is:
>> https://datatracker.ietf.org/doc/draft-ietf-netmod-rfc6087bis/
>>
>> There's also a htmlized version available at:
>> https://tools.ietf.org/html/draft-ietf-netmod-rfc6087bis-04
>>
>> A diff from the previous version is available at:
>> https://www.ietf.org/rfcdiff?url2=draft-ietf-netmod-rfc6087bis-04
>>
>>
>> Please note that it may take a couple of minutes from the time of submission
>> until the htmlized version and diff are available at tools.ietf.org.
>>
>> Internet-Drafts are also available by anonymous FTP at:
>> ftp://ftp.ietf.org/internet-drafts/
>>
>> _______________________________________________
>> netmod mailing list
>> netmod@ietf.org
>> https://www.ietf.org/mailman/listinfo/netmod
>>
>
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod

-- 
Ladislav Lhotka, CZ.NIC Labs
PGP Key ID: E74E8C0C

_______________________________________________
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod

Reply via email to