]> git.donarmstrong.com Git - lilypond.git/commitdiff
Merge branch 'master' of git+ssh://git.savannah.gnu.org/srv/git/lilypond
authorDavid Kastrup <dak@gnu.org>
Mon, 16 Aug 2010 10:41:46 +0000 (12:41 +0200)
committerDavid Kastrup <dak@gnu.org>
Mon, 16 Aug 2010 10:41:46 +0000 (12:41 +0200)
Documentation/learning/templates.itely
Documentation/notation/expressive.itely
Documentation/notation/pitches.itely
Documentation/notation/text.itely
Documentation/snippets/hymn-template.ly [new file with mode: 0644]
Documentation/snippets/new/hymn-template.ly [new file with mode: 0644]

index 2940a0d88f54e6d4bd009f5208e8b568de228819..b7ceef9fe2f7fc0ecb389dceea2e3a006befc2b8 100644 (file)
@@ -115,6 +115,11 @@ beautiful printed scores!
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
 {vocal-ensemble-template-with-verse-and-refrain.ly}
 
+@appendixsubsec Hymn tunes
+
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{hymn-template.ly}
+
 
 @node Orchestral templates
 @appendixsec Orchestral templates
index 072aa2e402ec9904bc17014f33fd1561de6aaaf8..897a5c38459363ee479473f3c2c10f9dfd570c5a 100644 (file)
@@ -200,7 +200,6 @@ Music Glossary:
 Learning Manual:
 @rlearning{Placement of objects}.
 
-
 Notation Reference:
 @ref{Text scripts},
 @ref{Direction and placement},
@@ -311,10 +310,33 @@ d2\> d\>
 c1\!
 @end lilypond
 
-Spacer rests are needed to engrave multiple marks on one note.
+A hairpin that is terminated with @code{\!} will end at the
+right edge of the note that has the @code{\!} assigned to it.  In the
+case where it is terminated with the start of another @notation{crescendo}
+or @notation{decrescendo} mark, it will end at the centre of the note
+that has the next @code{\<} or @code{\>} assigned to it.  The next
+hairpin will then start at the right edge of the same note
+instead of the usual left edge had it been terminated with @code{\!}
+before.
+
+@lilypond[verbatim,quote,relative=2]
+c1\< | c4 a c\< a | c4 a c\! a\< | c4 a c a\!
+@end lilypond
+
+Hairpins that are terminated with absolute dynamic marks instead of
+@code{\!} will also be engraved in a similar way.  However, the length
+of the absolute dynamic itself can alter where the preceding hairpin
+ends.
+
+@lilypond[verbatim,quote,relative=2]
+c1\< | c4 a c\mf a | c1\< | c4 a c\ffff a
+@end lilypond
 
 @cindex multiple dynamic marks on one note
 @cindex dynamic marks, multiple on one note
+Spacer rests are needed to engrave multiple marks on one note.
+This is particularly useful when adding a @notation{crescendo} and
+@notation{decrescendo} to the same note:
 
 @lilypond[verbatim,quote,relative=2]
 c4\< c\! d\> e\!
@@ -326,9 +348,9 @@ c4\< c\! d\> e\!
 @funindex \espressivo
 @funindex espressivo
 
-In some situations the @code{\espressivo} articulation mark may be
-the appropriate choice to indicate a crescendo and decrescendo on
-one note:
+The @code{\espressivo} command can be used to indicate a crescendo
+and decrescendo on the same note.  However, be warned that this is
+implemented as an articulation, not a dynamic.
 
 @lilypond[verbatim,quote,relative=2]
 c2 b4 a
index 6cd59696337e5ba6c2e484107dbca5d214a6f323..793144df09fa76b71f9debe47cce394f74bbe97a 100644 (file)
@@ -2625,7 +2625,6 @@ Internals Reference:
 @cindex practice note heads
 @cindex note heads, easy notation
 @cindex easy notation
