metanorma-iec 2.5.2 → 2.5.3

Sign up to get free protection for your applications and to get access to all the features.
@@ -1,5 +1,5 @@
1
1
  <?xml version="1.0" encoding="UTF-8"?>
2
- <grammar xmlns="http://relaxng.org/ns/structure/1.0">
2
+ <grammar xmlns:a="http://relaxng.org/ns/compatibility/annotations/1.0" xmlns="http://relaxng.org/ns/structure/1.0">
3
3
  <!--
4
4
  Add-ons to biblio.rnc for standoc model: defines the extension point BibDataExtensionType
5
5
  of relaton
@@ -9,19 +9,23 @@
9
9
  -->
10
10
  <include href="biblio.rng">
11
11
  <define name="BibData">
12
+ <a:documentation>The bibliographic description of a standardisation document</a:documentation>
12
13
  <ref name="StandardBibliographicItem"/>
13
14
  <optional>
14
- <ref name="ext"/>
15
+ <ref name="ext">
16
+ <a:documentation>The extension point of the bibliographic description of a standardisation document</a:documentation>
17
+ </ref>
15
18
  </optional>
16
19
  </define>
17
20
  <define name="docrelation">
21
+ <a:documentation>Update to StandardReducedBibliographicItem</a:documentation>
18
22
  <element name="relation">
19
23
  <attribute name="type">
20
24
  <ref name="DocRelationType"/>
21
25
  </attribute>
22
26
  <optional>
23
27
  <element name="description">
24
- <ref name="FormattedString"/>
28
+ <ref name="LocalizedMarkedUpString"/>
25
29
  </element>
26
30
  </optional>
27
31
  <element name="bibitem">
@@ -47,34 +51,55 @@
47
51
  </define>
48
52
  </include>
49
53
  <define name="ext">
54
+ <a:documentation>The extension point of the bibliographic description of a standardisation document</a:documentation>
50
55
  <element name="ext">
51
56
  <ref name="BibDataExtensionType"/>
52
57
  </element>
53
58
  </define>
54
59
  <define name="BibDataExtensionType">
55
60
  <optional>
56
- <attribute name="schema-version"/>
61
+ <attribute name="schema-version">
62
+ <a:documentation>The version of the flavour-specific schema that this extension point conforms to</a:documentation>
63
+ </attribute>
57
64
  </optional>
58
- <ref name="doctype"/>
65
+ <ref name="doctype">
66
+ <a:documentation>Classification of the standardisation document that is treated as a distinct series by the
67
+ standards defining organization, and that is rendered in a distinct manner</a:documentation>
68
+ </ref>
59
69
  <optional>
60
- <ref name="docsubtype"/>
70
+ <ref name="docsubtype">
71
+ <a:documentation>Subclass of the standardisation document, that is treated or processed differently
72
+ from other documents in the same doctype</a:documentation>
73
+ </ref>
61
74
  </optional>
62
75
  <optional>
63
- <ref name="editorialgroup"/>
76
+ <ref name="editorialgroup">
77
+ <a:documentation>Groups associated with the production of the standards document, typically within
78
+ a standards definition organization</a:documentation>
79
+ </ref>
64
80
  </optional>
65
81
  <zeroOrMore>
66
- <ref name="ics"/>
82
+ <ref name="ics">
83
+ <a:documentation>Classification of the document contents taken from the International Classification of Standards</a:documentation>
84
+ </ref>
67
85
  </zeroOrMore>
68
86
  <zeroOrMore>
69
- <ref name="structuredidentifier"/>
87
+ <ref name="structuredidentifier">
88
+ <a:documentation>Representation of the identifier for the standardisation document, giving its individual semantic components</a:documentation>
89
+ </ref>
70
90
  </zeroOrMore>
71
91
  </define>
72
92
  <define name="doctype">
93
+ <a:documentation>Classification of the standardisation document</a:documentation>
73
94
  <element name="doctype">
74
95
  <optional>
75
- <attribute name="abbreviation"/>
96
+ <attribute name="abbreviation">
97
+ <a:documentation>Standard abbreviation for the doctype value used by the standards defining organization</a:documentation>
98
+ </attribute>
76
99
  </optional>
77
- <ref name="DocumentType"/>
100
+ <ref name="DocumentType">
101
+ <a:documentation>Name of the doctype</a:documentation>
102
+ </ref>
78
103
  </element>
79
104
  </define>
80
105
  <define name="DocumentType">
@@ -89,104 +114,142 @@
89
114
  <text/>
90
115
  </define>
91
116
  <define name="editorialgroup">
117
+ <a:documentation>A group associated with the production of the standards document, typically within
118
+ a standards definition organization</a:documentation>
92
119
  <element name="editorialgroup">
93
120
  <oneOrMore>
94
- <ref name="technical-committee"/>
121
+ <ref name="technical-committee">
122
+ <a:documentation>A technical committee associated with the production of the standards document</a:documentation>
123
+ </ref>
95
124
  </oneOrMore>
96
125
  </element>
97
126
  </define>
98
127
  <define name="technical-committee">
128
+ <a:documentation>Technical committee associated with the production of a standards document</a:documentation>
99
129
  <element name="technical-committee">
100
130
  <ref name="IsoWorkgroup"/>
101
131
  </element>
102
132
  </define>
103
133
  <define name="IsoWorkgroup">
104
134
  <optional>
105
- <attribute name="number"/>
135
+ <attribute name="number">
136
+ <a:documentation>Numeric identifier of the technical committee</a:documentation>
137
+ </attribute>
106
138
  </optional>
107
139
  <optional>
108
- <attribute name="type"/>
140
+ <attribute name="type">
141
+ <a:documentation>Type of the technical committee, used in identifying the technical committee</a:documentation>
142
+ </attribute>
109
143
  </optional>
