OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

odata message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [OASIS Issue Tracker] Updated: (ODATA-468) Define explicit concepts in ABNF for referenced sets of rules


     [ http://tools.oasis-open.org/issues/browse/ODATA-468?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ralf Handl updated ODATA-468:
-----------------------------

    Proposal: 
Define terms in the [ABNF] for particular patterns referenced elsewhere. For example, define "primitiveValue" rule as a wrapper for the xxxValue values.

Make sure other documents reference the [ABNF], rather than directly reference xml schema or other external definitions, for serialization formats.

  was:
Define terms in the [ABNF] for particular patterns referenced elsewhere. For example, define "UnprefixedPrimitiveLiteral" for the "xxxValue" values.

Make sure other documents reference the [ABNF], rather than directly reference xml schema or other external definitions, for serialization formats.


> Define explicit concepts in ABNF for referenced sets of rules
> -------------------------------------------------------------
>
>                 Key: ODATA-468
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-468
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Task
>          Components: OData ABNF Construction Rules, OData CSDL
>    Affects Versions: V4.0_CS01
>         Environment: [Applied]
>            Reporter: Michael Pizzo
>            Assignee: Ralf Handl
>             Fix For: V4.0_CSD03
>
>
> There are a few places today where we reference things like "xxx" rule in the ABNF. That is, a set of rules that match a particular pattern.
> For example, [CSDL] contains the following text:
>     "Default values MUST be represented according to the xxxValue rule defined in [OData-ABNF] that is appropriate for the type of the property." 
> Which is intended to mean the "unprefixed primitive literal values". However, users looking at the documentation won't find "xxxValue" and, in fact, won't find "xxxValue" rules for some of the primitives (for example, there is no "StringValue".
> Also note that constant expressions reference the xml schema serialization rules, rather than the rules in our ABNF (which are hopefully equivalent?). To make sure we are in sync, documents should reference the primitive value serialization defined in the [ABNF], which should reference xml schema as appropriate.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]