* tex/GNUmakefile (TEX_FILES): add texinfo.cnf

[lilypond.git] / Documentation / user / sound-output.itexi

diff --git a/Documentation/user/sound-output.itexi b/Documentation/user/sound-output.itexi
index bfd162f00d5b48bd91874765b10eea3ea40b3d72..cd219f33b840e89cd983d140df66f479f50b3e15 100644 (file)
--- a/Documentation/user/sound-output.itexi
+++ b/Documentation/user/sound-output.itexi
@@ -1,29 +1,33 @@
-@c -*-texinfo-*-
+@c -*- coding: latin-1; mode: texinfo; -*-
 @node Sound
 @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,35 +42,32 @@ 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.
 
 
 If there is a @code{\midi} command in a @code{\score}, only MIDI will
-be produced.  When notation is needed too, a @code{\paper} block must
+be produced.  When notation is needed too, a @code{\layout} block must
 be added
 
 @example 
 \score @{
-    @var{...music...}
-    \midi @{ \tempo 4=72 @}
-    \paper @{ @}
+  @var{...music...}
+  \midi @{ \tempo 4=72 @}
+  \layout @{ @}
 @}
 @end example 
-@cindex paper block
+@cindex layout block
 
 
 
@@ -87,7 +88,7 @@ setting @code{instrumentEqualizer}.
 @cindex MIDI block
 
 
-The MIDI block is analogous to the paper block, but it is somewhat
+The MIDI block is analogous to the layout block, but it is somewhat
 simpler.  The @code{\midi} block can contain
 @cindex MIDI block
 
@@ -108,7 +109,7 @@ inserted, for example
 @cindex context definition
 
 Context definitions follow precisely the same syntax as within the
-\paper block.  Translation modules for sound are called performers.
+\layout block.  Translation modules for sound are called performers.
 The contexts for MIDI output are defined in @file{ly/performer-init.ly}.
 
 
@@ -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.