Merge branch 'master' of ssh://jneem@git.sv.gnu.org/srv/git/lilypond

[lilypond.git] / Documentation / user / rhythms.itely

diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely
index dfea04ce21d01392e9ae465c23f5a64dd85db505..83ecb95d70ea09b8afa46593693fb59285c49fd7 100644 (file)
--- a/Documentation/user/rhythms.itely
+++ b/Documentation/user/rhythms.itely
@@ -8,6 +8,33 @@
 
 @c \version "2.11.38"
 
+@ignore
+GDP TODO list
+
+\compressMusic -> \scaleDurations.
+approved by Han-Wen; just needs somebody to kick up a fuss about
+it.
+
+1.2.3.1 Time signature
+Needs an example of beatLength, which is broken (see my recent
+mail
+to -bug).  What to do?  For now I've left a paragraph of text
+which really
+needs to be inserted with an example in a snippet.
+
+1.2.3.4 Polymetric notation
+Quite extensive changes. Could you please check through.  Divided
+into three
+sections.  Necessarily uses tweaks.  I've also left an @lsr under
+@seealso
+Snippets - is this permitted or is @lsr now verboten?  This
+snippet is too
+long to include, but seems relevant.
+A snippet "grouping beats" hasn't yet appeared (only sent to vv a
+couple of
+days ago).  Text left in Snippets: with TODO.
+@end ignore
+
 @node Rhythms
 @section Rhythms
 
@@ -143,11 +170,12 @@ Notation Reference:
 @ref{Ancient notation},
 @ref{Proportional notation}.
 
-Snippets: @lsrdir{Rhythms,Rhythms}.
+Snippets:
+@rlsr{Rhythms}.
 
 Internals Reference:
-@internalsref{Dots},
-@internalsref{DotColumn}.
+@rinternals{Dots},
+@rinternals{DotColumn}.
 
 
 @knownissues
@@ -247,12 +275,13 @@ Notation Reference:
 @ref{Objects connected to the input},
 @ref{Polymetric notation}.
 
-Snippets: @lsrdir{Rhythms,Rhythms}.
+Snippets:
+@rlsr{Rhythms}.
 
 Internals Reference:
-@internalsref{TupletBracket},
-@internalsref{TupletNumber},
-@internalsref{TimeScaledMusic}.
+@rinternals{TupletBracket},
+@rinternals{TupletNumber},
+@rinternals{TimeScaledMusic}.
 
 @knownissues
 @cindex grace notes within tuplet brackets
@@ -342,7 +371,8 @@ Notation Reference:
 @ref{Skips},
 @ref{Polymetric notation}.
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 
 @node Ties
@@ -472,13 +502,14 @@ Music Glossary:
 
 Notation Reference: @ref{Automatic note splitting}.
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 Internals Reference:
-@internalsref{LaissezVibrerTie},
-@internalsref{LaissezVibrerTieColumn},
-@internalsref{TieColumn},
-@internalsref{Tie}.
+@rinternals{LaissezVibrerTie},
+@rinternals{LaissezVibrerTieColumn},
+@rinternals{TieColumn},
+@rinternals{Tie}.
 
 
 @knownissues
@@ -560,9 +591,10 @@ a4\rest d4\rest
 
 Notation Reference: @ref{Full measure rests}
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
-Internals Reference: @internalsref{Rest}
+Internals Reference: @rinternals{Rest}
 
 
 @knownissues
@@ -632,9 +664,10 @@ empty page:
 
 @seealso
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
-Internals Reference: @internalsref{SkipMusic}
+Internals Reference: @rinternals{SkipMusic}
 
 
 @node Full measure rests
@@ -805,12 +838,13 @@ Notation Reference:
 @ref{Formatting text},
 @ref{Text scripts}.
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 Internals Reference:
-@internalsref{MultiMeasureRest},
-@internalsref{MultiMeasureRestNumber},
-@internalsref{MultiMeasureRestText}.
+@rinternals{MultiMeasureRest},
+@rinternals{MultiMeasureRestNumber},
+@rinternals{MultiMeasureRestText}.
 
 
 @knownissues
@@ -848,6 +882,7 @@ R1*4 cis cis
 * Unmetered music::             
 * Polymetric notation::         
 * Automatic note splitting::    
+* Showing melody rhythms::     
 @end menu
 
 @node Time signature
@@ -930,8 +965,8 @@ Options to group beats within a bar are available through the
 Scheme function @code{set-time-signature}, which takes three
 arguments: the number of beats, the beat length, and the internal
 grouping of beats in the measure.  If the
