X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Frhythms.itely;h=83ecb95d70ea09b8afa46593693fb59285c49fd7;hb=f436cbf790e4a6100bf2b21e4fb2ff9f3dfcc3cf;hp=1d6767d33da86df78af5308038f5384882b6dbf6;hpb=1899aa5e1b77587e9dafebb4e3aaeb60a69c53ee;p=lilypond.git diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely index 1d6767d33d..83ecb95d70 100644 --- a/Documentation/user/rhythms.itely +++ b/Documentation/user/rhythms.itely @@ -6,6 +6,35 @@ version that you are working on. See TRANSLATION for details. @end ignore +@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 @@ -141,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 @@ -245,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 @@ -340,7 +371,8 @@ Notation Reference: @ref{Skips}, @ref{Polymetric notation}. -Snippets: @lsrdir{Rhythms,Rhythms} +Snippets: +@rlsr{Rhythms}. @node Ties @@ -470,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 @@ -558,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 @@ -630,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 @@ -803,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 @@ -846,6 +882,7 @@ R1*4 cis cis * Unmetered music:: * Polymetric notation:: * Automatic note splitting:: +* Showing melody rhythms:: @end menu @node Time signature @@ -928,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)}: @@ -965,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 @@ -1029,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 @@ -1102,7 +1140,8 @@ Music Glossary: @rglos{cadenza} Notation Reference: @ref{Controlling visibility of objects} -Snippets: @lsrdir{Rhythms,Rhythms} +Snippets: +@rlsr{Rhythms}. @knownissues @@ -1247,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 @@ -1301,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 @@ -1319,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 @@ -1442,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 @@ -1641,7 +1698,8 @@ automatic beam is still accepting notes, it is not typeset. @seealso -Snippets: @lsrdir{Rhythms,Rhythms} +Snippets: +@rlsr{Rhythms}. @node Manual beams @@ -1752,7 +1810,8 @@ music snippets, and when numbers in the fraction are small. @seealso -Snippets: @lsrdir{Rhythms,Rhythms} +Snippets: +@rlsr{Rhythms}. @@ -1908,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). @@ -2050,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 @@ -2147,7 +2208,8 @@ when it is processed. @seealso -Snippets: @lsrdir{Rhythms,Rhythms} +Snippets: +@rlsr{Rhythms}. @node Rehearsal marks @@ -2253,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 @@ -2441,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 @@ -2511,7 +2575,8 @@ cadenza = \relative c' { @seealso -Snippets: @lsrdir{Rhythms,Rhythms} +Snippets: +@rlsr{Rhythms}. @node Time administration @@ -2590,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}