126: Clarify key-octave documentation regarding the cancel attribute

w3c · Sep 6, 2016 · 30e930f · 30e930f
1 parent 8b51a86
commit 30e930f
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 3 deletions.
diff --git a/schema/attributes.mod b/schema/attributes.mod
@@ -112,8 +112,11 @@
 	values as the display-octave element. The number attribute
 	is a positive integer that refers to the key signature
 	element in left-to-right order. If the cancel attribute is
-	set to yes, then this number refers to an element specified
-	by the cancel element. It is no by default.
+	set to yes, then this number refers to the canceling key
+	signature specified by the cancel element in the parent key
+	element. The cancel attribute cannot be set to yes if there is
+	no corresponding cancel element within the parent key element.
+	It is no by default.
 
 	Key signatures appear at the start of each system unless
 	the print-object attribute has been set to "no".

diff --git a/schema/musicxml.xsd b/schema/musicxml.xsd
@@ -2499,7 +2499,7 @@ Clefs appear at the start of each system unless the print-object attribute has b
 
 	<xs:complexType name="key-octave">
 		<xs:annotation>
-			<xs:documentation>The key-octave element specifies in which octave an element of a key signature appears. The content specifies the octave value using the same values as the display-octave element. The number attribute is a positive integer that refers to the key signature element in left-to-right order. If the cancel attribute is set to yes, then this number refers to an element specified by the cancel element. It is no by default.</xs:documentation>
+			<xs:documentation>The key-octave element specifies in which octave an element of a key signature appears. The content specifies the octave value using the same values as the display-octave element. The number attribute is a positive integer that refers to the key signature element in left-to-right order. If the cancel attribute is set to yes, then this number refers to the canceling key signature specified by the cancel element in the parent key element. The cancel attribute cannot be set to yes if there is no corresponding cancel element within the parent key element. It is no by default.</xs:documentation>
 		</xs:annotation>
 		<xs:simpleContent>
 			<xs:extension base="octave">