]> git.donarmstrong.com Git - lilypond.git/commitdiff
Merge branch 'master' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond
authorJohn Mandereau <john.mandereau@gmail.com>
Sat, 19 Apr 2008 16:37:58 +0000 (18:37 +0200)
committerJohn Mandereau <john.mandereau@gmail.com>
Sat, 19 Apr 2008 16:37:58 +0000 (18:37 +0200)
* 'master' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond:
  GDP: NR 2 Reorganisation: Vocal comments
  GDP: NR 2 Reorganisation: Unfretted-strings comments
  GDP: NR 2 Reorganisation: add comments to percussion
  Move melody rhythms from percussion

Documentation/user/percussion.itely
Documentation/user/rhythms.itely
Documentation/user/unfretted-strings.itely
Documentation/user/vocal.itely

index 880fe5c54cf94b0f700c4ce5a21276f205959068..c3e598814fb31463d35146b6693c99f241e55be6 100644 (file)
@@ -34,34 +34,11 @@ also be used to show the rhythms of melodies.
 @c TODO Add refs
 TBC
 
-@ignore
-TODO This section needs splitting.
-     The part showing the rhythm of a melody should be moved to
-     1.2.3 Displaying rhythms, but the example should be changed
-     to omit the drum roll.
-     A better example of drum rolls should be devised and placed in
-     Basic percussion notation. -td
-
-@node Showing melody rhythms
-@subsubsection Showing melody rhythms
-
-Sometimes you might want to show only the rhythm of a melody.  This
-can be done with the rhythmic staff.  All pitches of notes on such a
-staff are squashed, and the staff itself has a single line
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new RhythmicStaff {
-  \time 4/4
-  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
-}
-@end lilypond
 
 @seealso
 
 Internals Reference: @internalsref{RhythmicStaff}.
 
-@end ignore
-
 
 @node Basic percussion notation
 @subsubsection Basic percussion notation
@@ -72,8 +49,10 @@ Internals Reference: @internalsref{RhythmicStaff}.
 
 Percussion notes may be entered in @code{\drummode} mode, which is
 similar to the standard mode for entering notes.  Each piece of
-percussion has a full name and an abbreviated name, and both can be used
-in input files
+percussion has a full name and an abbreviated name, and both can
+be used in input files.  The simplest way to enter percussion notes
+is to use the @code{\drums} command, which creates the correct
+context and entry mode for percussion:
 
 @lilypond[quote,ragged-right,verbatim]
 \drums {
@@ -81,10 +60,45 @@ in input files
 }
 @end lilypond
 
+This is shorthand for
+
+@lilypond[quote,ragged-right,verbatim]
+\new DrumStaff
+\drummode {
+  hihat hh bassdrum bd
+}
+@end lilypond
+
+
 The complete list of drum names is in the init file
 @file{ly/@/drumpitch@/-init@/.ly}.
 @c TODO: properly document this.
 
+Drum rolls are indicated with three slashes across the stem.
+For quarter notes or longer the three slashes are shown explicitly,
+eighth notes are shown with two slashes (the beam being the third),
+and drum rolls shorter than eighths have one stem slash to
+supplement the beams.  This is achieved with the tremolo notation,
+@code{:32}, see @ref{Tremolo repeats}.  Here's an example of
+some snare rolls:
+
+@lilypond[quote,ragged-right,verbatim]
+\new DrumStaff
+\drummode {
+  \time 2/4
+  sn16 sn8 sn16 sn8 sn8:32~ |
+  sn8 sn8 sn4:32~ |
+  sn4 sn8 sn16 sn16 |
+  sn4 r4 |
+}
+@end lilypond
+
+Sticking can be indicated by placing @code{^"R"} or @code{^"L"}
+after the note.  The @code{staff-padding} property may be
+overridden to achieve a pleasing baseline.
+
+@c TODO Add example of sticking
+
 @seealso
 
 Internals Reference: @internalsref{note-event}.
