From: Graham Percival <graham@percival-music.ca>
Date: Sat, 29 Sep 2007 02:47:08 +0000 (-0700)
Subject: Add vocals to Fundamental.
X-Git-Tag: release/2.11.35-1~46^2~116
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=227b1e40ff1cc764b53b862a4e8c584a66a5f439;p=lilypond.git

Add vocals to Fundamental.
---

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