From 9d3d0da2b807292d603d300b0c04a462bfe2b54d Mon Sep 17 00:00:00 2001
From: gpercival <gpercival>
Date: Sun, 26 Sep 2004 19:48:15 +0000
Subject: [PATCH] More editing.

---
 ChangeLog                             |  2 ++
 Documentation/user/sound-output.itexi | 49 +++++++++++++--------------
 2 files changed, 26 insertions(+), 25 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 783b4bd035..a834d0a1ba 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -9,6 +9,8 @@
 
 	* input/template/piano-dynamics.ly: remove.
 
+	* Documentation/user/sound-output.itexi: more editing
+
 2004-09-25  Graham Percival  <gperlist@shaw.ca>
 
 	* Documentation/user/notation.itely: more editing.
diff --git a/Documentation/user/sound-output.itexi b/Documentation/user/sound-output.itexi
index bfd162f00d..e7d4220213 100644
--- a/Documentation/user/sound-output.itexi
+++ b/Documentation/user/sound-output.itexi
@@ -3,27 +3,31 @@
 @chapter Sound
 @cindex Sound
 
+@cindex MIDI
+
 MIDI (Musical Instrument Digital Interface) is a standard for
-connecting and controlling digital instruments.  A MIDI file is like a
-tape recording of a MIDI instrument.
+connecting and controlling digital instruments.  A MIDI file is a
+series of notes in a number of tracks.  It is not an actual
+sound file; you need special software to translate between the
+series of notes and actual sounds.
 
-Pieces of music can be converted to a MIDI file, so you can listen to
-what was entered.  This is convenient for checking the music.  Octaves
+Pieces of music can be converted to MIDI files, so you can listen to
+what was entered.  This is convenient for checking the music; octaves
 that are off or accidentals that were mistyped stand out very much
-when listening to the musical transcription.
+when listening to the MIDI output.
 
 @refbugs
 
-many musically interesting effects, such as swing, articulation,
+Many musically interesting effects, such as swing, articulation,
 slurring, etc., are not translated to midi.
 
-the midi output allocates a channel for each staff, and one for global
-settings.  hence, the midi file should not have more than 15 staves
-(or 14 if you do not use drums). other staves will remain silent.
+The midi output allocates a channel for each staff, and one for global
+settings.  Therefore the midi file should not have more than 15 staves
+(or 14 if you do not use drums).  Other staves will remain silent.
 
-not all midi players correctly handle tempo change in the midi
-output. players that are known to work include
-@uref{http://timidity.sourceforge.net/,timidity}
+Not all midi players correctly handle tempo change in the midi
+output.  Players that are known to work include
+@uref{http://timidity.sourceforge.net/,timidity}.
 
 
 
@@ -38,20 +42,17 @@ output. players that are known to work include
 @node Creating MIDI files
 @section Creating MIDI files 
 
-@cindex sound
-@cindex midi
-
 To create a MIDI from a music piece of music, add a @code{\midi} block
 to a score, for example,
 
 @example 
 \score @{
-    @var{...music...}
-    \midi @{ \tempo 4=72 @}
+  @var{...music...}
+  \midi @{ \tempo 4=72 @}
 @}
 @end example 
 
-Here, the tempo is specified using the @code{\tempo} command.  In this
+The tempo is specified using the @code{\tempo} command.  In this
 case the tempo of quarter notes is set to 72 beats per minute.
 
 
@@ -61,9 +62,9 @@ be added
 
 @example 
 \score @{
-    @var{...music...}
-    \midi @{ \tempo 4=72 @}
-    \paper @{ @}
+  @var{...music...}
+  \midi @{ \tempo 4=72 @}
+  \paper @{ @}
 @}
 @end example 
 @cindex paper block
@@ -122,8 +123,6 @@ The MIDI instrument name is set by the @code{Staff.midiInstrument}
 property.  The instrument name should be chosen from the list in
 @ref{MIDI instruments}.
 
-@refbugs
-
-If the selected string does not exactly match, the default is used,
-which is the Grand Piano.
+If the selected instrument does not exactly match an instrument from
+the list of MIDI instruments, the Grand Piano instrument is used.
 
-- 
2.39.5