Re: lilypond tool and MidiInput

[Peter Chubb]

>>>>> "Graham" == Graham Percival <address@hidden> writes:

Graham> On Mon, Feb 15, 2010 at 12:37 AM, Peter Chubb
Graham> <address@hidden> wrote:
>>>>>>> "Trevor" == Trevor Daniels <address@hidden> writes:
>> 
Trevor> Peter's original announcement, with articulate.ly and some
Trevor> instructions for its use is at
Trevor> http://lists.gnu.org/archive/html/lilypond-user/2008-08/msg00108.html

Graham> Yes, so it would be nice if somebody could send a "small
Graham> documentation suggestion" according to...

Graham> huh.  lilypond.org seems to be down at the moment, so I'll
Graham> just describe it: on the new webpage, click on Community, then
Graham> Development, then "documentation suggestions".

Here's a patch.  Feel free to edit for style :-)

Signed-off-by: Peter Chubb <address@hidden>

---
 Documentation/usage/external.itely |   20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

Index: lilypond/Documentation/usage/external.itely
===================================================================
--- lilypond.orig/Documentation/usage/external.itely    2010-02-17 
12:44:00.551158469 +1100
+++ lilypond/Documentation/usage/external.itely 2010-02-17 13:13:15.338160699 
+1100
@@ -592,6 +592,24 @@
 @node MIDI articulation
 @subsection MIDI articulation
 
-TODO stub for info about Dr. Peter Chubb's @file{articulate.ly}
+LilyPond can be used to produce MIDI output, for `proof-hearing' what
+has been written.  However, only dynamics, explicit tempo markings,
+and the notes and durations themselves are produced in the output.
+
+At
address@hidden://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
+is one attempt to get more of the information in the score into the
+MIDI.  It works by shortening notes not under slurs, to `articulate'
+the notes.  The amount of shortening depends on any
+articulation markings attached to a note: staccato halves the note
+value, tenuto gives a note its full duration, and so on.
+
+The script also realises trills and turns, and could be extended to
+expand other ornaments such as mordents.
+
+Its main limitation is that it can only affect things it knows about:
+anything that is merely textual markup (instead of a note property) is
+still ignored.
+