This element represents a single coupler. A coupler couples a Keyboard or Division to a Keyboard.

Console	When a coupler control is physically located separately from the stops for the same division, the Coupler element should be contained within the Console element.
Division	When a coupler control is physically located with the stops for the same division, the Coupler element should be contained within the corresponding Division element.
Keyboard	When a coupler control is physically located with the stops for the same division (the "to" division), the Coupler element should be contained within the corresponding Keyboard element.
Organ	A Coupler element may be contained within an Organ element, if the Console element has been omitted for simplicity.

Name	How Many	Description
Remark	(zero or more)	remarks about this Coupler.

control

The type of physical control for this coupler, e.g. "rocking tablet", "foot lever", "shove". This can also be specified in the "couplers" attribute of the Console element; if both are specified, then this attribute supercedes the one in the Console element.

dateInstalled

The date on which this Coupler was installed (see date formats). This attribute should only be used for Couplers added after the original instrument was finished.

dateRemoved

The date on which this Coupler was removed (see date formats).

from  

The ID of the Division or Keyboard element representing the "from" division or keyboard. At least one of the "from" and "fromSpecial" attributes must be specified.

fromSpecial  

For couplers which are not simple division-to-division couplers, this is a short phrase describing the "from" division. For example: "MIDI", "Swell Reeds", "Enclosed Great", etc. At least one of the "from" and "fromSpecial" attributes must be specified.

id

An identifier for referencing this element from within other elements.

installedBy

The ID of the Builder element describing the builder who installed the Coupler. This attribute should only be used for Couplers added after the original instrument was finished.

label

The name of the coupler as it actually appears on the console, e.g. "Sw-Gt".

order

An integer which will be used to order the couplers for display purposes. This order should correspond with the order in which the couplers appear on the console. The numbers need not be contiguous.

pitch

The pitch (in feet) of the coupler, e.g. "8" for unison, "4" for octave, "16" for sub-octave.

removedBy

The ID of the Builder element describing the builder who removed the Coupler.

to

The ID of the Division or Keyboard element representing the "to" division or keyboard. This attribute is optional if the Coupler element is embedded within a Keyboard element, in which case the implied "to" division is the parent division.

type

Specifies the type of coupler. The value of this attribute must be one of the following values; if this attribute is not specified, the default is "normal".

"normal"	a normal inter- or intra-division coupler.
"off"	a coupler which shuts off when it is activated, for example "Unison Off".
"other"	indicates a coupler which is not one of the other types.
"unknown"	indicates that the type is unknown.

In the following example, the intra-manual couplers are located with the stops for each division, while the inter-manual couplers are located separatedly.

<Console>
    <Keyboard name="Swell" id="SW">
        <Stop name="Salicional" pitch="8"> </Stop>
        <Stop name="Voix Celeste" pitch="8"> </Stop>
        <Coupler from="SW" pitch="4" label="Swell 4'" control="drawknob"> </Coupler>
	</Keyboard>
    <Keyboard name="Great" id="GT">
        <Stop name="Open Diapason" pitch="8"> </Stop>
        <Stop name="Octave" pitch="4"> </Stop>
        <Coupler from="GT" pitch="4" label="Great 4'" control="drawknob"> </Coupler>
	</Keyboard>
    <Keyboard name="Pedal" id="PED">
        <Stop name="Bourdon" pitch="16"> </Stop>
	</Keyboard>
    <Coupler from="SW" to="GT" pitch="16" label="Swell to Great 16'" control="rocker"> </Coupler>
    <Coupler from="SW" to="GT" pitch="8" label="Swell to Great 8'" control="rocker"> </Coupler>
    <Coupler from="SW" to="GT" pitch="4" label="Swell to Great 4'" control="rocker"> </Coupler>
    <Coupler from="SW" to="PED" pitch="8" label="Swell to Pedal 8'" control="rocker"> </Coupler>
    <Coupler from="GT" to="PED" pitch="8" label="Great to Pedal 8'" control="rocker"> </Coupler>
</Console>

<!ELEMENT Coupler (
	Remark
	)* >
<!ATTLIST Coupler
	control CDATA ""
	dateInstalled CDATA ""
	dateRemoved CDATA ""
	from IDREF #REQUIRED
	fromSpecial CDATA ""
	id ID #IMPLIED
	installedBy IDREF #IMPLIED
	label CDATA ""
	order CDATA ""
	pitch CDATA "8"
	removedBy IDREF #IMPLIED
	to IDREF #IMPLIED
	type (normal|off|other|unknown) #IMPLIED
	>