X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Frhythms.itely;h=8bd6c24b7ef1a9b436758d553d06a5890f1182a2;hb=2a07e2ea1924abec1b70e2150e698e5792ae1687;hp=89475917450e2dd1ccdec714e2fafcc8f2a22a6a;hpb=ca208d43bd8e68c9af7e3e3314ecfb2869fdfd6f;p=lilypond.git

diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely
index 8947591745..8bd6c24b7e 100644
--- a/Documentation/user/rhythms.itely
+++ b/Documentation/user/rhythms.itely
@@ -9,10 +9,9 @@
 @node Rhythms
 @section Rhythms
 
-@lilypondfile[ragged-right,line-width=16\cm,staffsize=14,quote]
-{rhythms-headword.ly}
+@lilypondfile[quote]{rhythms-headword.ly}
 
-This section discusses rhythms, durations, and bars.
+This section discusses rhythms, rests, durations, beaming and bars.
 
 @menu
 * Writing rhythms::             
@@ -35,7 +34,7 @@ This section discusses rhythms, durations, and bars.
 @end menu
 
 @node Durations
-@unnumberedsubsubsec Durations
+@subsubsection Durations
 
 @cindex durations, of notes
 @cindex note durations
@@ -44,13 +43,13 @@ This section discusses rhythms, durations, and bars.
 @funindex \breve
 @funindex \maxima
 
-When entering notes, durations are designated by numbers and dots:
-durations are entered as their reciprocal values.  For example, a
+Durations are designated by numbers and dots.
+Durations are entered as their reciprocal values.  For example, a
 quarter note is entered using a @code{4} (since it is a 1/4 note),
-while a half note is entered using a @code{2} (since it is a 1/2
+and a half note is entered using a @code{2} (since it is a 1/2
 note).  For notes longer than a whole you must use the
-@code{\longa} (a double breve) and @code{\breve} commands.  Note
-durations as short as 64th notes may be specified.  Shorter values
+@code{\longa} (a double breve) and @code{\breve} commands.  
+Durations as short as 64th notes may be specified.  Shorter values
 are possible, but only as beamed notes.
 
 @c Two 64th notes are needed to obtain beams
@@ -61,8 +60,7 @@ c4 c8 c16 c32 c64 c64
 @end lilypond
 
 @noindent
-and the same durations with automatic beaming turned off 
-see @ref{Automatic beams}:
+Here are the same durations with automatic beaming turned off.
 
 @c not strictly "writing rhythms"; more of a "displaying" thing,
 @c but it's ok here.  -gp
@@ -73,7 +71,11 @@ c\longa c\breve c1 c2
 c4 c8 c16 c32 c64 c64
 @end lilypond
 
-If the duration is omitted then it is set to the previously
+A note with the duration of a quadruple breve may be entered with
+@code{\maxima}, but this is supported only within ancient music
+notation.  For details, see @ref{Ancient notation}.
+
+If the duration is omitted, it is set to the previously
 entered duration.  The default for the first note is a quarter
 note.
 
@@ -86,22 +88,31 @@ a a a2 a a4 a a1 a
 
 @funindex .
 
-To obtain dotted note lengths, simply add a dot (@code{.}) to the
-number.  Double-dotted notes are produced in a similar way.
+To obtain dotted note lengths, place a dot (@code{.}) after the
+duration.  Double-dotted notes are specified by appending two
+dots, and so on.
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
 a4 b c4. b8 a4. b4.. c8.
 @end lilypond
 
-Some durations cannot be entered using only binary durations
-and dots, and can only be represented by tying two or more 
-notes together.  Tied notes are covered in @ref{Ties}.
+Some durations cannot be represented with just binary durations
+and dots; they can be represented only by tying two or more
+notes together.  For details, see @ref{Ties}.
 
-@refcommands
+For ways of specifying durations for the syllables of lyrics and
+ways of aligning lyrics to notes, see @ref{Vocal music}.
+
+Optionally, notes can be spaced strictly proportionately to their
+duration.  For details of this and other settings which control
+proportional notation, see @ref{Proportional notation}.
+
+@predefined
 
 Dots are normally moved up to avoid staff lines, except in
 polyphonic situations.  The following commands may be used to
-force a particular direction manually:
+force a particular direction manually, and to return to the
+default behaviour:
 
 @funindex \dotsUp
 @code{\dotsUp},
@@ -110,24 +121,13 @@ force a particular direction manually:
 @funindex \dotsNeutral
 @code{\dotsNeutral}.
 
-For ways of specifying durations for the syllables of lyrics and
-ways of aligning lyrics to notes see @ref{Vocal music}.
-
-A note with the duration of a quadruple breve may be entered with
-@code{\maxima}, but this is supported only within ancient music
-notation; see @ref{Ancient notation}.
-
-Optionally, notes can be spaced proportionately to their duration.
-For details of this and other settings which control proportional
-notation see @ref{Proportional notation}.
-
 
 @seealso
 
 Music Glossary: @rglos{breve}, @rglos{longa}, @rglos{note value}
 @rglos{Duration names notes and rests}.
 
-Notation Reference: @ref{Automatic beams}, @ref{Ties}, 
+Notation Reference: @ref{Automatic beams}, @ref{Ties},
 @ref{Writing rhythms}, @ref{Writing rests}, @ref{Vocal music},
 @ref{Ancient notation}, @ref{Proportional notation}.
 
@@ -137,22 +137,22 @@ Internals Reference: @internalsref{Dots},
 @internalsref{DotColumn}.
 
 
-@refbugs
+@knownissues
 
-@c duplicated in Durations and Rests.  -gp
+@c Deliberately duplicated in Durations and Rests.  -gp
 There is no fundamental limit to rest durations (both in terms of
-longest and shortest), but the number of glyphs is limited: there
-are rests from 128th to maxima (8 x whole).
+longest and shortest), but the number of glyphs is limited:
+rests from 128th to maxima (8 x whole) may be printed.
 
 
 @node Tuplets