-@internalsref{Measure_grouping_engraver} is included, the function
-will also create @internalsref{MeasureGrouping} signs.  Such signs
+@rinternals{Measure_grouping_engraver} is included, the function
+will also create @rinternals{MeasureGrouping} signs.  Such signs
 ease reading rhythmically complex modern music.  In the example,
 the 9/8 measure is subdivided in 2, 2, 2 and 3.  This is passed to
 @code{set-time-signature} as the third argument: @code{'(2 2 2 3)}:
@@ -967,15 +1002,15 @@ Music Glossary:
 @rglos{time signature}
 
 Notation Reference:
-@ruser{Ancient time signatures},
-@ruser{Time administration}.
+@ref{Ancient time signatures},
+@ref{Time administration}.
 
 Snippets:
-@lsrdir{Rhythms,Rhythms}
+@rlsr{Rhythms}.
 
 Internals Reference:
-@internalsref{TimeSignature},
-@internalsref{Timing_translator}.
+@rinternals{TimeSignature},
+@rinternals{Timing_translator}.
 
 
 @knownissues
@@ -1031,9 +1066,10 @@ Music Glossary: @rglos{anacrusis}
 
 Notation Reference: @ref{Grace notes}
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
-Internal Reference: @internalsref{Timing_translator}
+Internal Reference: @rinternals{Timing_translator}
 
 @knownissues
 
@@ -1104,7 +1140,8 @@ Music Glossary: @rglos{cadenza}
 
 Notation Reference: @ref{Controlling visibility of objects}
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 @knownissues
 
@@ -1249,14 +1286,14 @@ Music Glossary:
 Notation Reference: @ref{Scaling durations}
 
 Snippets:
-@lsrdir{Rhythms,Rhythms}
+@rlsr{Rhythms}.
 @c Is this still permitted?
 @c @lsr{contemporary,compound-time-signature}
 
 Internals Reference:
-@internalsref{TimeSignature},
-@internalsref{Timing-translator},
-@internalsref{Staff}.
+@rinternals{TimeSignature},
+@rinternals{Timing-translator},
+@rinternals{Staff}.
 
 @knownissues
 
@@ -1303,12 +1340,13 @@ Learning Manual:
 @rlearning{Engravers explained},
 @rlearning{Adding and removing engravers}.
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 Internals Reference:
-@internalsref{Note_heads_engraver},
-@internalsref{Completion_heads_engraver},
-@internalsref{Forbid_line_break_engraver}.
+@rinternals{Note_heads_engraver},
+@rinternals{Completion_heads_engraver},
+@rinternals{Forbid_line_break_engraver}.
 
 
 @knownissues
@@ -1321,6 +1359,22 @@ The @code{Completion_heads_engraver} only affects notes; it does not
 split rests.
 
 
+@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
+
+@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
 @subsection Beams
 
@@ -1444,9 +1498,10 @@ f8 f''8 f8 f''8
 
 Notation Reference: @ref{Manual beams}, @ref{Setting automatic beam behavior}.
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
-Internals Reference: @internalsref{Beam}.
+Internals Reference: @rinternals{Beam}.
 
 
 @knownissues
@@ -1643,7 +1698,8 @@ automatic beam is still accepting notes, it is not typeset.
 
 @seealso
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 
 @node Manual beams
@@ -1754,7 +1810,8 @@ music snippets, and when numbers in the fraction are small.
 
 @seealso
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 
 
@@ -1910,11 +1967,12 @@ Notation Reference: @ref{Line breaking}, @ref{Repeats},
 @c FIXME: node name changed, but is subject to further changes.
 @c @ref{System start delimiters}.
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
-Internals Reference: @internalsref{BarLine} (created at
-@internalsref{Staff} level), @internalsref{SpanBar} (across
-staves), @internalsref{Timing_translator} (for Timing
+Internals Reference: @rinternals{BarLine} (created at
+@rinternals{Staff} level), @rinternals{SpanBar} (across
+staves), @rinternals{Timing_translator} (for Timing
 properties).
 
 
@@ -2052,16 +2110,17 @@ Bar numbers can be removed entirely by removing the
 
 @seealso
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
-Internals Reference: @internalsref{BarNumber}.
+Internals Reference: @rinternals{BarNumber}.
 
 
 @knownissues
 
 Bar numbers may collide with the top of the
-@internalsref{StaffGroup} bracket, if there is one.  To solve
-this, the @code{padding} property of @internalsref{BarNumber} can
+@rinternals{StaffGroup} bracket, if there is one.  To solve
+this, the @code{padding} property of @rinternals{BarNumber} can
 be used to position the number correctly.
 
 Bar numbers may only be printed at bar lines; to print a bar
@@ -2149,7 +2208,8 @@ when it is processed.
 
 @seealso
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 
 @node Rehearsal marks
@@ -2255,11 +2315,12 @@ For common tweaks to the positioning of rehearsal marks, see
 
 @seealso
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 This manual: @ref{The Feta font}, @ref{Formatting text}.
 
-Internals Reference: @internalsref{RehearsalMark}.
+Internals Reference: @rinternals{RehearsalMark}.
 
 Init files: @file{scm/@/translation@/-functions@/.scm} contains
 the definition of @code{format-mark-numbers} and
@@ -2443,9 +2504,10 @@ Music Glossary:
 @rglos{acciaccatura},
 @rglos{appoggiatura}
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
-Internals Reference: @internalsref{GraceMusic}.
+Internals Reference: @rinternals{GraceMusic}.
 
 
 @knownissues
@@ -2513,7 +2575,8 @@ cadenza = \relative c' {
 
 @seealso
 
-Snippets: @lsrdir{Rhythms,Rhythms}
+Snippets:
+@rlsr{Rhythms}.
 
 
 @node Time administration
@@ -2592,22 +2655,9 @@ notes.
 
 This manual: @ref{Bar numbers}, @ref{Unmetered music}
 
-Snippets: @lsrdir{Rhythms,Rhythms}
-
-Internals Reference: @internalsref{Timing_translator},
-@internalsref{Score}
-
-
-
-
-
-
-
-
-
-
-
-
-
+Snippets:
+@rlsr{Rhythms}.
 
+Internals Reference: @rinternals{Timing_translator},
+@rinternals{Score}