X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Ftext.itely;h=43f4e942278624dff03208331c3bac84febbc0e2;hb=b486cb8f17cf0281a20e0a7e5fa1afd5226f19a8;hp=a88f8f35c144e66719f586a1dcb8a12e3ef47982;hpb=155bcf40d39904ee495a8019828540c855c66ca3;p=lilypond.git diff --git a/Documentation/user/text.itely b/Documentation/user/text.itely index a88f8f35c1..43f4e94227 100644 --- a/Documentation/user/text.itely +++ b/Documentation/user/text.itely @@ -6,7 +6,7 @@ version that you are working on. See TRANSLATION for details. @end ignore -@c \version "2.11.38" +@c \version "2.11.51" @node Text @section Text @@ -53,20 +53,20 @@ This section introduces different ways of adding text to a score. @cindex Text scripts @cindex text items, non-empty @cindex non-empty texts +@cindex quoted text -It is possible to add arbitrary text indications +Simple @q{quoted text} indications may be added to a score, as demonstrated in the following example. -Such indications can also be manually placed +Such indications can be manually placed above or below the staff, using the -simple syntax described in @ref{Controlling direction and +syntax described in @ref{Direction and placement}. @lilypond[quote,fragment,ragged-right,verbatim,relative=1] d8^"pizz." e f g a4-"scherz." f @end lilypond -In LilyPond, such text strings are called @command{markup} -objects. This syntax is actually a shorthand; more complex text +This syntax is actually a shorthand; more complex text formatting may be added to a note by explicitly using a @code{\markup} block, as described in @ref{Formatting text}. @@ -81,7 +81,9 @@ in the following example, the first text string does not affect spacing, whereas the second one does. @lilypond[quote,fragment,ragged-right,verbatim,relative=1] -d8^"pizz." e f g \textLengthOn a4_"scherzando" f +d8^"pizz." e f g +\textLengthOn +a4_"scherzando" f @end lilypond @predefined @@ -95,11 +97,12 @@ d8^"pizz." e f g \textLengthOn a4_"scherzando" f @seealso Notation Reference: @ref{Formatting text}, -@ref{Controlling direction and placement}. +@ref{Direction and placement}. -Snippets: @lsrdir{Text,Text} +Snippets: +@rlsr{Text}. -Internals Reference: @internalsref{TextScript}. +Internals Reference: @rinternals{TextScript}. @knownissues @@ -118,12 +121,11 @@ default; to enable it, use @cindex Text spanners -Some performance indications, e.g., @i{rallentando} or -@i{accelerando}, are written as text and are extended over many -measures with dotted lines. - +Some performance indications, e.g., @notation{rallentando} or +@notation{accelerando}, are written as text and are extended over +multiple notes with dotted lines. Such objects, called @q{spanners}, may be created -from one note to another by using the following syntax: +from one note to another using the following syntax: @lilypond[verbatim,quote,ragged-right,fragment,relative=2] \override TextSpanner #'bound-details #'left #'text = "rit." @@ -133,9 +135,9 @@ e,\stopTextSpan @noindent The string to be printed is set through -object properties. By default it is printed in italic characters, +object properties. By default it is printed in italic characters, but different formatting can be obtained using -@code{\markup} blocks: +@code{\markup} blocks, as described in @ref{Formatting text}. @lilypond[quote,ragged-right,fragment,relative=2,verbatim] \override TextSpanner #'bound-details #'left #'text = @@ -145,7 +147,7 @@ e,\stopTextSpan @end lilypond The line style, as well as the text string, can be defined as an -object property. This syntax is described in @ref{Line styles}. +object property. This syntax is described in @ref{Line styles}. @predefined @@ -160,9 +162,10 @@ object property. This syntax is described in @ref{Line styles}. Notation Reference: @ref{Line styles}. -Snippets: @lsrdir{Text,Text} +Snippets: +@rlsr{Text}. -Internals Reference: @internalsref{TextSpanner}. +Internals Reference: @rinternals{TextSpanner}. @node Text marks @@ -177,44 +180,51 @@ Internals Reference: @internalsref{TextSpanner}. Various text elements can be added to a score using the syntax described in @ref{Rehearsal marks}: +@c \mark needs to be placed on a separate line (it's not +@c attached to an object like \markup is). -vv + @lilypond[verbatim,quote,ragged-right,fragment,relative=2] -c4\mark "dolce" c c c +c4 +\mark "Allegro" +c c c @end lilypond -This syntax makes possible to put any text on a bar line; +This syntax makes it possible to put any text on a bar line; more complex text formatting may be added using a @code{\markup} block, as described in @ref{Formatting text}. This can be used to print signs like coda, segno or fermata, by specifying the appropriate symbol name: @lilypond[fragment,quote,ragged-right,verbatim,relative=2] -c1 \mark \markup { \musicglyph #"scripts.ufermata" } +c1 +\mark \markup { \musicglyph #"scripts.ufermata" } c1 @end lilypond @noindent -Such objects are only typeset above the top staff of the score; they -can be placed above the bar line or between notes, depending on whether -you specify it at the end or the middle of a bar. When specified at the -beginning of a score or at a line break, the mark will be printed at +Such objects are only typeset above the top staff of the score; depending on +whether they are specified at the end or the middle of a bar, they +can be placed above the bar line or between notes. When specified at the +beginning of a score or at a line break, marks will be printed at the beginning of the line (the next line, in case of a line break). @lilypond[fragment,quote,ragged-right,verbatim,relative=2] -\mark "dolce" c1 -c\mark "assai" \break -c c +\mark "Allegro" +c1 c +\mark "assai" \break +c c @end lilypond @snippets -@lilypondfile[verbatim,lilyquote,ragged-right,texidoc] +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] {printing-marks-at-the-end-of-a-line-or-a-score.ly} -@lilypondfile[verbatim,lilyquote,ragged-right,texidoc] +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] {aligning-marks-with-various-notation-objects.ly} -@lilypondfile[verbatim,lilyquote,ragged-right,texidoc] +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] {printing-marks-on-every-staff.ly} @seealso @@ -222,14 +232,13 @@ c c Notation Reference: @ref{Rehearsal marks}, @ref{Formatting text}, @ref{The Feta font}. -Snippets: @lsrdir{Text,Text} +Snippets: +@rlsr{Text}. -Internals Reference: @internalsref{RehearsalMark}. +Internals Reference: @rinternals{RehearsalMark}. @knownissues -@c IMO this is a bug; hopefully it'll be fixed soon, so I can -@c delete this sentence. -gp -@c A workaround is suggested in the first @snippets item -vv +@c To be removed when Issue 69 in the tracker gets fixed. -vv If a mark is entered at the end of the last bar of the score (where there is no next line), then the mark will not be printed at @@ -245,67 +254,63 @@ all. @funindex \markup A @code{\markup} block can exist by itself, outside of any -any @code{\score} block. This syntax is called a @q{top-level -expression}, and is described in @code{File structure}. - -@c TODO: turn this into a @lilypond example +any @code{\score} block, as a @qq{top-level +expression}. This syntax is described in @ref{File structure}. -@example -\markup @{ - @var{..} -@} -@end example +@lilypond[verbatim,quote] +\markup { + Tomorrow, and tomorrow, and tomorrow... +} +@end lilypond @noindent -This allows to print text separately +This allows printing text separately from the music, which is particularly useful when the input file contains several music pieces, as described in @ref{Multiple scores in a book}. -@example -\score @{ - @var{..} -@} -\markup @{ - @var{..} -@} -\score @{ - @var{..} -@} -@end example +@lilypond[quote,ragged-right,verbatim] +\score { + c'1 +} +\markup { + Tomorrow, and tomorrow, and tomorrow... +} +\score { + c'1 +} +@end lilypond Using a specific syntax, text blocks can be spread over multiple pages, making possible to print text documents or books -- and therefore to use LilyPond as a word processor. This syntax is described in -@ref{Multi-pages markup}. +@ref{Multi-page markup}. + +@predefined + +@code{\markup}, +@funindex \markuplines +@code{\markuplines} @ignore @snippets -TODO: add convenient snippets, e.g. -"Inserting large plain text sections" -(this requires the LSR to be updated) -vv +TODO: add convenient snippets in input/new -vv @end ignore @seealso -Notation Reference: @code{Formatting text}, -@code{File structure}, +Notation Reference: @ref{Formatting text}, +@ref{File structure}, @ref{Multiple scores in a book}, -@ref{Multi-pages markup}. +@ref{Multi-page markup}. -Snippets: @lsrdir{Text,Text}. +Snippets: +@rlsr{Text}. -Internals Reference: @internalsref{TextScript}. - -@predefined - -@funindex \markup -@code{\markup}, -@funindex \markuplines -@code{\markuplines} +Internals Reference: @rinternals{TextScript}. @node Formatting text @@ -316,11 +321,11 @@ using the @code{\markup} mode specific syntax. @menu * Text markup introduction:: -* Common markup commands:: +* Selecting font and font size:: * Text alignment:: * Graphic notation inside markup:: * Music notation inside markup:: -* Multi-pages markup:: +* Multi-page markup:: @end menu @node Text markup introduction @@ -330,186 +335,531 @@ using the @code{\markup} mode specific syntax. @cindex text markup @cindex markup text @cindex typeset text +@funindex \markup + +A @code{\markup} block is used to typeset text with an extensible +specific syntax called @qq{markup mode}. + +@cindex markup expressions +@cindex markup syntax -A @code{\markup} block is used to typeset text with an extensible syntax, -called @q{markup mode}. -Specific commands can be entered in this mode, using the -backslash @code{\} character. -@c TODO: move the following sentence (and add an example?) -vv -To @emph{print} such characters as -@code{\} and @code{#} in the output, use double -quotation marks. +The markup syntax is similar to LilyPond's usual syntax: a +@code{\markup} expression is enclosed in curly braces @code{@{ +@dots{} @}}. + +Unlike simple @q{quoted text} indications, @code{\markup} blocks +may contain nested expressions or specific commands, +entered using the backslash @code{\} character. +Such commands only affect the first following expression. @lilypond[quote,verbatim,fragment,relative=1] -c1^\markup { hello } -c1_\markup { hi there } -c1^\markup { hi \bold there, is \italic {anyone home?} } -c1_\markup { "\special {weird} #characters" } +e1-\markup "intenso" +a2^\markup { poco \italic più forte } +c e1 +d2_\markup { \italic "string. assai" } +e +b1^\markup { \bold { molto \italic agitato } } +c @end lilypond +@cindex special characters in markup mode +@cindex markup mode, special characters +@cindex reserved characters, printing +@cindex printing special characters +@cindex quoted text in markup mode + +A @code{\markup} block may also contain quoted text, which +can be useful to print special characters such as @code{\} and @code{#}, +or even double quotation marks -- these have to be preceded +with backslashes: + +@lilypond[quote,verbatim,fragment,relative=1] +\clef bass +a^\markup "##\ LEPORELLO \##" +a_\markup "Bravi! \"Cosa rara\"!" +r a8 d +cis a r4 r2 +@end lilypond + +The way markup expressions are defined affects +how these expressions will stacked, centered and aligned +when using the commands explained in @ref{Text alignment}. + +@lilypond[quote,verbatim,fragment,relative=1] +c1^\markup { \column { a bbbb \line { c d } } } +c1^\markup { \center-align { a bbbb c } } +c1^\markup { \line { a b c } } +@end lilypond + +Lists of words that are not enclosed with double quotes +or preceded by a command are not treated as a distinct +expression. In the following example, the first two +@code{\markup} expressions are equivalent: + +@lilypond[quote,verbatim,fragment,relative=1] +c1^\markup { \center-align { a bbb c } } +c1^\markup { \center-align { a { bbb c } } } +c1^\markup { \center-align { a \line { bbb c } } } +@end lilypond + + +Markups can be stored in variables. These variables may be +directly attached to notes: + +@lilypond[quote,verbatim] +allegro = \markup { \bold \large Allegro } + +{ + d''8.^\allegro + d'16 d'4 r2 +} +@end lilypond + + @noindent An exhaustive list of @code{\markup}-specific commands can be found in @ref{Text markup commands}. -@code{\markup} blocks can be used anywhere text is called, -and not only for @internalsref{TextScript}s objects. -@lilypond[quote,verbatim] -\header{ title = \markup{ \bold { foo \italic { bar! } } } } -\score{ - \relative c'' { - \override Score.RehearsalMark - #'break-visibility = #begin-of-line-invisible - \override Score.RehearsalMark #'self-alignment-X = #right - - \set Staff.instrumentName = \markup{ \column{ Alto solo } } - c2^\markup{ don't be \flat } - \override TextSpanner #'bound-details #'left #'text = \markup{\italic rit } - b2\startTextSpan - a2\mark \markup{ \large \bold Fine } - r2\stopTextSpan - \bar "||" +@seealso + +This manual: @ref{Text markup commands}. + +Snippets: +@rlsr{Text}. + +Internals Reference: @rinternals{TextScript}. + +Init files: @file{scm/@/new@/-markup@/.scm}. + + +@knownissues + +Syntax errors for markup mode can be confusing. + + +@node Selecting font and font size +@subsubsection Selecting font and font size + +@cindex font switching +@funindex \italic +@funindex \bold +@funindex \underline + +Basic font switching is supported in markup mode: + +@lilypond[quote,verbatim,relative=2] +{ + d1^\markup { + \bold { Più mosso } + \italic { non troppo \underline Vivo } } - \addlyrics { bar, foo \markup{ \italic bar! } } + r2 r4 r8 + d,_\markup { \italic quasi \smallCaps Tromba } + f1 d2 r } @end lilypond -A @code{\markup} block can also be printed on its own at the top-level -of the input file, away from -any @code{\score} block. This syntax is described in -@ref{Multiple scores in a book}. +@cindex font size +@cindex text size +@funindex \fontsize +@funindex \smaller +@funindex \larger +@funindex \bigger +@funindex \magnify + +The size of the characters can also be altered in different ways: +@itemize +@item +the font size can be defined to an absolute value, -@lilypond[quote,ragged-right,verbatim] -\markup{ Here is some text. } +@item +predefined commands allow to easily select standard sizes, + +@item +the font size can also be changed relatively to its previous value. +@end itemize + +@noindent +The following example demonstrates these three methods: + +@lilypond[quote,verbatim,relative=2] +{ + f1^\markup { \fontsize #5 Sinfonia } + a,_\markup { + \tiny espressivo + \large e + \normalsize intenso + } + bes^\markup { (con + \larger grande + \smaller emozione + \magnify #0.6 { e sentimento } ) + } + d c2 r8 c bes a g1 +} @end lilypond -@cindex font switching +@cindex subscript +@cindex superscript +@funindex \super +@funindex \sub -Some font switching commands are demonstrated here. Such commands -apply only to the first following word; several words may be affected -by enclosing them in braces. +Text may be printed as subscript or superscript. By default +these are printed in a smaller size, but a normal size can be used as well: -@example -\markup @{ \bold @{ hi there @} @} -@end example +@lilypond[quote,verbatim] +\markup { + \column { + \line { 1 \super st movement } + \line { 1 \normal-size-super st movement + \sub { (part two) } } + } +} +@end lilypond + +@cindex font families + +The markup mode provides an easy way to select alternate +font families. The default serif font, of roman type, is +automatically selected unless specified otherwise: on the +last line of the following example, there is no difference +between the first and the second word. + +@lilypond[quote,verbatim] +\markup { + \column { + \line { Act \number 1 } + \line { \sans { Scene I. } } + \line { \typewriter { Verona. An open place. } } + \line { Enter \roman Valentine and Proteus. } + } +} +@end lilypond -@c TODO: remove the following line and example? -vv @noindent -For clarity, you can also do this for single arguments, e.g., +Some of these font families, used for specific items +such as numbers or dynamics, do not provide all +characters, as mentioned in @ref{New dynamic marks} and +@ref{Manual repeat marks}. -@example -\markup @{ is \italic @{ anyone @} home @} -@end example +@c \concat is actually documented in Align (it is not +@c a font-switching command). But we need it here. -vv -The markup mode can be used to compose expressions, similar to -mathematical expressions, XML documents, and music expressions. -Such expressions can be vertically stacked, horizontally centered, -or aligned in different ways: +When used inside a word, some font-switching or formatting +commands may produce an unwanted blank space. This can +easily be solved by concatenating the text elements together: -@lilypond[quote,verbatim,fragment,relative=1] -c1^\markup { \column { a bbbb \line { c d } } } -c1^\markup { \center-align { a bbbb c } } -c1^\markup { \line { a b c } } +@lilypond[quote,verbatim] +\markup { + \column { + \line { + \concat { 1 \super st } + movement + } + \line { + \concat { \dynamic p , } + \italic { con dolce espressione } + } + } +} @end lilypond -Lists with no previous command are not kept distinct. In -the following example, the two @code{\markup} expressions -are equivalent: +An exhaustive list of font-switching, font-size +and font-families related commands can be found in @ref{Font}. -@c TODO: merge these two examples in a @lilypond example -vv +Defining custom font sets is also possible, as explained in +@ref{Fonts}. -@example -\center-align @{ @{ a b @} @{ c d @} @} -\center-align @{ a b c d @} -@end example +@predefined -@noindent +@funindex \teeny +@funindex \tiny +@funindex \small +@funindex \normalsize +@funindex \large +@funindex \huge +@code{\teeny}, +@code{\tiny}, +@code{\small}, +@code{\normalsize}, +@code{\large}, +@code{\huge}. -To keep lists of words distinct, please use quotes @code{"} or -the @code{\line} command +@c TODO: add @seealso -@lilypond[quote,verbatim,fragment,relative=1] -\textLengthOn -c4^\markup{ \center-align { on three lines } } -c4^\markup{ \center-align { "all one line" } } -c4^\markup{ \center-align { { on three lines } } } -c4^\markup{ \center-align { \line { on one line } } } -@end lilypond -Markups can be stored in variables and these variables may be -attached to notes, like +@node Text alignment +@subsubsection Text alignment -@example -allegro = \markup @{ \bold \large @{ Allegro @} @} - @{ a^\allegro b c d @} -@end example +@cindex text, aligning +@cindex aligning text + +This subsection discusses how to place text in markup mode, +inside a @code{\markup} block. Markup objects can also +be moved as a whole, using the syntax described in +@rlearning{Moving objects}. + +@c The padding commands should be mentioned on this page, but +@c most of these require \box to be more clearly illustrated. -vv -Some objects have alignment procedures of their own, which cancel -out any effects of alignments applied to their markup arguments as -a whole. For example, the @internalsref{RehearsalMark} is -horizontally centered, so using @code{\mark \markup @{ \left-align -.. @}} has no effect. +@cindex text, horizontal alignment +@cindex horizontal text alignment +@funindex \left-align +@funindex \hcenter +@funindex \right-align -In addition, vertical placement is performed after creating the -text markup object. If you wish to move an entire piece of -markup, you need to use the #'padding property or create an -@q{anchor} point inside the markup (generally with @code{\hspace -#0}). +Markup objects may be aligned in different ways. By default, +a text indication is aligned on its left edge: in the following +example, there's no difference +between the first and the second markup. @lilypond[quote,verbatim,fragment,relative=1] -\textLengthOn -c'4^\markup{ \raise #5 "not raised" } -\once \override TextScript #'padding = #3 -c'4^\markup{ raised } -c'4^\markup{ \hspace #0 \raise #1.5 raised } +a1-\markup { poco } +e' +a,-\markup { \left-align poco } +e' +a,-\markup { \hcenter { poco } } +e' +a,-\markup { \right-align poco } @end lilypond -Some situations (such as dynamic marks) have preset font-related -properties. If you are creating text in such situations, it is -advisable to cancel those properties with @code{normal-text}. See -@ref{Text markup commands}, for more details. +@funindex \halign +The horizontal alignment may be fine-tuned +using a numeric value: -@seealso +@lilypond[quote,verbatim,fragment,relative=1] +a1-\markup { \halign #-1 poco } +e' +a,-\markup { \halign #0 poco } +e' +a,-\markup { \halign #0.5 poco } +e' +a,-\markup { \halign #2 poco } +@end lilypond -This manual: @ref{Text markup commands}. +@noindent +Some objects may have alignment procedures of their own, +and therefore are not affected by these commands. It is +possible to move such markup objects as a whole, as shown +for instance in @ref{Text marks}, + +@cindex text, vertical alignment +@cindex vertical text alignment +@funindex \raise +@funindex \lower + +Vertical alignment is a bit more complex. As stated above, +markup objects can be moved as a whole; however, it is also +possible to move specific elements inside a markup block. +In this case, the element to be moved needs to be preceded +with an @emph{anchor point}, that can be another markup element +or an invisible object. The following example demonstrates these +two possibilities; the last markup in this example has no anchor +point, and therefore is not moved. -Snippets: @lsrdir{Text,Text} +@lilypond[quote,verbatim,fragment,relative=1] +d2^\markup { + Acte I + \raise #2 { Scène 1 } } +a' +g_\markup { + \null + \lower #4 \bold { Très modéré } } +a +d,^\markup { + \raise #4 \italic { Une forêt. } } +a'4 a g2 a +@end lilypond -Internals Reference: @internalsref{TextScript}. +@funindex \general-align +@funindex \translate +@funindex \translate-scaled -Init files: @file{scm/@/new@/-markup@/.scm}. +Some commands can affect both the horizontal and vertical +alignment of text objects in markup mode. Any object +affected by these commands must be preceded with an +anchor point: +@lilypond[quote,verbatim,fragment,relative=1] +d2^\markup { + Acte I + \translate #'(-1 . 2) "Scène 1" } +a' +g_\markup { + \null + \general-align #Y #3.2 \bold "Très modéré" } +a +d,^\markup { + \null + \translate-scaled #'(-1 . 2) \teeny "Une forêt." } +a'4 a g2 a +@end lilypond -@knownissues +@cindex multi-line markup +@cindex multi-line text +@cindex columns, text -Kerning or generation of ligatures is only done when the @TeX{} -backend is used. In this case, LilyPond does not account for them -so texts will be spaced slightly too wide. +A markup object may include several lines of text. +In the following example, each element or expression +is placed on its own line, either left-aligned or centered: -Syntax errors for markup mode are confusing. +@lilypond[quote,verbatim] +\markup { + \column { + a + "b c" + \line { d e f } + } + \hspace #10 + \center-align { + a + "b c" + \line { d e f } + } +} +@end lilypond -@node Common markup commands -@subsubsection Common markup commands +Similarly, a list of elements or expressions may be +spread to fill the entire horizontal line width -- if there +is only one element, it will be centered on the page. +These expressions can, in turn, include multi-line text +or any other markup expression: -TODO: everything +@lilypond[quote,verbatim] +\markup { + \fill-line { + \line { William S. Gilbert } + \center-align { + \huge \smallCaps "The Mikado" + or + \smallCaps "The Town of Titipu" + } + \line { Sir Arthur Sullivan } + } +} +\markup { + \fill-line { 1885 } +} +@end lilypond -@node Text alignment -@subsubsection Text alignment +Long text indications can also be automatically wrapped +accordingly to the given line width. These will be +either left-aligned or justified, as shown in +the following example. -TODO: everything +@lilypond[quote,verbatim] +\markup { + \column { + \line \smallCaps { La vida breve } + \line \bold { Acto I } + \wordwrap \italic { + (La escena representa el corral de una casa de + gitanos en el Albaicín de Granada. Al fondo una + puerta por la que se vé el negro interior de + una Fragua, iluminado por los rojos resplandores + del fuego.) + } + \hspace #0 + + \line \bold { Acto II } + \override #'(line-width . 50) + \justify \italic { + (Calle de Granada. Fachada de la casa de Carmela + y su hermano Manuel con grandes ventanas abiertas + a través de las que se ve el patio + donde se celebra una alegre fiesta) + } + } +} +@end lilypond + +An exhaustive list of text alignment commands +can be found in @ref{Align}. + +@c TODO: add @seealso @node Graphic notation inside markup @subsubsection Graphic notation inside markup -TODO: everything +Graphics around text: +\box +\circle + +(TODO: document padding commands here) + +\bracket +\hbracket + +"Standalone" graphics: + +\arrow-head +\draw-line +\draw-circle +\filled-box +\triangle +\strut + +\with-color + + +Advanced graphics: +\stencil + +\postscript +\epsfile + +\with-dimensions @node Music notation inside markup @subsubsection Music notation inside markup -It is possible to nest music inside markups, by adding a -@code{\score} block to a markup expression. Such a score must -contain a @code{\layout} block. +Notes can be printed in markup mode blah blah: + +\note +\note-by-number + +Accidental symbols can be obtained easily: + +\doubleflat +\sesquiflat +\flat +\semiflat +\natural +\semisharp +\sharp +\sesquisharp +\doublesharp + +Some other notation objects blah blah + +\beam +\finger +\dynamic +\tied-lyric +\markalphabet +\markletter +@c TODO: add \text here? -vv + +Any musical symbol can be printed + +\musicglyph +@c TODO: add \lookup here? -vv + + +The markup mode has support for fret diagrams: + +\fret-diagram +\fret-diagram-terse +\fret-diagram-verbose + +An entire @code{\score} block can even be nested in a @code{\markup} +block. In such a case, the @code{\score} must contain a @code{\layout} block. + + +\score + @lilypond[quote,verbatim,ragged-right] \relative { @@ -525,10 +875,11 @@ contain a @code{\layout} block. @seealso -Snippets: @lsrdir{Text,Text} +Snippets: +@rlsr{Text}. -@node Multi-pages markup -@subsubsection Multi-pages markup +@node Multi-page markup +@subsubsection Multi-page markup Whereas @code{\markup} is used to enter a non-breakable block of text, @code{\markuplines} can be used at top-level to enter lines @@ -558,7 +909,8 @@ lists. The built-in markup list commands are described in This manual: @ref{Text markup list commands}, @ref{New markup list command definition}. -Snippets: @lsrdir{Text,Text} +Snippets: +@rlsr{Text}. @predefined @@ -566,9 +918,6 @@ Snippets: @lsrdir{Text,Text} @code{\markuplines} - -@c TODO: move the following subsubsec into NR3 -vv -@c maybe. -gp @node Fonts @subsection Fonts @@ -692,6 +1041,7 @@ property. The resulting size is taken relative to the @seealso -Snippets: @lsrdir{Text,Text} +Snippets: +@rlsr{Text}.