-@unnumberedsubsubsec Tuplets
+@subsubsection Tuplets
 
 @cindex tuplets
 @cindex triplets
 @funindex \times
 
-Tuplets are made out of a music expression by multiplying all
+Tuplets are made from a music expression by multiplying all the
 durations with a fraction:
 
 @example
@@ -163,23 +163,27 @@ durations with a fraction:
 The duration of @var{musicexpr} will be multiplied by the 
 fraction.  The fraction's denominator will be printed over or 
 under the notes, optionally with a bracket.  The most common 
-tuplet is the triplet in which 3 notes have the length of 2, so 
+tuplet is the triplet in which 3 notes have the duration of 2, so
 the notes are 2/3 of their written length.
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-g4 \times 2/3 {c4 c c} d4 d4
+a2 \times 2/3 {b4 b b}
+c4 c \times 2/3 {b4 a g}
+
 @end lilypond
 
-Tuplets may be nested; for example,
+Tuplets may be nested:
 
-@lilypond[fragment,ragged-right,verbatim,relative=2]
-\times 2/3 {
-  a4 a
-  \times 3/5 { a a a a a }
-}
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\autoBeamOff
+c4 \times 4/5 { f8 e f \times 2/3 {e[ f g] } } f4 |
 @end lilypond
 
-@refcommands
+Modifying nested tuplets which begin at the same musical moment
+must be done with @code{\tweak}.
+@c TODO Add link to LM section which deals with this.
+
+@predefined
 
 @funindex \tupletUp
 @code{\tupletUp},
@@ -189,22 +193,16 @@ Tuplets may be nested; for example,
 @code{\tupletNeutral}.
 
 
-@commonprop
+@snippets
 
-@funindex tupletNumberFormatFunction
-@funindex tupletSpannerDuration
 @cindex tuplet formatting
+@cindex triplet formatting
 
