1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
6 @macro inputfileref{DIR,NAME}
7 @uref{../../\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
9 @macro usermanref{NAME}
10 @inforef{\NAME\,,../user/lilypond/lilypond}@c
15 @macro inputfileref{DIR,NAME}
18 @macro usermanref{NAME}
19 See user manual, \NAME\
23 @macro textanchor{NAME}
30 @documentencoding utf-8
39 @unnumbered New features in 2.11 since 2.10
42 This document is also available in @uref{NEWS.pdf,PDF}. It's part of
43 the @uref{../,LilyPond Documentation} .
55 * only show verbatim input for syntax/input changes
57 * try to be as brief possible in those cases
59 * don't try to provide real-world examples, they often get too big,
60 which scares away people.
62 * Write complete sentences.
64 * only show user-visible changes.
69 Enclosing text within boxes with rounded corners is now possible,
70 using the @code{rounded-box} command.
73 @command{lilypond-book} can run any program instead of @command{latex}
74 to guess the line width, thanks to @code{--latex} command line option.
77 @code{\setEasyHeads} has been renamed to @code{\easyHeadsOn}, and a new
78 command @code{\easyHeadsOff} reverts note heads to normal heads.
81 @code{\fatText} and @code{\emptyText} have been renamed to
82 @code{\textLengthOn} and @code{\textLengthOff}, respectively.
85 Underlining is now possible with the @code{\underline} markup command.
88 It is now possible to specify, using the @code{page-count} variable in
89 the paper block, the number of pages that will be used.
92 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
93 to books with many pages or a lot of texts.
96 A table of contents is included using @code{\markuplines \table-of-contents}.
97 Elements are added to it using the @code{\tocItem} command.
100 Text spreading over several pages is entered using the
101 @code{\markuplines} keyword. Builtin markup list commands, such as
102 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
103 ones created using the @code{define-markup-list-command} Scheme macro.
106 Particular points of a book may be marked with the @code{\label}
107 command. Then, the page where these points are placed can be refered to
108 using the @code{\page-ref} markup command.
111 Page breaking and page turning commands (@code{\pageBreak},
112 @code{\noPageBreak}, etc) can be used at top-level, between scores and
116 The following options are now changed as a @code{-d} sub-option:
117 @code{--backend}, @code{--safe}, @code{--preview} and
118 @code{--no-pages} (which became @code{-dno-print-pages}). The @code{-b}
119 option does not exist any more.
122 Improved testing procedure now catch changes in CPU and memory
123 performance, page layout, MIDI results and warnings. This helps to
124 reduce the number of regression errors during development, resulting
125 in more stable releases.
127 See @uref{INSTALL.html#testing} for more information.
129 Nested properties, such as @code{details} in @code{Slur}, can be
130 reverted as well. The syntax for this is
133 \revert Slur #'(details closeness-factor)
137 All line spanners are more flexible now in the configuration of
138 their end points. This includes glissando, voice followers, text
139 crescendos and other text spanners. The old syntax for setting
140 text on line spanners is no longer valid.
142 @c with ragged-right we can't see the gliss.
145 \override Glissando #'bound-details #'right #'text = \markup { \hcenter \bold down }
146 \override Glissando #'bound-details #'right #'Y = #-4
147 \override Glissando #'bound-details #'right #'padding = #0.0
148 \override Glissando #'bound-details #'left #'arrow = ##t
149 \override Glissando #'bound-details #'left #'padding = #3.0
150 \override Glissando #'style = #'trill
156 This feature was sponsored by Trevor Bača.
160 The environment variable LILYPONDPREFIX has been renamed to
164 Notes or rests, such as a typical end note, that fill an entire
165 measure are preceded by some more space.
167 @lilypond[ragged-right]
177 @item All @code{\score}s in a lilypond-book fragment are now inserted
178 into the document. Also, toplevel markups don't result in an entire
181 @item Alterations (such as a sharp and flat) may now be arbitrary
182 fractions. This allows some forms of microtonal music. For example,
183 Turkish makam music uses 1/9th tone alterations.
185 @lilypondfile{makam.ly}
189 @item Tie directions may be set with @code{^~} and @code{_~}
191 @item Tablature now supports harmonics and slides,
193 @lilypond[fragment,ragged-right,relative=1]
196 <c g'\harmonic> d\2\glissando e\2
200 This feature was sponsored by Mike Amundsen
202 @item Horizontal spacing now follows object outlines more
203 accurately. This allows tighter horizontal spacing.
205 @lilypond[fragment,ragged-right]
213 @item Objects that belong outside of the staff are
214 now positioned automatically to avoid collisions.
216 @lilypond[fragment,ragged-right,relative=1]
218 \once \override TextScript #'self-alignment-X = #CENTER
219 a,^"this doesn't collide with the c"
220 b^"this goes above the previous markup"
221 a8_"this goes below the dynamic"
225 @item Staves are spaced vertically using a skyline algorithm. This helps to avoid
226 uneven vertical spacing.
228 @lilypond[ragged-right]
230 %% todo: fix 'landscape PDF.
231 #(set-default-paper-size "a6" )
239 a,,1 | a'4 b' c'' d'' \break
240 \repeat unfold 2 {a' b' c'' d''} | b''''1
251 For older news, go to
252 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
253 or @uref{../,go back} to the Documentation index.