110
144
  <optional>
111
- <attribute name="identifier"/>
145
+ <attribute name="identifier">
146
+ <a:documentation>Non-numeric, complete identifier of the technical committee</a:documentation>
147
+ </attribute>
112
148
  </optional>
113
149
  <optional>
114
- <attribute name="prefix"/>
150
+ <attribute name="prefix">
151
+ <a:documentation>Disambiguating prefix added to number to form the identifier of the technical committee,
152
+ typically indicating its type</a:documentation>
153
+ </attribute>
115
154
  </optional>
116
- <text/>
155
+ <text>
156
+ <a:documentation>Name of the technical committee</a:documentation>
157
+ </text>
117
158
  </define>
118
159
  <define name="ics">
160
+ <a:documentation>Classification taken from the International Classification of Standards.
161
+ ICS is defined by ISO here -- https://www.iso.org/publication/PUB100033.html</a:documentation>
119
162
  <element name="ics">
120
163
  <element name="code">
164
+ <a:documentation>Classification code taken from the ICS</a:documentation>
121
165
  <text/>
122
166
  </element>
123
167
  <optional>
124
168
  <element name="text">
169
+ <a:documentation>Text string associated with the classification code</a:documentation>
125
170
  <text/>
126
171
  </element>
127
172
  </optional>
128
173
  </element>
129
174
  </define>
130
175
  <define name="structuredidentifier">
176
+ <a:documentation>Representation of the identifier for a standardisation document, giving its individual semantic components</a:documentation>
131
177
  <element name="structuredidentifier">
132
178
  <optional>
133
- <attribute name="type"/>
179
+ <attribute name="type">
180
+ <a:documentation>Representation in the identifier of the type of standard document, corresponds to bibitem/ext/doctype</a:documentation>
181
+ </attribute>
134
182
  </optional>
135
183
  <oneOrMore>
136
184
  <element name="agency">
185
+ <a:documentation>Representation in the identifier of the agency responsible for the standard document</a:documentation>
137
186
  <text/>
138
187
  </element>
139
188
  </oneOrMore>
140
189
  <optional>
141
190
  <element name="class">
191
+ <a:documentation>Representation in the identifier of the class of standard document (as a subclass of the document type),
192
+ corresponds to bibitem/item/docsubtype</a:documentation>
142
193
  <text/>
143
194
  </element>
144
195
  </optional>
145
196
  <element name="docnumber">
197
+ <a:documentation>Representation in the identifier of the (typically numeric) component uniquely identifying the document
198
+ or standard. If a document includes parts or supplements, the docnumber identifies the document as whole,
199
+ and not those document components</a:documentation>
146
200
  <text/>
147
201
  </element>
148
202
  <optional>
149
203
  <element name="partnumber">
204
+ <a:documentation>Representation in the identifier of the document part, if this is a document part. May be compound</a:documentation>
150
205
  <text/>
151
206
  </element>
152
207
  </optional>
153
208
  <optional>
154
209
  <element name="edition">
210
+ <a:documentation>Representation in the identifier of the document edition, if this is a published document</a:documentation>
155
211
  <text/>
156
212
  </element>
157
213
  </optional>
158
214
  <optional>
159
215
  <element name="version">
216
+ <a:documentation>Representation in the identifier of the document version, which can include document drafts</a:documentation>
160
217
  <text/>
161
218
  </element>
162
219
  </optional>
163
220
  <optional>
164
221
  <element name="supplementtype">
222
+ <a:documentation>Representation in the identifier of the type of document supplement, if this is a document supplement</a:documentation>
165
223
  <text/>
166
224
  </element>
167
225
  </optional>
168
226
  <optional>
169
227
  <element name="supplementnumber">
228
+ <a:documentation>Representation in the identifier of the document supplement, if this is a document supplement</a:documentation>
170
229
  <text/>
171
230
  </element>
172
231
  </optional>
173
232
  <optional>
174
233
  <element name="amendment">
234
+ <a:documentation>Representation in the identifier of the document amendment, if this is a document amendment</a:documentation>
175
235
  <text/>
176
236
  </element>
177
237
  </optional>
178
238
  <optional>
179
239
  <element name="corrigendum">
240
+ <a:documentation>Representation in the identifier of the document corrigendum, if this is a document corrigendum</a:documentation>
180
241
  <text/>
181
242
  </element>
182
243
  </optional>
183
244
  <optional>
184
245
  <element name="language">
246
+ <a:documentation>Representation in the identifier of the language of the document</a:documentation>
185
247
  <text/>
186
248
  </element>
187
249
  </optional>
188
250
  <optional>
189
251
  <element name="year">
252
+ <a:documentation>Representation in the identifier of the year of publication or issuance of the document</a:documentation>
190
253
  <text/>
191
254
  </element>
192
255
  </optional>
@@ -195,13 +258,17 @@
195
258
  <define name="StandardBibliographicItem">
196
259
  <ref name="BibliographicItem"/>
197
260
  <zeroOrMore>
198
- <ref name="amend"/>
261
+ <ref name="amend">
262
+ <a:documentation>Description of changes specific to this document</a:documentation>
263
+ </ref>
199
264
  </zeroOrMore>
200
265
  </define>
201
266
  <define name="StandardReducedBibliographicItem">
202
267
  <ref name="ReducedBibliographicItem"/>
203
268
  <zeroOrMore>
204
- <ref name="amend"/>
269
+ <ref name="amend">
270
+ <a:documentation>Description of changes specific to this document</a:documentation>
271
+ </ref>
205
272
  </zeroOrMore>
206
273
  </define>
207
274
  </grammar>