+% See: http://nicta.com.au/people/chubbp/articulate for additional
+
+% information about how the articulate function works.
+
+%%% Supported items:
+% Slurs and phrasing slurs.
+% Ornaments (i.e. mordents, trills, turns).
+% Rallentando, accelerando, ritard and 'a tempo'.
+%
+% Please refer to 'MIDI output' (Section 3.5) in the Notation Reference
+% Manual for a more detailed list of supported items.
+
+%%% Technical Details:
+% * Any note not under a slur or phrasing mark, and not marked with an
+% explicit articulation, is shortened by ac:normalFactor (default 7/8)
+% * Any note marked staccato is shortened by ac:staccatoFactor.
+% (default 1/2).
+% * Any note marked tenuto gets its full value.
+% * Appogiaturas are made to take half the value of the note following,
+% without taking dots into account (so in \appoggiatura c8 d2. the c
+% will take the time of a crotchet).
+% * Trills and turns are expanded. The algorithm tries to choose notes
+% within the time of the current tempo that lead to each twiddle being
+% around 1/8 seconds; this can be adjusted with the ac:maxTwiddleTime
+% variable.
+% * Rall, poco rall and a tempo are observed. It'd be fairly trivial to
+% make accel. and stringendo and so on work too.
+