-The property @code{tupletSpannerDuration} specifies how long each
-bracket should last.  With this, you can make lots of tuplets
-while typing @code{\times} only once, thus saving lots of typing.
-In the next example, there are two triplets shown, while
-@code{\times} was only used once.
+@funindex tupletNumberFormatFunction
+@funindex tupletSpannerDuration
 
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\set tupletSpannerDuration = #(ly:make-moment 1 4)
-\times 2/3 { c8 c c c c c }
-@end lilypond
+@lilypondfile [verbatim,lilyquote,ragged-right,texidoc]
+{entering-several-tuplets-using-only-one--times-command.ly}
 
 @noindent
 For more information about @code{make-moment}, see
@@ -212,14 +210,12 @@ For more information about @code{make-moment}, see
 
 @funindex TupletNumber
 
-The format of the number is determined by the property @code{text}
-in @code{TupletNumber}.  The default prints only the denominator,
-but if the property is set with @code{\override
-TupletNumber #'text = #tuplet-number::calc-fraction-text},
-@var{num}:@var{den} will be printed instead.
+By default, only the numerator of the tuplet number
+is printed over the tuplet bracket, i.e. the denominator
+of the argument to the @code{\times} command.  Alternatively,
+@var{num}:@var{den} of the tuplet number may be printed, or
+the tuplet number may be suppressed altogether.
 
-To print tuplets without tuplet numbers, use
-@code{\override TupletNumber #'transparent = ##t}:
 
 @lilypond[quote,fragment,relative=2,ragged-right,verbatim]
 \times 2/3 { c8 c c } \times 2/3 { c8 c c }
@@ -229,14 +225,59 @@ To print tuplets without tuplet numbers, use
 \times 2/3 { c8 c c }
 @end lilypond
 
-To change the appearance of nested tuplets beginning at the same
-music moment individually, the @code{\tweak} function must be used
-(see @ref{Objects connected to the input}).  In the following
-example, @code{\tweak} specifies fraction text for the outer
-@code{TupletNumber} and denominator text for the
-@code{TupletNumber} of the first of the three inner tuplets.
+@c TODO Add snippet to show this
+Tuplets may extend over bar lines, but they will inhibit a
+line break unless the @code{Forbid_line_break_engraver} is
+removed from the @code{Voice context}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@c TODO Move to LM 4
+@ignore
+@subheading Modifying nested tuplets
+
+@cindex tuplets, nested
+@cindex triplets, nested
+@cindex bracket, tuplet
+@cindex tuplet bracket
+@cindex triplet bracket
+@funindex TupletBracket
+
+If nested tuplets do not begin at the same moment their
+appearance may be modified in the usual way with
+@code{\override} commands:
+
+@c NOTE Tuplet brackets collide if notes are high on staff
+@c See issue 509
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+\times 2/3 { c8[ c c]}
+\once \override TupletNumber #'text = #tuplet-number::calc-fraction-text
+\times 2/3 {
+  c[ c]
+  c[ c]
+  \once \override TupletNumber #'transparent = ##t
+  \times 2/3 { c8[ c c] }
+\times 2/3 { c8[ c c]}
+}
+@end lilypond
+
+However, if the nested tuplets begin at the same musical moment,
+@code{\override} commands cannot be applied to just one of them
+-- they apply to both.  So to change the appearance of nested
+tuplets beginning at the same musical moment individually, the
+@code{\tweak} function must be used (see @ref{Objects connected
+to the input}).  The @code{\tweak} function is applied to the
+following @code{\times} command as it appears in the input stream,
+and so can distinguish between separate @code{\times} commands
+even if their tuplets begin at the same musical moment.
+
+In this example, the @code{\tweak} command is used to specify
+fraction text for the outer @code{TupletNumber} and denominator
+text for the @code{TupletNumber} of the first of the three
+inner tuplets.
+
+@c NOTE Tuplet brackets collide if notes are high on staff
+@c so use relative=1 until this is fixed
+@c See issue 509
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
 \tweak #'text #tuplet-number::calc-fraction-text
 \times 4/3 {
    \tweak #'text #tuplet-number::calc-denominator-text
@@ -246,23 +287,16 @@ example, @code{\tweak} specifies fraction text for the outer
 }
 @end lilypond
 
-@cindex bracket, tuplet
-@funindex TupletBracket
-
-@c FIXME: after LM 6 Tweaks includes \tweak info, look at this.-gp
-@c It *should* be explained why \tweak must be used here, and why
-@c \override doesn't work. I've made an attempt, but I'm not sure
-@c if it is factually correct to say that \tweak must be used.
 In the next example, @code{\tweak} and @code{\override} work
 together to specify @code{TupletBracket} direction.  The first
 @code{\tweak} positions the @code{TupletBracket} of the outer
 tuplet above the staff.  The second @code{\tweak} positions the
 @code{TupletBracket} of the first of the three inner tuplets below
-the staff.  Note that the @code{\tweak} function affects only
-events that begin at the same music moment: the outer tuplet and
-the first of the three inner tuplets.  To position the
-@code{TupletBrackets} of the second and third of the inner tuplets
-below the staff, we use @code{\override} in the usual way.
+the staff.  Note that the @code{\tweak} command needs to be used
+only for events that begin at the same music moment: the outer
+tuplet and the first of the three inner tuplets.  To position the
+@code{TupletBracket}s of the second and third of the inner tuplets
+below the staff, we can use @code{\override} in the usual way.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 \tweak #'text #tuplet-number::calc-fraction-text
@@ -275,39 +309,70 @@ below the staff, we use @code{\override} in the usual way.
    \times 2/3 { c8[ c8 c8] }
 }
 @end lilypond
+@end ignore
+
+@c TODO - tidy up
+@c Sent to Valentin for LSR (general list of Rhythm snippets) 22 Feb
+@c Maybe try referencing with:
+@c For example of modifying bracket length see @lsr{..}
+@c Index entries could then be added above this.
+@c Delete ignore block when available in LSR
+
+@ignore
+@subheading Modifying tuplet bracket length
+
+@cindex tuplet bracket length
+@cindex triplet bracket length
+@cindex bracket length, tuplets
+@funindex tupletFullLength
+@funindex tupletFullLengthNote
+
+Tuplet brackets can be made to run to prefatory matter or the
+next note.
+Default tuplet brackets end at the right edge of the final note
+of the tuplet; full-length tuplet brackets extend farther to the
+right, either to cover all the non-rhythmic notation up to the
+following note, or to cover only the whitespace before the next
+item of notation, be that a clef, time signature, key signature,
+or another note.  The example shows how to switch tuplets to
+full length mode and how to modify what material they cover.
 
-Tuplet brackets can be made to run to prefatory matter or the next
-note:
 
 @lilypond[ragged-right,verbatim,quote]
 \new RhythmicStaff {
+  % Set tuplets to be extendable ..
   \set tupletFullLength = ##t
+  % .. to cover all items up to the next note
   \set tupletFullLengthNote = ##t
   \time 2/4
   \times 2/3 { c4 c c }
+  % .. or to cover just whitespace
   \set tupletFullLengthNote = ##f
   \time 4/4
   \times 4/5 { c4 c1 }
   \time 3/4
-  c4 
+  c4
 }
 @end lilypond
+@end ignore
+
+@c Compressing music
 
+@cindex compressing music
 @funindex \compressMusic
-@funindex \times
 
 @code{\compressMusic} works similarly to \times, but does not
-create a tuplet bracket; see @ref{Polymetric notation}.
-
+create a tuplet bracket.  One application is in polymetric
+notation, see @ref{Polymetric notation}.
 
-@refbugs
+@lilypondfile [verbatim,lilyquote,ragged-right,texidoc]
+{printing-music-with-different-time-signatures.ly}
 
-Tuplets which cross bar lines will prevent a line break at that
-point.
 
 @seealso
 
-Music Glossary: @rglos{tuplet}.
+Music Glossary: @rglos{triplet}, @rglos{tuplet},
+@rglos{polymetric}.
 
 Notation Reference: @ref{Time administration},
 @ref{Objects connected to the input}, @ref{Polymetric notation}.
@@ -315,12 +380,16 @@ Notation Reference: @ref{Time administration},
 Snippets: @lsrdir{Rhythms,Rhythms}.
 
 Internals Reference: @internalsref{TupletBracket},
-@internalsref{TupletNumber}, and @internalsref{TimeScaledMusic}.
+@internalsref{TupletNumber}, @internalsref{TimeScaledMusic}.
+
+@knownissues
 
+Lines may be broken within a tuplet with @code{\bar "" \break},
+but the tuplet bracket does not correctly carry over.
 
 
 @node Scaling durations
-@unnumberedsubsubsec Scaling durations
+@subsubsection Scaling durations
 
 You can alter the length of a duration by a fraction @var{N/M}
 by appending @code{*@var{N/M}} (or @code{*@var{N}} if @var{M=1}).
@@ -341,7 +410,7 @@ b16*4 c4
 @end lilypond
 
 The duration of skip or spacing notes may also be modified by
-a multiplier.  This is useful for skipping many measures, e.g., 
+a multiplier.  This is useful for skipping many measures, e.g.,
 @code{s1*23}.
 
 @seealso
@@ -351,13 +420,13 @@ Notation Reference: @ref{Tuplets}, @ref{Skips}, @ref{Polymetric notation}.
 Snippets: @lsrdir{Rhythms,Rhythms}
 
 @node Ties
-@unnumberedsubsubsec Ties
+@subsubsection Ties
 
 @cindex tie
 @funindex ~
 
 A tie connects two adjacent note heads of the same pitch.  The tie
-in effect extends the length of a note. 
+in effect extends the length of a note.
 
 @warning{Ties should not be confused with @emph{slurs}, which
 indicate articulation, or @emph{phrasing slurs}, which indicate
@@ -407,7 +476,7 @@ have to repeat the tie.  This can be achieved with
 
 @lilypond[fragment,quote,ragged-right,relative=2,verbatim]
 \repeat volta 2 { c g <c e>2 ~ }
-\alternative {{ <c e>2. r4 } {<c e>2\repeatTie d4 c }} 
+\alternative {{ <c e>2. r4 } {<c e>2\repeatTie d4 c }}
 @end lilypond
 
 @cindex laissez vibrer
@@ -426,7 +495,11 @@ be entered using @code{\laissezVibrer}:
 <c f g>\laissezVibrer
 @end lilypond
 
-The direction of a tie can be specified with @code{\tieUp} or
+The vertical placement of ties may be controlled; see
+@ref{Controlling direction and placement}.
+
+@quotation
+DELETE THIS ?
 @code{\tieDown} (see example below).  @code{\tieNeutral} reverts
 to the default behaviour again.
 
@@ -437,24 +510,25 @@ convenient shorthand for forcing tie directions.  By adding
 @lilypond[relative=2,ragged-right,quote,verbatim,fragment]
 c4_~ c c^~ c)
 @end lilypond
+@end quotation
 
+@predefined
 
-@seealso
-
-Music Glossary: @rglos{tie},
-@c [TODO]add @rglos{laissez vibrer}. when there is a glossary entry.
-
-Snippets: @lsrdir{Rhythms,Rhythms}
-
-Internals Reference:
-@internalsref{LaissezVibrerTie}
-@internalsref{LaissezVibrerTieColumn}
-
-Example files:
-@c @lsr{connecting,laissez-vibrer-ties.ly}
+@funindex \tieUp
+@code{\tieUp},
+@funindex \tieDown
+@code{\tieDown},
+@funindex \tieNeutral
+@code{\tieNeutral},
+@funindex \tieDotted
+@code{\tieDotted},
+@funindex \tieDashed
+@code{\tieDashed},
+@funindex \tieSolid
+@code{\tieSolid}.
 
 
-@commonprop
+@snippets
 
 Ties are sometimes used to write out arpeggios.  In this case, two
 tied notes need not be consecutive.  This can be achieved by
@@ -485,24 +559,21 @@ direction (1=up, -1=down).
 @end lilypond
 
 
-@refcommands
 
+@seealso
 
-@funindex \tieUp
-@code{\tieUp},
-@funindex \tieDown
-@code{\tieDown},
-@funindex \tieNeutral
-@code{\tieNeutral},
-@funindex \tieDotted
-@code{\tieDotted},
-@funindex \tieDashed
-@code{\tieDashed},
-@funindex \tieSolid
-@code{\tieSolid}.
+Music Glossary: @rglos{tie},
+@c [TODO]add @rglos{laissez vibrer}. when there is a glossary entry.
 
+Snippets: @lsrdir{Rhythms,Rhythms}
+
+Internals Reference:
+@internalsref{LaissezVibrerTie}
+@internalsref{LaissezVibrerTieColumn}
+
+Example files:
+@c @lsr{connecting,laissez-vibrer-ties.ly}
 
-@seealso
 
 
 
@@ -513,7 +584,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 Internals Reference: @internalsref{Tie}.
 
 
-@refbugs
+@knownissues
 
 Switching staves when a tie is active will not produce a slanted
 tie.
@@ -529,13 +600,13 @@ well-defined.  In these cases, a slur may be preferable.
 @subsection Writing rests
 
 @menu
-* Rests::                       
-* Skips::                       
-* Full measure rests::          
+* Rests::
+* Skips::
+* Full measure rests::
 @end menu
 
 @node Rests
-@unnumberedsubsubsec Rests
+@subsubsection Rests
 @cindex rest
 @cindex maxima
 @cindex longa
@@ -585,15 +656,15 @@ Snippets: @lsrdir{Rhythms,Rhythms}.
 Internals Reference: @internalsref{Rest}.
 
 
-@refbugs
+@knownissues
 
-@c duplicated in Durations and Rests.  -gp
+@c Deliberately duplicated in Durations and Rests.  -gp
 There is no fundamental limit to rest durations (both in terms of
 longest and shortest), but the number of glyphs is limited: there
 are rests from 128th to maxima (8 x whole).
 
 @node Skips
-@unnumberedsubsubsec Skips
+@subsubsection Skips
 
 @cindex skip
 @cindex invisible rest
@@ -647,7 +718,7 @@ Internals Reference: @internalsref{SkipMusic}.
 
 
 @node Full measure rests
-@unnumberedsubsubsec Full measure rests
+@subsubsection Full measure rests
 
 @cindex multi measure rests
 @cindex full measure rests
@@ -803,7 +874,7 @@ default number, and @internalsref{MultiMeasureRestText} for user
 specified texts.
 
 
-@refbugs
+@knownissues
 
 If an attempt is made to use fingerings (e.g., 
 @code{R1*10-4}) to put numbers over multi-measure rests, the
@@ -837,7 +908,7 @@ R1*4 cis cis
 @end menu
 
 @node Time signature
-@unnumberedsubsubsec Time signature
+@subsubsection Time signature
 
 @cindex time signature
 @cindex meter
@@ -849,7 +920,7 @@ The time signature is set with the @code{\time} command:
 \time 2/4 c2 \time 3/4 c2.
 @end lilypond
 
-@commonprop
+@snippets
 
 The symbol that is printed can be customized with the @code{style}
 property.  Setting it to @code{#'()} uses fraction style for 4/4
@@ -939,14 +1010,14 @@ Internals Reference: @internalsref{TimeSignature}, and
 Examples: @c @lsr{contemporary,compound-time-signature.ly}.
 
 
-@refbugs
+@knownissues
 
 Automatic beaming does not use the measure grouping specified with
 @code{set-time-signature}.
 
 
 @node Upbeats
-@unnumberedsubsubsec Upbeats
+@subsubsection Upbeats
 
 @cindex anacrusis
 @cindex upbeat
@@ -982,7 +1053,7 @@ that this is a negative number; @code{\partial 4} is internally
 translated to mean @qq{there is a quarter note left in the bar.}
 
 
-@refbugs
+@knownissues
 
 This command does not take into account grace notes at the start
 of the music.  When a piece starts with grace notes in the
@@ -1004,7 +1075,7 @@ occur.
 Snippets: @lsrdir{Rhythms,Rhythms}
 
 @node Unmetered music
-@unnumberedsubsubsec Unmetered music
+@subsubsection Unmetered music
 
 @cindex cadenza
 @funindex \cadenzaOn
@@ -1037,7 +1108,7 @@ c4 c d8 d d f4 g4.
 d4 e d c
 @end lilypond
 
-@refbugs
+@knownissues
 
 LilyPond will only insert line breaks and page breaks at a
 bar line.  Unless the unmetered music ends before the end of the
@@ -1056,7 +1127,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 
 
 @node Polymetric notation
-@unnumberedsubsubsec Polymetric notation
+@subsubsection Polymetric notation
 
 @cindex double time signatures
 @cindex signatures, polymetric
@@ -1181,7 +1252,7 @@ staff, shown durations are multiplied by 3/5, so that 3/5 * 10/8 =
 @end lilypond
 
 
-@refbugs
+@knownissues
 
 When using different time signatures in parallel, the spacing is
 aligned vertically, but bar lines distort the regular spacing.
@@ -1194,7 +1265,7 @@ Internals Reference: @internalsref{TimeSignature}, @internalsref{Timing-translat
 
 
 @node Automatic note splitting
-@unnumberedsubsubsec Automatic note splitting
+@subsubsection Automatic note splitting
 
 Long notes which overrun bar lines can be converted automatically
 to tied notes.  This is done by replacing the
@@ -1221,7 +1292,7 @@ If you want to allow line breaking on the bar lines where
 also remove @internalsref{Forbid_line_break_engraver}.
 
 
-@refbugs
+@knownissues
 
 Not all durations (especially those containing tuplets) can be
 represented exactly with normal notes and dots, but the engraver
@@ -1254,7 +1325,7 @@ Internals Reference: @internalsref{Note_heads_engraver},
 @end menu
 
 @node Automatic beams
-@unnumberedsubsubsec Automatic beams
+@subsubsection Automatic beams
 
 By default, beams are inserted automatically:
 
@@ -1288,7 +1359,7 @@ c16 c8
 @end lilypond
 
 
-@commonprop
+@snippets
 
 Beaming patterns may be altered with the @code{beatGrouping} property,
 
@@ -1371,7 +1442,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 Internals Reference: @internalsref{Beam}.
 
 
-@refbugs
+@knownissues
 
 Automatically kneed cross-staff beams cannot be used together with
 hidden staves.  See @ref{Hiding staves}.
@@ -1380,7 +1451,7 @@ Beams can collide with note heads and accidentals in other voices
 
 
 @node Setting automatic beam behavior
-@unnumberedsubsubsec Setting automatic beam behavior
+@subsubsection Setting automatic beam behavior
 
 @funindex autoBeamSettings
 @funindex (end * * * *)
@@ -1545,7 +1616,7 @@ If beams are used to indicate melismata in songs, then automatic
 beaming should be switched off with @code{\autoBeamOff}.
 
 
-@refcommands
+@predefined
 
 @funindex \autoBeamOff
 @code{\autoBeamOff},
@@ -1553,7 +1624,7 @@ beaming should be switched off with @code{\autoBeamOff}.
 @code{\autoBeamOn}.
 
 
-@refbugs
+@knownissues
 
 If a score ends while an automatic beam has not been ended and is
 still accepting notes, this last beam will not be typeset at all.
@@ -1567,7 +1638,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 
 
 @node Manual beams
-@unnumberedsubsubsec Manual beams
+@subsubsection Manual beams
 
 @cindex beams, manual
 
@@ -1617,10 +1688,10 @@ the group as a whole.
 @end lilypond
 
 
-@commonprop
+@snippets
 
 @node Feathered beams
-@unnumberedsubsubsec Feathered beams
+@subsubsection Feathered beams
 
 @cindex beams, feathered
 @funindex \featherDurations 
@@ -1667,7 +1738,7 @@ the last four 32nd notes are at a constant tempo.
 The spacing in the printed output represents the 
 note durations only approximately, but the midi output is exact.
 
-@refbugs
+@knownissues
 
 The @code{\featherDurations} command only works with very short
 music snippets, and when numbers in the fraction are small.
@@ -1690,7 +1761,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 @end menu
 
 @node Bar lines
-@unnumberedsubsubsec Bar lines
+@subsubsection Bar lines
 
 @cindex bar lines
 @funindex \bar
@@ -1810,7 +1881,7 @@ connected between different staves of a @code{StaffGroup},
 @end lilypond
 
 
-@commonprop
+@snippets
 
 @funindex whichBar
 @funindex defaultBarType
@@ -1827,7 +1898,8 @@ with @code{\set Timing.defaultBarType = }@var{bartype}.
 @seealso
 
 Notation Reference: @ref{Line breaking}, @ref{Repeats},
-@ref{System start delimiters}.
+@c FIXME: node name changed, but is subject to further changes.
+@c @ref{System start delimiters}.
 
 Snippets: @lsrdir{Rhythms,Rhythms}
 
@@ -1838,7 +1910,7 @@ properties).
 
 
 @node Bar numbers
-@unnumberedsubsubsec Bar numbers
+@subsubsection Bar numbers
 
 @cindex bar numbers
 @cindex measure numbers
@@ -1857,7 +1929,7 @@ c1 c c c
 @end lilypond
 
 
-@commonprop
+@snippets
 
 @funindex barNumberVisibility
 @cindex bar numbers, regular spacing
@@ -1976,7 +2048,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 Internals Reference: @internalsref{BarNumber}.
 
 
-@refbugs
+@knownissues
 
 Bar numbers may collide with the top of the
 @internalsref{StaffGroup} bracket, if there is one.  To solve
@@ -1999,7 +2071,7 @@ c1 c c c
 
 
 @node Bar and bar number checks
-@unnumberedsubsubsec Bar and bar number checks
+@subsubsection Bar and bar number checks
 
 @cindex bar check
 @funindex barCheckSynchronize
@@ -2072,7 +2144,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 
 
 @node Rehearsal marks
-@unnumberedsubsubsec Rehearsal marks
+@subsubsection Rehearsal marks
 
 @cindex rehearsal marks
 @cindex mark, rehearsal
@@ -2199,7 +2271,7 @@ Examples: @c @lsr{parts,rehearsal-mark-numbers.ly}
 @end menu
 
 @node Grace notes
-@unnumberedsubsubsec Grace notes
+@subsubsection Grace notes
 
 @funindex \grace
 @cindex ornaments
@@ -2330,7 +2402,7 @@ other situations by @code{\override Stem  #'stroke-style =
 #"grace"}.
 
 
-@commonprop
+@snippets
 
 Grace notes may be forced to use align with regular notes
 in other staves by setting @code{strict-grace-spacing} to
@@ -2367,12 +2439,12 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 Internals Reference: @internalsref{GraceMusic}.
 
 
-@refbugs
+@knownissues
 
 A multi-note beamed @emph{acciaccatura} is printed without a slash, 
 and looks exactly the same as a multi-note beamed
 @emph{appoggiatura}.
-@c TODO Add link to LSR snippet to add slash when available 
+@c TODO Add link to LSR snippet to add slash when available
 
 Grace note synchronization can also lead to surprises.  Staff
 notation, such as key signatures, bar lines, etc., are also
@@ -2398,7 +2470,7 @@ expressions.  Nesting or juxtaposing grace sections is not
 supported, and might produce crashes or other errors.
 
 @node Aligning to cadenzas
-@unnumberedsubsubsec Aligning to cadenzas
+@subsubsection Aligning to cadenzas
 
 @cindex cadenza
 @cindex cadenza, aligning to
@@ -2436,7 +2508,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 
 
 @node Time administration
-@unnumberedsubsubsec Time administration
+@subsubsection Time administration
 
 @cindex time administration
 @cindex timing (within the score)
@@ -2521,3 +2593,9 @@ Internals Reference: @internalsref{Timing_translator},
 
 
 
+
+
+
+
+
+