]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/refman.itely
(Rehearsal marks): document new
[lilypond.git] / Documentation / user / refman.itely
index c8bd6b2f17ee7822283002f39b2c2c90a25c1bc6..e31a01ee227f0d1a320a334907c1aefee522f85b 100644 (file)
@@ -356,10 +356,6 @@ direction manually:
 
 Internals: @internalsref{Dots}, and @internalsref{DotColumn}. 
 
-@refbugs
-
-In dense chords, dots can overlap.
-
 @node Stems
 @subsection Stems
 
@@ -504,10 +500,16 @@ instead.
 
 Internals: @internalsref{TupletBracket}, and @internalsref{TimeScaledMusic}.
 
+Examples: @inputfileref{input/regression,tuplet-nest.ly}.
+
 @refbugs
 
 Nested tuplets are not formatted automatically.  In this case, outer
-tuplet brackets should be moved manually.
+tuplet brackets should be moved manually, which is demonstrated in
+@inputfileref{input/regression,tuplet-nest.ly}.
+
+
+
 
 @node Easy Notation note heads
 @subsection Easy Notation note heads
@@ -643,9 +645,12 @@ octave should be.  In the following example,
 @end example
 
 @noindent
-the @code{d} will generate a warning, because a @code{d''} is
-expected, but a @code{d'} is found.  In the output, the octave is
-corrected this and the following notes.
+@c take care with @code, adds confusing quotes.
+the d will generate a warning, because a d'' is expected, but a d' is
+found.  In the output, the octave is corrected this and the following
+notes.
+
+
 
 There is also a syntax that is separate from the notes.
 @example
@@ -2149,7 +2154,7 @@ Internals: @internalsref{ScriptEvent}, and @internalsref{Script}.
 
 @refbugs
 
- These note ornaments appear in the printed output but have no
+These note ornaments appear in the printed output but have no
 effect on the MIDI rendering of the music.
 
 
@@ -2373,8 +2378,6 @@ Internals: @internalsref{GraceMusic}.
 
 @refbugs
 
-Grace notes cannot be used in the smallest size (@file{paper11.ly}).
-
 A score that starts with an @code{\grace} section needs an explicit
 @code{\context Voice} declaration, otherwise the main note and grace
 note end up on different staves.
@@ -2392,9 +2395,6 @@ Grace sections should only be used within sequential music
 expressions.  Nesting or juxtaposing grace sections is not supported,
 and might produce crashes or other errors.
 
-Overriding settings cannot be done in separate styles for appoggiatura
-and acciaccatura.
-
 
 @node Glissando
 @subsection Glissando
@@ -3136,7 +3136,8 @@ handle this cross-staffing behavior.  In this section we discuss the
 There is no support for putting chords across staves.  You can get
 this result by increasing the length of the stem in the lower stave so
 it reaches the stem in the upper stave, or vice versa. An example is
-included with the distribution as @inputfileref{input/test,stem-cross-staff.ly}.
+included with the distribution as
+@inputfileref{input/test,stem-cross-staff.ly}.
 
 Dynamics are not centered, but kludges do exist. See
 @inputfileref{input/template,piano-dynamics.ly}.
@@ -3546,8 +3547,7 @@ Examples: @inputfileref{input/template,satb.ly},
  
 @refbugs
 
-@code{\lyricsto} is not automatic enough: melismata are not detected
-automatically, and melismata are not stopped when they hit a rest.
+Melismata are not detected automatically, and must be inserted by hand.
 
 
 @node More stanzas
@@ -4180,17 +4180,44 @@ for the score.
 To print a  rehearsal mark, use the @code{\mark} command:
 @lilypond[fragment,verbatim]
 \relative c'' {
-  c1 \mark "A"
-  c1 \mark "B"
-  c1 \mark "12"
-  c1 \mark "13"
-  c1
+  c1 \mark \default
+  c1 \mark \default
+  c1 \mark #8 
+  c1 \mark \default
+  c1 \mark \default
 }
 @end lilypond
 
+@noindent
+(The letter I is skipped in accordance with engraving traditions.)
+
 The mark is incremented automatically if you use @code{\mark
-\default}. The value to use is stored in the property
-@code{rehearsalMark} is used and automatically incremented.
+\default}, but you can also use an integer argument to set the mark
+manually.  The value to use is stored in the property
+@code{rehearsalMark}.
+
+The style is defined by the property @code{markFormatter}. It is a
+function taking the current mark (an integer) and the current context
+as argument. It should return a markup object. In the following
+example, @code{markFormatter} is set to a canned procedure. After a
+few measures, it is set to function that produces a boxed number. 
+
+@lilypond[verbatim,fragment,relative 1]
+  \property Score.markFormatter = #format-mark-numbers 
+  c1 \mark \default
+  c1 \mark \default
+  \property Score.markFormatter
+    = #(lambda (mark  context)
+       (make-bold-markup (make-box-markup (number->string mark))))
+  c1 \mark \default
+  c1 \mark \default
+@end lilypond
+
+The file @file{scm/translation-functions.scm} contains the definitions
+of @code{format-mark-numbers} (the default format) and
+@code{format-mark-letters}. They can be used as inspiration for other
+formatting functions.
+
 
 @cindex coda on bar line
 @cindex segno on bar line
