Skip to content

Commit

Permalink
Merge pull request #169 from ietf-wg-asdf/sdfref-clar
Browse files Browse the repository at this point in the history
Clarify that result of sdfRef needs to be valid SDF
  • Loading branch information
cabo authored Jan 22, 2025
2 parents 2f298a3 + 5728481 commit f436f66
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions sdf.md
Original file line number Diff line number Diff line change
Expand Up @@ -1107,9 +1107,14 @@ Name references occur only in specific elements of the syntax of SDF:
## sdfRef {#sdfref}

In a JSON map establishing a definition, the keyword `sdfRef` is used
to copy all of the qualities and enclosed definitions of the referenced definition, indicated
by the included name reference, into the newly formed definition.
to copy the qualities and enclosed definitions of the referenced
definition, indicated by the included name reference, into the newly
formed definition.
(This can be compared to the processing of the `$ref` keyword in {{-jso}}.)
The referenced definition should be such that, after copying and
applying the additional qualities in the referencing definition, the
newly built definition is also valid SDF (e.g., the copied qualities
and definitions are valid in the context of the new definition).

For example, this reference:

Expand Down

0 comments on commit f436f66

Please sign in to comment.