]> git.donarmstrong.com Git - lilypond.git/commitdiff
updates
authorHan-Wen Nienhuys <hanwen@xs4all.nl>
Thu, 15 May 2003 15:15:01 +0000 (15:15 +0000)
committerHan-Wen Nienhuys <hanwen@xs4all.nl>
Thu, 15 May 2003 15:15:01 +0000 (15:15 +0000)
ChangeLog
Documentation/user/cheatsheet.itely
Documentation/user/refman.itely
Documentation/user/tutorial.itely
lily/hyphen-spanner.cc
lily/lyric-extender.cc

index 63f58b625cf3950aff4957363606749869202207..d787b9e92d500fbec91ee539f0fb2c4e1fe5e0e3 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2003-05-15  Han-Wen Nienhuys  <hanwen@cs.uu.nl>
+
+       * Documentation/user/tutorial.itely: updates
+
 2003-05-15  Heikki Junes  <hjunes@cc.hut.fi>
 
        * lilypond-mode.el: Allow Midi on buffer.
index c8cdb16f03564459f0adef2148bca690d0824e31..54e5c5a02ce184d8fec27ab2ca3b635395e00938 100644 (file)
@@ -200,5 +200,52 @@ a-\> a a-\!
 <<c e>> 
 @end lilypond
 