index 199f90c8625e35bff40ec803ea426ff981ee69cf..4b82d8bbdb2804f4c9992fe38d7e10a25f9a2bb8 100644 (file)
@@ -1335,7 +1335,17 @@ split rests.
 @node Showing melody rhythms
 @subsubsection Showing melody rhythms
 
-TODO
+Sometimes you might want to show only the rhythm of a melody.  This
+can be done with the rhythmic staff.  All pitches of notes on such a
+staff are squashed, and the staff itself has a single line
+
+@c TODO Devise a more realistic example, perhaps with lyrics -td
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new RhythmicStaff {
+  \time 4/4
+  c4 e8 f g2 | r4 g r2 | g1 | r1 |
+}
+@end lilypond
 
 
 @node Beams
index e4b211c09e7230430cfaf23295e510e8d91db89b..00eab12d9afb5bae3a264b7db396a2e7673f424e 100644 (file)
@@ -35,9 +35,13 @@ until we have something to say about them -td
 @node References for unfretted strings
 @subsubsection References for unfretted strings
 
-@c TODO Add refs to fingerings, \thumb, bowings, harmonics
+@c TODO Add refs to fingerings, \thumb, bowings
+@c TODO Add multiple fingering indications?
+@c TODO Add snippet showing pizzicato markings
 TBC
 
+@c TODO Decide whether to resurrect Bowed instruments subsection
+@c and if so which of the above should go there
 @ignore
 
 @node Bowed instruments
@@ -71,5 +75,18 @@ are entered by marking the harmonic pitch with @code{\harmonic}.
 @node Harp
 @subsubsection Harp
 
-@c TODO add \sacredHarpHeads, expanded or ref?
-TBC
+Sacred Harp notation uses four shaped note heads.  In the major,
+the tonic is a triangle and then proceeding up the scale you
+have circle, square, triangle, circle, square, diamond.  In the
+minor, the shapes should be assigned to keep the same interval
+relationships, e.g. you assign them for the relative major.  (This
+means that the scale in the minor gives the tonic a square.)
+
+@c TODO add example of \sacredHarpHeads, or a ref?
+
+
+@knownissues
+
+The \sacredHarpHeads command gives the wrong shapes when the key
+is minor.  A work-around is to switch the key to the relative
+major to obtain the right shapes.
index b7437808770a1d766ce0e77156a8a807fd107752..6f9089de8c1bd2983890d376f214a607fb052692 100644 (file)
@@ -761,6 +761,21 @@ layout.
 }
 @end lilypond
 
+@snippets
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{aligning-lyrics.ly}
+
+@c TODO Create and add lsr example of lyricMelismaAlignment
+@c It's used like this to center-align all lyric syllables,
+@c even when notes are tied. -td
+
+@ignore
+\layout
+{
+     \context { \Score lyricMelismaAlignment = #0 }
+}
+@end ignore
+
 @node Centering lyrics between staves
 @subsubsection Centering lyrics between staves
 
@@ -802,6 +817,30 @@ Stanza numbers can be added by setting @code{stanza}, e.g.,
 @noindent
 These numbers are put just before the start of the first syllable.
 
+@c TODO Create and add snippet to show how two lines of a
+@c stanza can be grouped together, along these lines: 
+@c (might need improving a bit) -td
+
+@ignore
+leftbrace = \markup { \override #'(font-encoding . fetaBraces) \lookup
+#"brace105" }
+
+stanzaOneOne = {
+  \set stanza = \markup { "1. " \leftbrace }
+  \lyricmode { Child, you're mine and I love you.
+    Lend thine ear to what I say.
+    ...
+  }
+}
+
+stanzaOneThree =  {
+%  \set stanza = \markup { "   "}
+  \lyricmode { Child, I have no great -- er joy
+    Than to have you walk in truth.
+...
+  }
+}
+@end ignore
 
 @node Adding dynamics marks to stanzas
 @subsubsection Adding dynamics marks to stanzas