-@cindex Hal Leonard
 @cindex beginners' music
 @cindex music, beginners'
 @cindex easy play note heads
index c2cf111a683e99f71901e70743b494555beb29f7..09337c43f07d9c44b337c5ec3b48c54301493292 100644 (file)
@@ -167,6 +167,8 @@ e,\stopTextSpan
 
 The line style, as well as the text string, can be defined as an
 object property.  This syntax is described in @ref{Line styles}.
+Text spanners are part of the @code{Dynamics} context; see
+@rinternals{Dynamics}.
 
 
 @funindex \textSpannerUp
@@ -186,16 +188,26 @@ object property.  This syntax is described in @ref{Line styles}.
 @knownissues
 LilyPond is only able to handle one text spanner per voice.
 
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{dynamics-text-spanner-postfix.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{dynamics-custom-text-spanner-postfix.ly}
+
 @seealso
 Notation Reference:
 @ref{Line styles},
 @ref{Dynamics}.
 
 Snippets:
-@rlsr{Text}.
+@rlsr{Text},
+@rlsr{Expressive marks}.
 
 Internals Reference:
-@rinternals{TextSpanner}.
+@rinternals{TextSpanner},
+@rinternals{Dynamics}.
 
 
 @node Text marks
diff --git a/Documentation/snippets/hymn-template.ly b/Documentation/snippets/hymn-template.ly
new file mode 100644 (file)
index 0000000..a9b37b8
--- /dev/null
@@ -0,0 +1,106 @@
+% Do not edit this file; it is automatically
+% generated from Documentation\snippets\new
+% This file is in the public domain.
+%% Note: this file works from version 2.13.31
+\version "2.13.31"
+\header {
+  lsrtags = "vocal-music, template"
+  texidoc = "
+This code shows one way of setting out a hymn tune when each line
+starts and ends with a partial measure.  It also shows how to add
+the verses as stand-alone text under the music.
+
+"
+  doctitle = "Hymn template"
+} % begin verbatim
+
+
+Timeline = {
+  \time 4/4
+  \tempo 4=96
+  \partial 2
+  s2 | s1 | s2 \breathe s2 | s1 | s2 \bar "||" \break
+  s2 | s1 | s2 \breathe s2 | s1 | s2 \bar "||"
+}
+
+SopranoMusic = \relative g' {
+  g4 g | g g g g | g g g g | g g g g | g2
+  g4 g | g g g g | g g g g | g g g g | g2
+}
+
+AltoMusic = \relative c' {
+  d4 d | d d d d | d d d d | d d d d | d2
+  d4 d | d d d d | d d d d | d d d d | d2
+}
+
+TenorMusic = \relative a {
+  b4 b | b b b b | b b b b | b b b b | b2
+  b4 b | b b b b | b b b b | b b b b | b2
+}
+
+BassMusic =  \relative g {
+  g4 g | g g g g | g g g g | g g g g | g2
+  g4 g | g g g g | g g g g | g g g g | g2
+}
+
+global = {
+ \key g \major
+}
+
+\score {  % Start score
+  <<
+    \new PianoStaff <<  % Start pianostaff
+      \new Staff <<  % Start Staff = RH
+        \global
+        \clef "treble"
+        \new Voice = "Soprano" <<  % Start Voice = "Soprano"
+          \Timeline
+          \voiceOne
+          \SopranoMusic
+        >>  % End Voice = "Soprano"
+        \new Voice = "Alto" <<  % Start Voice = "Alto"
+          \Timeline
+          \voiceTwo
+          \AltoMusic
+        >>  % End Voice = "Alto"
+      >>  % End Staff = RH
+      \new Staff <<  % Start Staff = LH
+        \global
+        \clef "bass"
+        \new Voice = "Tenor" <<  % Start Voice = "Tenor"
+          \Timeline
+          \voiceOne
+          \TenorMusic
+        >>  % End Voice = "Tenor"
+        \new Voice = "Bass" <<  % Start Voice = "Bass"
+          \Timeline
+          \voiceTwo
+          \BassMusic
+        >>  % End Voice = "Bass"
+      >>  % End Staff = LH
+    >>  % End pianostaff
+  >>
+}  % End score
+
+\markup {
+  \fill-line {
+    ""
+    {
+      \column {
+        \left-align {
+          "This is line one of the first verse"
+          "This is line two of the same"
+          "And here's line three of the first verse"
+          "And the last line of the same"
+        }
+      }
+    }
+    ""
+  }
+}
+
+\paper {  % Start paper block
+  indent = 0     % don't indent first system
+  line-width = 130   % shorten line length to suit music
+  ragged-bottom = ##f   % don't justify systems on page
+}  % End paper block
diff --git a/Documentation/snippets/new/hymn-template.ly b/Documentation/snippets/new/hymn-template.ly
new file mode 100644 (file)
index 0000000..b638572
--- /dev/null
@@ -0,0 +1,101 @@
+\version "2.13.31"
+\header {
+  lsrtags = "vocal-music, template"
+  texidoc = "
+This code shows one way of setting out a hymn tune when each line
+starts and ends with a partial measure.  It also shows how to add
+the verses as stand-alone text under the music.
+
+"
+  doctitle = "Hymn template"
+}
+
+Timeline = {
+  \time 4/4
+  \tempo 4=96
+  \partial 2
+  s2 | s1 | s2 \breathe s2 | s1 | s2 \bar "||" \break
+  s2 | s1 | s2 \breathe s2 | s1 | s2 \bar "||"
+}
+
+SopranoMusic = \relative g' {
+  g4 g | g g g g | g g g g | g g g g | g2
+  g4 g | g g g g | g g g g | g g g g | g2
+}
+
+AltoMusic = \relative c' {
+  d4 d | d d d d | d d d d | d d d d | d2
+  d4 d | d d d d | d d d d | d d d d | d2
+}
+
+TenorMusic = \relative a {
+  b4 b | b b b b | b b b b | b b b b | b2
+  b4 b | b b b b | b b b b | b b b b | b2
+}
+
+BassMusic =  \relative g {
+  g4 g | g g g g | g g g g | g g g g | g2
+  g4 g | g g g g | g g g g | g g g g | g2
+}
+
+global = {
+ \key g \major
+}
+
+\score {  % Start score
+  <<
+    \new PianoStaff <<  % Start pianostaff
+      \new Staff <<  % Start Staff = RH
+        \global
+        \clef "treble"
+        \new Voice = "Soprano" <<  % Start Voice = "Soprano"
+          \Timeline
+          \voiceOne
+          \SopranoMusic
+        >>  % End Voice = "Soprano"
+        \new Voice = "Alto" <<  % Start Voice = "Alto"
+          \Timeline
+          \voiceTwo
+          \AltoMusic
+        >>  % End Voice = "Alto"
+      >>  % End Staff = RH
+      \new Staff <<  % Start Staff = LH
+        \global
+        \clef "bass"
+        \new Voice = "Tenor" <<  % Start Voice = "Tenor"
+          \Timeline
+          \voiceOne
+          \TenorMusic
+        >>  % End Voice = "Tenor"
+        \new Voice = "Bass" <<  % Start Voice = "Bass"
+          \Timeline
+          \voiceTwo
+          \BassMusic
+        >>  % End Voice = "Bass"
+      >>  % End Staff = LH
+    >>  % End pianostaff
+  >>
+}  % End score
+
+\markup {
+  \fill-line {
+    ""
+    {
+      \column {
+        \left-align {
+          "This is line one of the first verse"
+          "This is line two of the same"
+          "And here's line three of the first verse"
+          "And the last line of the same"
+        }
+      }
+    }
+    ""
+  }
+}
+
+\paper {  % Start paper block
+  indent = 0     % don't indent first system
+  line-width = 130   % shorten line length to suit music
+  ragged-bottom = ##f   % don't justify systems on page
+}  % End paper block