Hi Michael,
The possibility of having multiple clefs on a single staff at the beginning of a measure is described and supported by the "additional" property of the Clef element as follows:
"Sometimes clefs are added to the staff in non-standard line positions, either to indicate cue passages, or when there are multiple clefs present simultaneously on one staff. In this situation, the additional attribute is set to "yes" and the line value is ignored."
This description describes two different scenarios:
(1) a clef is added to the staff in a non-standard line position (only one clef present)
(2) there are multiple clefs present simultaneously on one staff
In case (1), if a single clef is present on a staff, but in a non-standard line position, I think that just specifying that non-standard line position with the "line" value should be sufficient to render it properly. This brings up two questions:
(a) Why is the "additional" attribute needed in this instance?
(b) If the "line" value is ignored, as is required, how can one possibly know where to render this clef on the staff vertically? The "line" value is the only way of specifying a non-standard line position.
In case (2), I can see that the "additional" attribute makes sense because you are defining an additional clef or clefs beyond the first one. However, my objection in (b) above still stands - if you force the "line" property to be ignored, how can this additional clef be placed in any non-standard position? If the first clef is drawn in the standard position, all of the "additional" clefs will have to be drawn on top of it.
My sense is that any "additional" clefs will really need to use the "line" attribute in order to be drawn properly. The only other interpretation is that you are expecting the first clef to be drawn in a non-standard position, and all "additional" clefs will be drawn in the standard position, on top of each other. But this is not what the documentation describes when it says "Sometimes clefs are added to the staff in non-standard line positions".
Could you please clarify the intent and usage of the "additional" attribute in the context of multiple clefs at the beginning of a measure? Could you also possible provide a MusicXML or PDF example of some music that does this, so one could have a visual example of this scenario and some MusicXML code that describes it?
--Evan