@@ -4206,17 +4233,14 @@ to access the appropriate symbol:
   c1
 @end lilypond
 
-In this case, during line breaks,
-marks must also be printed at the end of the line, and not at the
-beginning. Use the following to force that behavior:
+In this case, during line breaks, marks must also be printed at the
+end of the line, and not at the beginning. Use the following to force
+that behavior:
 @example
 \property Score.RehearsalMark \override
   #'break-visibility = #begin-of-line-invisible
 @end example
 
-See @inputfileref{input/test,boxed-molecule.ly} for putting boxes
-around the marks.
-
 @cindex fermatas
 @cindex coda
 @cindex segno
@@ -4226,7 +4250,13 @@ around the marks.
 
 Internals: @internalsref{MarkEvent}, @internalsref{RehearsalMark}
 
-Examples: @inputfileref{input/test,boxed-molecule.ly}.
+Init files: @file{scm/translation-functions.scm} contains the
+definition of @code{format-mark-numbers} and
+@code{format-mark-letters}. They can be used as inspiration for other
+formatting functions.
+
+Examples: @inputfileref{input/regression,rehearsal-mark-letter.ly},
+@inputfileref{input/regression,rehearsal-mark-number.ly}.
 
 
 @node Bar numbers
@@ -8008,7 +8038,7 @@ added to LilyPond.
 @refbugs
 
 There is no style sheet provided for other fonts besides the @TeX{}
-family.
+Computer Modern family.
 
 @cindex font selection
 @cindex font magnification
@@ -8140,18 +8170,18 @@ respectively.
   This is converted to a musical symbol, e.g. @code{\musicglyph
 #"accidentals-0"} will select the natural sign from the music font.
 See @ref{The Feta font} for  a complete listing of the possible glyphs.
+
 @item \char
 This produces a single character, e.g. @code{\char #65} produces the 
 letter 'A'.
 
-@item \note  @var{log} @var{dots} @var{dir}
+@item \note  @var{duration} @var{dir}
 @cindex @code{\note}
 
 This produces a note with a stem pointing in @var{dir} direction, with
-duration log @var{log} and @var{dots} augmentation dots. The duration
-log is the negative 2-logarithm of the duration denominator. For
-example, a quarter note has log 2, an eighth note 3 and a breve has
-log -1.
+the @var{duration} for the note head type and augmentation dots. For
+example, @code{\note #"4." #-0.75} creates a dotted quarter note, with
+a shortened down stem.
 
 @item \hspace #@var{amount}
 @cindex @code{\hspace}