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 Predefined, user-configurable, transposable fret diagrams
70 are now available in the FretBoards context:
72 \include "predefined-guitar-fretboards.ly"
76 c1 \transpose c e { c }
81 c1 \transpose c e { c }
88 The following syntax changes were made, in chronological order. In
89 addition, fret diagram properties have been moved to
90 @code{fret-diagram-details}, and @code{#'style} property is used to
91 select solid/dashed lines instead of @code{#'dash-fraction}.
94 #'break-align-symbol -> #'break-align-symbols
95 scripts.caesura -> scripts.caesura.curved
96 \setEasyHeads -> \easyHeadsOn
97 \easyHeadsOff (new command)
98 \fatText -> \textLengthOn
99 \emptyText -> \textLengthOff
100 \set hairpinToBarline -> \override Hairpin #'to-barline
101 \compressMusic -> \scaleDurations
102 \octave -> \octaveCheck
103 \arpeggioUp -> \arpeggioArrowUp
104 \arpeggioDown -> \arpeggioArrowDown
105 \arpeggioNeutral -> \arpeggioNormal
106 \setTextCresc -> \crescTextCresc
107 \setTextDecresc -> \dimTextDecresc
108 \setTextDecr -> \dimTextDecr
109 \setTextDim -> \dimTextDim
110 \setHairpinCresc -> \crescHairpin
111 \setHairpinDecresc -> \dimHairpin
112 \sustainUp -> \sustainOff
113 \sustainDown -> \sustainOn
114 \sostenutoDown -> \sostenutoOn
115 \sostenutoUp -> \sostenutoOff
116 infinite-spacing-height -> extra-spacing-height
117 #(set-octavation oct) -> \ottava #oct
118 \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
122 Arpeggios may now use ``parenthesis'' style brackets:
124 @lilypond[relative,ragged-right]
125 \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
127 % Note: does not work for cross staff arpeggios.
128 \override Arpeggio #'X-extent = #ly:grob::stencil-width
129 <c g' c>2\arpeggio ~ c
133 Enclosing text within boxes with rounded corners is now possible,
134 using the @code{rounded-box} command.
137 @command{lilypond-book} can run any program instead of @command{latex}
138 to guess the line width, thanks to @code{--latex-program} command line
142 Underlining is now possible with the @code{\underline} markup command.
145 It is now possible to specify, using the @code{page-count} variable in
146 the paper block, the number of pages that will be used.
149 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
150 to books with many pages or a lot of texts.
153 A table of contents is included using @code{\markuplines \table-of-contents}.
154 Elements are added to it using the @code{\tocItem} command.
157 Text spreading over several pages is entered using the
158 @code{\markuplines} keyword. Builtin markup list commands, such as
159 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
160 ones created using the @code{define-markup-list-command} Scheme macro.
163 Particular points of a book may be marked with the @code{\label}
164 command. Then, the page where these points are placed can be refered to
165 using the @code{\page-ref} markup command.
168 Page breaking and page turning commands (@code{\pageBreak},
169 @code{\noPageBreak}, etc) can be used at top-level, between scores and
173 The following options are now changed as a @code{-d} sub-option:
174 @code{--backend}, @code{--safe}, @code{--preview} and
175 @code{--no-pages} (which became @code{-dno-print-pages}). The @code{-b}
176 option does not exist any more.
179 Improved testing procedure now catch changes in CPU and memory
180 performance, page layout, MIDI results and warnings. This helps to
181 reduce the number of regression errors during development, resulting
182 in more stable releases.
184 See @uref{INSTALL.html#testing} for more information.
186 Nested properties, such as @code{details} in @code{Slur}, can be
187 reverted as well. The syntax for this is
190 \revert Slur #'(details closeness-factor)
194 All line spanners are more flexible now in the configuration of
195 their end points. This includes glissando, voice followers, text
196 crescendos and other text spanners. The old syntax for setting
197 text on line spanners is no longer valid.
201 \override Glissando #'bound-details #'right #'text = \markup { \hcenter \bold down }
202 \override Glissando #'bound-details #'right #'Y = #-4
203 \override Glissando #'bound-details #'right #'padding = #0.0
204 \override Glissando #'bound-details #'left #'arrow = ##t
205 \override Glissando #'bound-details #'left #'padding = #3.0
206 \override Glissando #'style = #'trill
207 \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
208 \override Glissando #'minimum-length = #12
214 This feature was sponsored by Trevor Bača.
218 The environment variable LILYPONDPREFIX has been renamed to
222 Notes or rests, such as a typical end note, that fill an entire
223 measure are preceded by some more space.
225 @lilypond[ragged-right]
235 @item All @code{\score}s in a lilypond-book fragment are now inserted
236 into the document. Also, toplevel markups don't result in an entire
239 @item Alterations (such as a sharp and flat) may now be arbitrary
240 fractions. This allows some forms of microtonal music. For example,
241 Turkish makam music uses 1/9th tone alterations.
243 @lilypondfile{makam.ly}
247 @item Tie directions may be set with @code{^~} and @code{_~}
249 @item Tablature now supports harmonics and slides,
251 @lilypond[fragment,ragged-right,relative=1]
254 <c g'\harmonic> d\2\glissando e\2
258 This feature was sponsored by Mike Amundsen
260 @item Horizontal spacing now follows object outlines more
261 accurately. This allows tighter horizontal spacing.
263 @lilypond[fragment,ragged-right]
271 @item Objects that belong outside of the staff are
272 now positioned automatically to avoid collisions.
274 @lilypond[fragment,ragged-right,relative=1]
276 \once \override TextScript #'self-alignment-X = #CENTER
277 a,^"this doesn't collide with the c"
278 b^"this goes above the previous markup"
279 a8_"this goes below the dynamic"
283 @item Staves are spaced vertically using a skyline algorithm. This helps to avoid
284 uneven vertical spacing.
286 @lilypond[ragged-right]
288 %% todo: fix 'landscape PDF.
289 #(set-default-paper-size "a6" )
297 a,,1 | a'4 b' c'' d'' \break
298 \repeat unfold 2 {a' b' c'' d''} | b''''1
304 @item Metronome marks can now also contain a textual description. The
305 duration and count (if given) are shown in parentheses after the text.
312 \tempo "Andante" 4 = 120
324 @item In figured bass you can now also use a backslash through a number to
325 indicate a raised 6th step.
327 @lilypond[ragged-right]
328 \new FiguredBass \figuremode { < 6\\ 5\\ > < 6/ > }
331 @item Harp pedalling diagrams were added:
334 \markup \harp-pedal #"^v-|vv-o^"
342 For older news, go to
343 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
344 or @uref{../,go back} to the Documentation index.