+
+@item @code{\partial 8}
+@tab upstep
+@tab
+@lilypond[fragment]
+  \partial 8
+  f8 c2 d e
+@end lilypond 
+
+
+@item @code{\times 2/3}
+@tab triplets
+@tab
+@lilypond[relative 1,verbatim,fragment]
+  \times 2/3 { f8 g a }
+@end lilypond
+
+@item @code{\lyrics @{ @dots{} @}}
+@tab entering lyrics
+@tab
+
+@item @code{\context Lyrics}
+@tab printing lyrics
+@tab
+
+@item @code{twin -- kle}
+@tab lyric hyphen 
+@tab
+@lilypond[fragment,relative 1]
+\addlyrics \notes { g'4 g }
+  \context Lyrics \lyrics {  twin -- kle }
+@end lilypond 
+
+@item @code{\chords @{ c:dim f:maj7 @}}
+@tab chords 
+@tab
+@lilypond[fragment,relative 1]
+  \chords { c:dim f:maj7 }
+@end lilypond 
+
+@item @code{\context ChordNames}
+@tab printing chord names 
+@tab
+@lilypond[fragment,relative 1]
+  \context ChordNames \chords { c:dim f:maj7 }
+@end lilypond 
+
 @end multitable
 
index f26834f6e500f8d4447ba622c395f71899aaa41a..fed292e34cb7609b7b3db94c2519cd6249050cc5 100644 (file)
@@ -28,8 +28,9 @@
 * Rhythmic music::              
 * Piano music::                 
 * Vocal music::                 
+* More stanzas::                
 * Tablatures::                  
-* Chords::                      
+* Chord names::                 
 * Writing parts::               
 * Ancient notation ::           
 * Contemporary notation::       
 @section Note entry
 @cindex Note entry
 
-Notes constitute the most basic elements of LilyPond input, but they do
-not form valid input on their own without a @code{\score} block.  However,
-for the sake of brevity and simplicity we will generally omit
-@code{\score} blocks and @code{\paper} declarations in this manual.
 
 
 @menu
 * Notes::                       
 * Pitches::                     
 * Chromatic alterations::       
+* Chords::                      
 * Rests::                       
 * Skips::                       
 * Durations::                   
@@ -69,6 +67,12 @@ for the sake of brevity and simplicity we will generally omit
 
 
 A note is printed by specifying its pitch and then its duration.
+@footnote{Notes constitute the most basic elements of LilyPond input,
+but they do not form valid input on their own without a @code{\score}
+block.  However, for the sake of brevity and simplicity we will
+generally omit @code{\score} blocks and @code{\paper} declarations in
+this manual.}
+
 @lilypond[fragment,verbatim]
   cis'4 d'8 e'16 c'16
 @end lilypond
@@ -82,20 +86,12 @@ A note is printed by specifying its pitch and then its duration.
 @cindex pitches
 @cindex entering notes
 
-The verbose syntax for pitch specification is
-
-@cindex @code{\pitch}
-@example
-  \pitch @var{scmpitch}
-@end example
-
-where @var{scmpitch} is a pitch scheme object.
-
-In Note and Chord mode, pitches may be designated by names.  The
-default names are the Dutch note names.  The notes are specified by
-the letters @code{a} through @code{g}, while the octave is formed with
-notes ranging from @code{c} to @code{b}.  The pitch @code{c} is an
-octave below middle C and the letters span the octave above that C.
+The commonest syntax for pitch entry is used in @code{\chords} and
+@code{\notes} mode.  In Note and Chord mode, pitches may be designated
+by names.  The notes are specified by the letters @code{a} through
+@code{g}, while the octave is formed with notes ranging from @code{c}
+to @code{b}.  The pitch @code{c} is an octave below middle C and the
+letters span the octave above that C.
 
 @lilypond[fragment,verbatim]
 \clef bass
@@ -104,10 +100,12 @@ octave below middle C and the letters span the octave above that C.
 
 @cindex note names, Dutch
 
-In Dutch, a sharp is formed by adding @code{-is} to the end of a pitch
+A sharp is formed by adding @code{-is} to the end of a pitch
 name and a flat is formed by adding @code{-es}.  Double sharps and
 double flats are obtained by adding @code{-isis} or @code{-eses}.
-@code{aes} is contracted to @code{as} in Dutch, but both forms are
+
+These default names are the Dutch note names.  In Dutch, @code{aes} is
+contracted to @code{as} in Dutch, but both forms are
 accepted. Similarly, both @code{es} and @code{ees} are accepted.
 
 There are predefined sets of note names for various other languages.
@@ -145,6 +143,16 @@ octave; each @code{,} lowers the pitch by an octave.
 @end lilypond
 
 
+The verbose syntax for pitch specification is
+
+@cindex @code{\pitch}
+@example
+  \pitch @var{scmpitch}
+@end example
+
+where @var{scmpitch} is a Scheme object of the @code{Pitch} type.
+
+
 @seealso
 
 @internalsref{NoteEvent}, @internalsref{NoteHead}
@@ -171,6 +179,13 @@ question mark `@code{?}' after the pitch.
 The automatic production of accidentals can be tuned in many
 ways. For more information, refer to @ref{Accidentals}.
 
+@node Chords
+@subsection Chords
+
+A chord is formed by a enclosing a set of pitches in @code{<<} and
+@code{>>}.
+
+TODO: accidental overides?
 
 @node  Rests
 @subsection Rests
@@ -2890,6 +2905,14 @@ The associated object is @internalsref{VoiceFollower}.
 For a discussion of how to put lyrics into a score, see section
 @code{Printing lyrics} in the tutorial.
 
+@cindex context variables
+@cindex setting context variables
+An interpretation context has variables that tune its behavior.  These
+variables are also called @emph{properties}.  The @code{autoBeaming}
+variable in a @code{Staff} controls whether 8th and shorter notes are
+beamed automatically. Setting the variable to @code{##f}, which is the
+boolean value @var{false}, turns it off.
+
 
 This will create an extender, which is a line
 that extends over the entire duration of the lyric.  This line will
@@ -2966,6 +2989,70 @@ See also the sections on @ref{Slurs} and @ref{Breath marks}.
 
 [TODO: Write subsection upon usage of ChoirStaff.]
 
+
+
+@node More stanzas
+@section More stanzas
+
+
+@cindex phrasing
+
+If you have multiple stanzas printed underneath each other, the vertical
+groups of syllables should be aligned around punctuation.  LilyPond can
+do this if you tell it which lyric lines belong to which melody.
+We show how you can do this by showing how you could print a frivolous
+fragment of a fictional Sesame Street duet. 
+
+@lilypond[singleline,verbatim]
+\score {
+\addlyrics
+  \notes \relative c'' \context Voice = duet { \time 3/4
+     g2 e4 a2 f4 g2.  }
+  \lyrics \context Lyrics <
+  \context LyricsVoice = "duet-1" {
+    \property LyricsVoice . stanza = "Bert"
+    Hi, my name is bert.    }
+  \context LyricsVoice = "duet-2" {
+    \property LyricsVoice . stanza = "Ernie" 
+    Ooooo, ch\'e -- ri, je t'aime. }
+  >
+}
+@end lilypond
+
+To this end, give the Voice context an identity, and set the
+LyricsVoice to a name starting with that identity followed by a dash.
+In the following example, the Voice identity is @code{duet},
+@example
+\context Voice = duet @{
+     \time 3/4
+     g2 e4 a2 f4 g2.  @}
+@end example
+and the
+identities of the LyricsVoices are @code{duet-1} and @code{duet-2}.
+@example
+  \context LyricsVoice = "duet-1" @{
+    Hi, my name is bert. @}
+  \context LyricsVoice = "duet-2" @{
+    Ooooo, ch\'e -- ri, je t'aime. @}
+@end example
+The convention for naming @code{LyricsVoice} and @code{Voice} must
+also be used to get melismata on rests correct.
+
+
+We add the names of the singers.  This can be done by setting
+@code{LyricsVoice.Stanza} (for the first system) and
+@code{LyricsVoice.stz} for the following systems.   You must
+surround dots with spaces in @code{\lyrics} mode.
+
+@example
+    \property LyricsVoice . stanza = "Bert"
+    @dots{}
+    \property LyricsVoice . stanza = "Ernie" 
+@end example
+
+
+
+
 For entering quotes in Lyrics mode, use the following
 @example
 "\"God\"" is "`King'"
@@ -2976,6 +3063,7 @@ lyrics. This can confuse the LilyPond -- for example, this might put
 (empty) lyrics under rests. To remedy this, use @code{\skip}.
 
 
+
 @refbugs
 
 @cindex ambiguity
@@ -3180,8 +3268,8 @@ As tablature is a recent feature, most of the guitar special effects
 such as bend are not yet supported.
 
 
-@node Chords
-@section Chords
+@node Chord names
+@section Chord namess
 @cindex Chords
 
 LilyPond has support for both entering and printing chords. 
@@ -3640,6 +3728,8 @@ you must put @code{\transpose} outside of @code{\relative}, since
 @code{\transpose}.
 
 
+
+
 @node  Multi measure rests
 @subsection Multi measure rests
 @cindex Multi measure rests
index 104d488449006906d41e41127b7e2831b1a46e33..e0bb669ff8515afb5f1c9651bbea3fb595f5c3b6 100644 (file)
 * Running LilyPond::            Printing music
 * More basics::                 
 * Printing lyrics::             
-* Chord names::                 
 * A lead sheet::                
 * Listening to output::         
 * More movements ::             Joining separate pieces of music
+* Organising larger pieces::    
 * A piano excerpt::             Piano music
 * Fine tuning a piece::         
 * An orchestral score::         Conductor's score and individual parts
@@ -872,8 +872,9 @@ resulting in a centered hyphen between two syllables.
 More options, like putting multiple lines of lyrics below a melody are
 discussed in @ref{Vocal music}.
 
-@node Chord names
-@section Chord names
+
+@node A lead sheet
+@section A lead sheet
 
 In popular music, it is common to denote accompaniment as chord-names.
 Using them in LilyPond has two parts, just like lyrics: entering the
@@ -907,9 +908,6 @@ before the chords thus entered:
 A complete list of modifiers, and other options for layout are in the
 reference manual section @ref{Chords}.
 
-@node A lead sheet
-@section A lead sheet
-
  
 TODO: template example with chord names, lyrics and staff.
 
@@ -1050,7 +1048,7 @@ will be at the left.
 
 
 @node Organising larger pieces
-@sections Organising larger pieces
+@section Organising larger pieces
 
 TODO: discuss identifiers, p&c, .
 
index 16c31b5d8aa7be9607229e1695e3e47e81606579..09986ee206890d3e3a30753f8e2aa33a539b56d5 100644 (file)
@@ -117,8 +117,8 @@ Hyphen_spanner::Hyphen_spanner (Spanner*s)
 
 
 ADD_INTERFACE (Hyphen_spanner, "lyric-hyphen-interface",
-  "A centred hyphen is a simple line between lyrics used to divide
-syllables.   The length of the hyphen line should stretch based on the
-size of the gap between syllables.",
+  "A centred hyphen is a simple line between lyrics used to divide "
+"syllables.   The length of the hyphen line should stretch based on the "
+"size of the gap between syllables.",
   "thickness height minimum-length maximum-length word-space");
 
index a809f892caf8bc0ec7999aa966b2b047caf794e1..944a4f75b07565c000546da34f0ea14ac70570ef 100644 (file)
@@ -67,6 +67,6 @@ Lyric_extender::set_textitem (Spanner*sp, Direction d, Grob*s)
 
 
 ADD_INTERFACE (Lyric_extender,"lyric-extender-interface",
-  "The extender is a simple line at the baseline of the lyric
-that helps show the length of a melissima (tied/slurred note).",
+  "The extender is a simple line at the baseline of the lyric "
+that helps show the length of a melissima (tied/slurred note).",
   "word-space height right-trim-amount");