MIDI: default midiChannelMapping to 'staff

[lilypond.git] / Documentation / changes.tely

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index a45b36c4586d35ddab646b225eb6904c426fc02e..150f603288bb62405b0483b8ab8de1be7e12d643 100644 (file)
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -62,7 +62,39 @@ which scares away people.
 @end ignore
 
 @item
-Lilypond typesets woodwind fingering charts.
+Lilypond now helps beams avoid collisions with other grobs!  This feature
+works completely with manual beams.  It also works for all automatic beams
+that do not end right before a change in staff.  For this special case, please
+use manual beams.
+
+@item
+The Articulate script by Peter Chubb, which is GPLv3 licensed, is now
+a part of the distribution.  It allows easy generation of improved
+MIDI files that perform non-legato by default, legato slurs, staccato,
+tempo markings, trills, etc.
+
+@example
+\include "articulate.ly"
+\articulate <<
+      all the rest of the score...
+>>
+@end example
+
+@item
+Single beat repeats for sixteenth or shorter notes and beat repeats for
+measures containing notes of varying durations are now supported.
+
+@lilypond[fragment,relative=2]
+\repeat percent 2 { c16 d }
+\repeat percent 2 { c32 e }
+\repeat percent 2 { c64 f }
+\repeat percent 2 { c128 g' }
+@end lilypond
+
+
+@item
+Lilypond now engraves woodwind fingering charts.
+
 @lilypond
 \relative c' {
   \textLengthOn
@@ -83,9 +115,10 @@ Lilypond typesets woodwind fingering charts.
 @item
 MIDI output has been improved
 @itemize @bullet
-@item voices are kept separated, which makes the MIDI much more useful for postprocessing
-@item optimal channel distribution: identical instruments share the same channel.  This means that e.g. for a full orchestral score there are always 16 (15 plus percussion) diffently sounding instruments available, unrestricted by the number of staves or voices.
-@item dynamics are now rendered as note velocities, no longer as midi dynamics.  This improves the sound on [high end] midi renderers.
+@item the option @code{\set Score.midiChannelMapping = #'voice} puts each voice on its own midi MIDI channel
+@item the option @code{\set Score.midiChannelMapping = #'instrument} puts identical instruments on the same MIDI channel.  This means that e.g. for a full orchestral score there are always 16 (15 plus percussion) differently sounding instruments available, unrestricted by the number of staves or voices.  (Some MIDI players will cut off notes, however, if two voices play the same pitch simultaneously on the same channel.) This option also stores each voice in a separate track in the MIDI file.
+@item the default, @code{\set Score.midiChannelMapping = #'staff}, assigns one MIDI channel per staff.  This setting allows instrument changes (implemented as MIDI program changes) to re-use single MIDI channel.
+@item dynamics are now rendered as note velocities, no longer as midi volume.  This improves the sound on [high end] midi renderers.
 @end itemize
 
 @item
@@ -174,10 +207,11 @@ motif = \relative c'' { d8 c f,4 <a f'> <a f'> }
 @end lilypond
 
 @item
-Black mensural notation has minimal support.
+Added minimal support for black mensural notation.
 
 @item
-Support for obliqua shapes within white mensural ligatures enhanced.
+Enhanced support for obliqua shapes within white mensural ligatures.
+
 @lilypond
 \context MensuralStaff
 {
@@ -201,9 +235,16 @@ Support for obliqua shapes within white mensural ligatures enhanced.
 }
 @end lilypond
 
+@item
+New markup functions @code{\with-link} and @code{\page-link} that add
+hyperlinks to a given label or a given page number. This works in the PDF
+backend only. All entries to the table of contents now automatically add
+hyperlinks to the pages they are referring to.
+
 @item
 Compound time signatures are now supported by the @code{\compoundMeter} command,
 which can be used instead of @code{\time}:
+
 @lilypond
 \relative c'' {
   \compoundMeter #'(3 1 8)
@@ -236,6 +277,7 @@ By using @code{\cueDuringWithClef}, cue notes can now also have their own
 clef, which is correctly reset at the end of the cue notes.  At the begin
 of each line, the standard clef is still displayed, but the cue clef is
 shown after the time/key signature in smaller size.
+
 @lilypond
 vI = \relative c'' { \clef "treble" \repeat unfold 40 g4 }
 \addQuote vIQuote { \vI }
@@ -280,6 +322,7 @@ based on user input.
 
 @item
 The part-combiner's decision to combine/not combine notes can now be customized
+
 @lilypond[quote,relative=2]
 \partcombine
 \relative c' { c2 \partcombineApart c | \partcombineChordsOnce e' e }