|
757 | 757 | </t>
|
758 | 758 | <t>
|
759 | 759 | <xref target="annotations">Annotation</xref> results are
|
760 |
| - combined according to the rules specified by each annotation keyword. |
| 760 | + preserved along with the instance location and the location of |
| 761 | + the schema keyword, so that applications can decide how to |
| 762 | + interpret multiple values. |
761 | 763 | </t>
|
762 | 764 | <section title="Referenced and Referencing Schemas" anchor="referenced">
|
763 | 765 | <t>
|
|
852 | 854 | <t>
|
853 | 855 | Annotations are attached to specific locations in an instance.
|
854 | 856 | Since many subschemas can be applied to any single
|
855 |
| - location, annotation keywords need to specify any unusual handling of |
856 |
| - multiple applicable occurrences of the keyword with different values. |
| 857 | + location, applications may need to decide how to handle differing |
| 858 | + annotation values being attached to the same instance location by |
| 859 | + the same schema keyword in different schema objects. |
857 | 860 | </t>
|
858 | 861 | <t>
|
859 | 862 | Unlike assertion results, annotation data can take a wide variety of forms,
|
|
906 | 909 | </t>
|
907 | 910 | </list>
|
908 | 911 | </t>
|
909 |
| - <t> |
910 |
| - If the same keyword attaches values from multiple schema locations |
911 |
| - to the same instance location, and the annotation defines a process |
912 |
| - for combining such values, then the combined value MUST also be associated |
913 |
| - with the instance location. The <xref target="output">output formats</xref> |
914 |
| - described in this specification that include annotation information |
915 |
| - meet this requirement. |
916 |
| - </t> |
917 | 912 | <section title="Distinguishing Among Multiple Values">
|
918 | 913 | <t>
|
919 | 914 | Applications MAY make decisions on which of multiple annotation values
|
|
973 | 968 | <t>
|
974 | 969 | In this example, both Feature A and Feature B make use of the re-usable
|
975 | 970 | "enabledToggle" schema. That schema uses the "title", "description",
|
976 |
| - and "default" annotations, none of which define special behavior for |
977 |
| - handling multiple values. Therefore the application has to decide how |
| 971 | + and "default" annotations. Therefore the application has to decide how |
978 | 972 | to handle the additional "default" value for Feature A, and the additional
|
979 | 973 | "description" value for Feature B.
|
980 | 974 | </t>
|
|
1048 | 1042 | <t>
|
1049 | 1043 | In addition to possibly defining annotation results of their own,
|
1050 | 1044 | applicator keywords aggregate the annotations collected in their
|
1051 |
| - subschema(s) or referenced schema(s). The rules for aggregating |
1052 |
| - annotation values are defined by each annotation keyword, and are |
1053 |
| - not directly affected by the logic used for combining assertion |
1054 |
| - results. |
| 1045 | + subschema(s) or referenced schema(s). |
1055 | 1046 | </t>
|
1056 | 1047 | </section>
|
1057 | 1048 | </section>
|
|
0 commit comments