This element represents a single stop, possibly comprised of more than one rank. In "straight" classical specifications the Stop element also represents the rank(s) of pipes controlled by the stop. For theatre organs and other unit organs, the Rank element should be used to represent the ranks of pipes, and the "rank" attribute of the Stop element should be used to link the stop to the rank.

The Rank element contains a subset of the attributes of the Stop element. When a Stop element is linked to a Rank element, it is not necessary to duplicate in the Stop element information that is provided in the Rank element.

Chamber
Division	Stop elements are normally contained in a Division or Keyboard.
Keyboard	Stop elements are normally contained in a Keyboard or Division.

Name	How Many	Description
Borrowed	(zero or more)	Use this child element for borrowing part of a stop. For borrowing an entire stop, use the "Borrowed" attribute instead.
Composition	(zero or more)	for mixtures.
Pressure	(zero or more)	the wind pressure for this stop, if different from the enclosing element.
Remark	(zero or more)	remarks about this stop.
Scale	(zero or more)	scaling information.

borrowed

The ID of the Stop element representing the stop from which this stop is borrowed. This attribute should be used for stops which are borrowed in their entirety; for partial borrowed, the "Borrowed" element should be used instead.

compass

The compass of the stop. The value of this attribute must conform to the standard for Compasses. The values "L" or "R" may be used to indicate that the stop plays only on the left or right side of a divided keyboard. If this attribute is omitted, the stop is assumed to be full compass.

control

The type of physical control for this stop, e.g. "rocking tablet", "drawknob". This can also be specified in the "stops" 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 stop was installed (see date formats). This attribute should only be used for stops added after the original instrument was finished.

dateRemoved

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

doubleDraw

A double-draw stop is one which is controlled by a drawknob where pulling the drawknob out halfway turns on one rank, and pulling it out the rest of the way turns on an additional rank. Such stops should be described by two separate Stop elements. The Stop for the second draw position should include this attribute, which is the ID of the Stop for the first draw position.

extension

The ID of the Stop element representing the stop of which this stop is an extension.

id

An identifier for referencing this element from within other elements, such as for borrowed or extended stops.

installedBy

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

label

The name of the stop exactly as it appears on the console, e.g. "Fl. Oct. Harm. 4'".

maker

The ID of the Builder element describing the builder (pipemaker) who made the stop. This attribute should only be used if the maker is different from the installer.

material

The material from which the stop is made, e.g. "metal", "wood", "oak", "zinc", "copper", etc. For electronic stops, the value of this attribute must be "electronic".

name   (required)

The full, unabbreviated name of the stop, e.g. "Flute Octaviante Harmonique". Always use the original language, and do not anglicize; e.g. do not translate "Trompette" into "Trumpet".

order

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

pipes

An integer representing the number of pipes (or other sound-producing elements such as bars or bells) in the stop. For borrowed stops, if this attribute appears, its value must be "0". For extension stops, if this attribute appears, it must represent the number of pipes in addition to the number of pipes in the stop it was extended from.

prepared

The value of this attribute must be "true" or "false". A value of "true" indicates that the stop has been "prepared for", and does not speak. If the value is "false" or the attribute is missing, then the stop is not "prepared for".

pitch

A number representing the pitch of the stop, possibly including a fraction. The fractional portion must be separated from the whole-number portion with a hyphen. If there are multiple pitches, they must be separated with commas. Examples: "32", "3-1/5", "1/2", "2-2/3,1-3/5".

rank

The ID of the Rank element representing the rank from which this stop is derived. This is intended only for unit organs such as theatre organs.

ranks

An integer representing the number of ranks for the stop. For mixtures with variable numbers of ranks, two integers may be given separated by a hyphen.

removedBy

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

type

The type of stop, one of: "flue", "reed", "diaphone", "percussion", or "other". While not required, the use of this attribute is strongly encouraged, as there are many stop names which are used for both flues and reeds.

<Stop name="Open Diapason" pitch="8" pipes="61" material="metal"> </Stop>
<Stop name="Salicional" pitch="8" id="SAL8"> </Stop>
<Stop name="Voix Celeste" pitch="8" pipes="49" compass="C-c'''"> </Stop>
<Stop name="Flute Octaviante Harmonique" pitch="4" label="Fl. Oct. Harm. 4'"> </Stop>
<Stop name="Salicet" pitch="4" extension="SAL8" pipes="12"> </Stop>
<Stop name="Quint" pitch="2-2/3" id="QUINT"> </Stop>
<Stop name="Tierce" pitch="1-3/5" doubleDraw="QUINT"> </Stop>
<Stop name="Mixture" ranks="3"> </Stop>
<Stop name="Fourniture" ranks="3-5"> </Stop>

<!ELEMENT Stop (
	Borrowed |
	Composition |
	Pressure |
	Remark | 
	Scale )* >  
<!ATTLIST Stop
	borrowed IDREF #IMPLIED
	compass CDATA ""
	control CDATA ""
	dateInstalled CDATA ""
	dateRemoved CDATA ""
	doubleDraw IDREF #IMPLIED
	extension IDREF #IMPLIED
	id ID #IMPLIED
	installedBy IDREF #IMPLIED
	label CDATA ""
	maker IDREF #IMPLIED
	material CDATA ""
	name CDATA #REQUIRED
	order CDATA ""
	pipes CDATA ""
	pitch CDATA ""
	prepared (true|false) "false"
	rank IDREF #IMPLIED
	ranks CDATA ""
	removedBy IDREF #IMPLIED
	type (flue|reed|diaphone|percussion|other) #IMPLIED
	>