version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.65"
+@c \version "2.12.0"
@node Text
@section Text
@cindex non-empty texts
@cindex quoted text
-Simple @qq{quoted text} indications may be added
-to a score, as demonstrated in the following example.
-Such indications may be manually placed
-above or below the staff, using the
-syntax described in @ref{Direction and
-placement}.
+Simple @qq{quoted text} indications may be added to a score.
@lilypond[quote,verbatim,relative=2]
a8^"pizz." g f e a4-"scherz." f
a4_\markup { \tiny scherz. \bold molto } f
@end lilypond
+@qq{Quoted text} and @code{\markup} commands may be manually
+placed above or below the staff; see @ref{Direction and
+placement}.
+
By default, text indications do not influence the note spacing.
However, their widths can be taken into account:
in the following example, the first text string does not affect
The line style, as well as the text string, can be defined as an
object property. This syntax is described in @ref{Line styles}.
+Text spanners may be manually placed above or below the staff; see
+@ref{Direction and placement}.
+
@predefined
@funindex textSpannerUp
@seealso
Notation Reference:
@ref{Line styles},
-@ref{Dynamics}.
+@ref{Dynamics},
+@ref{Direction and placement}.
Snippets:
@rlsr{Text}.
Encapsulated PostScript format (@emph{eps}), or
to directly embed graphics into the input file,
using native PostScript code. In such a case, it
-may be useful to explicitely specify the size of the
+may be useful to explicitly specify the size of the
drawing, as demonstrated below:
@lilypond[quote,verbatim,relative=1]
c2^\markup { \musicglyph #"timesig.neomensural94" }
@end lilypond
-@c TODO: add \lookup here? -vv
-@c Probably better not to document \lookup, which is useful only for
-@c printing braces, and instead document \left-brace and \right-brace
-@c when these become available -td
-
@noindent
-Another way of printing non-text glyphs is described
-in @ref{Fonts explained}.
+Another way of printing non-text glyphs is described in
+@ref{Fonts explained}. This is useful for printing braces of
+various sizes.
The markup mode also supports diagrams for specific
instruments:
@cindex Pango
@cindex fonts, explained
+@cindex braces, various sizes
@funindex font-interface
Fonts are handled through several libraries.
@end lilypond
@noindent
-A simpler, but more limited syntax is also described in
-@ref{Music notation inside markup}.
+However, all these glyphs except the braces of various sizes
+contained in @code{fetaBraces} are available using the
+simpler syntax described in @ref{Music notation inside markup}.
+
+When using the glyphs contained in @code{fetaBraces}, the size of
+the brace is specified by the numerical part of the glyph name, in
+arbitrary units. Any integer from @code{0} to @code{575} inclusive
+may be specified, @code{0} giving the smallest brace. The optimum
+value must be determined by trial and error. These glyphs are all
+left braces; right braces may be obtained by rotation, see
+@ref{Rotating objects}.
Three families of text fonts are made available: the
@emph{roman} (serif) font, that defaults to New Century