release: 0.1.11

[lilypond.git] / Documentation / mudela-course.doc

diff --git a/Documentation/mudela-course.doc b/Documentation/mudela-course.doc
index 23fc00cb4ec18b92fad69b7ca657ece0c3165393..da2be2526b09129be4f479ce5e1356c0aed2ed2e 100644 (file)
--- a/Documentation/mudela-course.doc
+++ b/Documentation/mudela-course.doc
@@ -1,4 +1,8 @@
 % -*-LaTeX-*-
+% this document should be run through the mudela-book script after lilypond
+% has been installed.
+
+
 \documentclass{article}
 \usepackage{a4wide}
 \title{Mudela and LilyPond crash course}
@@ -10,10 +14,14 @@
 \def\preexample{\par\medskip}
 \def\postexample{\par\medskip}
 
+\emph{This document is not complete yet. It's just a brief blurb which
+  skimps some features of Mudela}
+
 
 \section{Overview}
+
 Mudela is a language for specifying music. LilyPond is a
-program which converts such a specification into formatted  sheet
+program which converts such a specification into formatted sheet
 music, or MIDI output.
 
 Please note that some examples not only demonstrate features but also
@@ -33,10 +41,11 @@ chords by \verb+<+ and \verb+>+.
 
 \begin[verbatim]{mudela}
 \score {
-        \melodic {      % { means voice
-        c'4 g'4         % 4 means quaver, 1 beat in 4/4 meter
+        \melodic {      % {...} is a voice
+        c'4 g'4         % c and g are pitches, 4 is the duration
+                        % (crotchet/quarter note)
         c''4 ''c4       % c' is 1 octave up, 'c 1 down.
-        <c'4 g'4>       % <> means a chord
+        <c'4 g'4>       % <...> is a chord
         }
 } 
 \end{mudela}
@@ -92,12 +101,13 @@ etc.
 \end{mudela}
 
 
-LilyPond is designed to handle complicated stuff
-automatically. Expertise should be in the program, not in the user.
+LilyPond is designed to handle complicated stuff automatically.
+Expertise should be in the program, not in the user.
 
-The following example shows how multiple voice  on the same staff are
+The following example shows how multiple voices on the same staff are
 handled graciously (well, somewhat). If the noteheads of different
-voices collide, they are moved horizontally. The same goes for the rests. 
+voices collide, they are moved horizontally. Rests are moved
+vertically.
 
 \begin[verbatim]{mudela}
 two_voice = \melodic