From f174bb0d28a5f8b6ca28e2e38930cba6e2e0d0ae Mon Sep 17 00:00:00 2001
From: David Kastrup <dak@gnu.org>
Date: Fri, 2 Mar 2012 16:12:55 +0100
Subject: [PATCH] Some manual documentation changes in the wake of allowing
 music in output defs

---
 Documentation/changes.tely         | 11 +++++++++++
 Documentation/notation/input.itely | 15 +++++----------
 2 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index b3fe430955..e57bbe7562 100644
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -61,6 +61,17 @@ which scares away people.
 
 @end ignore
 
+@item
+Use of @code{\tempo} specifications in @code{\midi} blocks (removed in
+2.9.16 in favor of explicit @code{tempoWholesPerMinute} settings) has
+seen a revival: now any kind of property-setting music is turned into
+context definitions within of output specifications, allowing for
+declarations like
+@example
+\layout @{ \accidentalStyle modern @}
+\midi @{ \tempo 4. = 66 @}
+@end example
+
 @item
 The LilyPond G clef has been redesigned - upper loop is now more balanced,
 bottom crook sticks out less and the "spine" (main vertical line) is more
diff --git a/Documentation/notation/input.itely b/Documentation/notation/input.itely
index 410ac25a9e..1b7a04bd03 100644
--- a/Documentation/notation/input.itely
+++ b/Documentation/notation/input.itely
@@ -2371,15 +2371,10 @@ indication to be printed:
 @end example
 
 In this example the tempo is set to 72 quarter note
-beats per minute.  This kind of tempo specification cannot take
-a dotted note length as an argument.  If one is required, break
-the dotted note into smaller units.  For example, a tempo of 90
-dotted quarter notes per minute can be specified as 270 eighth
-notes per minute:
-
-@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
-@end example
+beats per minute.  @code{\tempo} is actually a music command for
+setting properties during the interpretation of music: in the
+context of output definitions like a @code{\midi} block, as a matter of
+courtesy those are reinterpreted as if they were context modifications.
 
 @cindex MIDI context definitions
 
@@ -2626,9 +2621,9 @@ volume is limited to the range 0.2 - 0.5.
   >>
   \layout {}
   \midi {
+    \tempo 2 = 72
     \context {
       \Score
-      tempoWholesPerMinute = #(ly:make-moment 72 2)
       midiMinimumVolume = #0.2
       midiMaximumVolume = #0.5
     }
-- 
2.39.2