From 227b1e40ff1cc764b53b862a4e8c584a66a5f439 Mon Sep 17 00:00:00 2001
From: Graham Percival <graham@percival-music.ca>
Date: Fri, 28 Sep 2007 19:47:08 -0700
Subject: [PATCH] Add vocals to Fundamental.

---
 Documentation/user/fundamental.itely | 36 ++++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/Documentation/user/fundamental.itely b/Documentation/user/fundamental.itely
index 26063fbeef..6860b82e73 100644
--- a/Documentation/user/fundamental.itely
+++ b/Documentation/user/fundamental.itely
@@ -8,6 +8,7 @@
 * How LilyPond files work::     
 * Score is a single musical expression::  
 * I'm seeing Voices::           
+* Voices and vocals::           
 * On the un-nestedness of brackets and ties::  
 @end menu
 
@@ -269,8 +270,12 @@ on the same horizontal position in your text editor.
 
 @cindex polyphony
 
-@c TODO: sex this up with colors and stuff.  -gp 
-@c TODO: actually, a general rewrite is needed.  -gp
+TODO: add intro about voices vs. layers vs. whatever.
+
+TODO: sex this up with colors and stuff.  -gp 
+
+TODO: actually, a general rewrite is needed.  -gp
+
 
 The easiest way to enter fragments with more than one voice on a
 staff is to enter each voice as a sequence (with @code{@{...@}}),
@@ -348,6 +353,33 @@ the note immediately preceding it.
 @code{noteA}.
 
 
+@node Voices and vocals
+@section Voices and vocals
+
+Vocal music presents a special difficulty: we need to combine two
+expressions -- notes and lyrics.
+
+You have already seen the @code{\lyricsAdd@{@}} command, which
+handles simple cases for you.  However, @code{\lyricsAdd@{@}} is
+very limited.  For most music, you must explicitly link the lyrics
+to the notes with @code{\lyricsTo@{@}}
+
+@lilypond[quote,verbatim,fragment]
+<<
+  \new Voice = "one" \relative c'' {
+    \autoBeamOff
+    \time 2/4
+    c4 b8. a16 g4. f8 e4 d c2
+  }
+  \new Lyrics \lyricsto "one" {
+    No more let sins and sor -- rows grow.
+  }
+>>
+@end lilypond
+
+TODO: get some vocal person to write more.
+
+
 @c my name start sucking the more docs I write. -gp
 @node On the un-nestedness of brackets and ties
 @section On the un-nestedness of brackets and ties
-- 
2.39.5