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.
68 @item Three automatic accidentals rules have been added: @code{neo-modern},
69 @code{neo-modern-cautionary} and @code{dodecaphonic}. The following
70 example illustrates @code{neo-modern} rule.
75 cis'8 fis, d'4 <a cis>8 f bis4 |
87 #(set-accidental-style 'neo-modern)
92 @item Flags can now be generated with Scheme-code using the @code{'flag} Stem
93 grob property. Existing scores will work without change.
95 testnotes = { \autoBeamOff c'8 d'16 c''8 d''16 }
97 #(define (inverted-flag stem-grob)
98 (let* ((dir (if (eqv? (ly:grob-property stem-grob 'direction) UP) "d" "u"))
99 (flag (retrieve-glyph-flag "" dir "" stem-grob))
100 (stroke-style (ly:grob-property stem-grob 'stroke-style))
101 (stencil (if (null? stroke-style) flag
102 (add-stroke-glyph flag stem-grob dir stroke-style ""))))
103 (ly:stencil-rotate-absolute stencil 180 -0.05 0)))
105 #(define-public (weight-flag stem-grob)
106 (let* ((log (- (ly:grob-property stem-grob 'duration-log) 2))
107 (is-up (eqv? (ly:grob-property stem-grob 'direction) UP))
108 (yext (if is-up (cons (* log -0.8) 0) (cons 0 (* log 0.8))))
109 (flag-stencil (make-filled-box-stencil '(-0.4 . 0.4) yext))
110 (stroke-style (ly:grob-property stem-grob 'stroke-style))
111 (stroke-stencil (if (equal? stroke-style "grace") (make-line-stencil 0.2 -0.9 -0.4 0.9 -0.4) empty-stencil)))
112 (ly:stencil-add flag-stencil stroke-stencil)))
116 \override Stem #'flag = #weight-flag
119 \override Stem #'flag = #inverted-flag
126 @item Harp pedalling diagrams were added:
129 \markup \harp-pedal #"^v-|vv-o^"
133 Predefined, user-configurable, transposable fret diagrams
134 are now available in the @code{FretBoards} context:
136 \include "predefined-guitar-fretboards.ly"
140 c1 \transpose c e { c }
145 c1 \transpose c e { c }
152 The following syntax changes were made, in chronological order. In
153 addition, fret diagram properties have been moved to
154 @code{fret-diagram-details}, and @code{#'style} property is used to
155 select solid/dashed lines instead of @code{#'dash-fraction}.
158 #'break-align-symbol -> #'break-align-symbols
159 scripts.caesura -> scripts.caesura.curved
160 \setEasyHeads -> \easyHeadsOn
161 \easyHeadsOff (new command)
162 \fatText -> \textLengthOn
163 \emptyText -> \textLengthOff
164 \set hairpinToBarline -> \override Hairpin #'to-barline
165 \compressMusic -> \scaleDurations
166 \octave -> \octaveCheck
167 \arpeggioUp -> \arpeggioArrowUp
168 \arpeggioDown -> \arpeggioArrowDown
169 \arpeggioNeutral -> \arpeggioNormal
170 \setTextCresc -> \crescTextCresc
171 \setTextDecresc -> \dimTextDecresc
172 \setTextDecr -> \dimTextDecr
173 \setTextDim -> \dimTextDim
174 \setHairpinCresc -> \crescHairpin
175 \setHairpinDecresc -> \dimHairpin
176 \sustainUp -> \sustainOff
177 \sustainDown -> \sustainOn
178 \sostenutoDown -> \sostenutoOn
179 \sostenutoUp -> \sostenutoOff
180 infinite-spacing-height -> extra-spacing-height
181 #(set-octavation oct) -> \ottava #oct
182 \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
183 \center-align -> \center-column
184 \hcenter -> \center-align
187 @item Metronome marks can now also contain a textual description. The
188 duration and count (if given) are shown in parentheses after the text.
195 \tempo "Andante" 4 = 120
207 @item In figured bass you can now also use a backslash through a number to
208 indicate a raised 6th step.
210 @lilypond[ragged-right]
211 \new FiguredBass \figuremode { < 6\\ 5\\ > < 6/ > }
215 Arpeggios may now use ``parenthesis'' style brackets:
217 @lilypond[relative,ragged-right]
218 \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
220 % Note: does not work for cross staff arpeggios.
221 \override Arpeggio #'X-extent = #ly:grob::stencil-width
222 <c g' c>2\arpeggio ~ c
226 Enclosing text within boxes with rounded corners is now possible,
227 using the @code{rounded-box} command.
230 @command{lilypond-book} can run any program instead of @command{latex}
231 to guess the line width, thanks to @code{--latex-program} command line
235 Underlining is now possible with the @code{\underline} markup command.
238 It is now possible to specify, using the @code{page-count} variable in
239 the paper block, the number of pages that will be used.
242 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
243 to books with many pages or a lot of texts.
246 A table of contents is included using @code{\markuplines \table-of-contents}.
247 Elements are added to it using the @code{\tocItem} command.
250 Text spreading over several pages is entered using the
251 @code{\markuplines} keyword. Builtin markup list commands, such as
252 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
253 ones created using the @code{define-markup-list-command} Scheme macro.
256 Particular points of a book may be marked with the @code{\label}
257 command. Then, the page where these points are placed can be refered to
258 using the @code{\page-ref} markup command.
261 Page breaking and page turning commands (@code{\pageBreak},
262 @code{\noPageBreak}, etc) can be used at top-level, between scores and
266 The following options are now changed as a @code{-d} sub-option:
267 @code{--backend}, @code{--safe}, @code{--preview} and
268 @code{--no-pages} (which became @code{-dno-print-pages}). The @code{-b}
269 option does not exist any more.
272 Improved testing procedure now catch changes in CPU and memory
273 performance, page layout, MIDI results and warnings. This helps to
274 reduce the number of regression errors during development, resulting
275 in more stable releases.
277 See @uref{INSTALL.html#Testing-LilyPond} for more information.
279 Nested properties, such as @code{details} in @code{Slur}, can be
280 reverted as well. The syntax for this is
283 \revert Slur #'(details closeness-factor)
287 All line spanners are more flexible now in the configuration of
288 their end points. This includes glissando, voice followers, text
289 crescendos and other text spanners. The old syntax for setting
290 text on line spanners is no longer valid.
294 \override Glissando #'bound-details #'right #'text = \markup { \center-align \bold down }
295 \override Glissando #'bound-details #'right #'Y = #-4
296 \override Glissando #'bound-details #'right #'padding = #0.0
297 \override Glissando #'bound-details #'left #'arrow = ##t
298 \override Glissando #'bound-details #'left #'padding = #3.0
299 \override Glissando #'style = #'trill
300 \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
301 \override Glissando #'minimum-length = #12
307 This feature was sponsored by Trevor Bača.
311 The environment variable LILYPONDPREFIX has been renamed to
315 Notes or rests, such as a typical end note, that fill an entire
316 measure are preceded by some more space.
318 @lilypond[ragged-right]
328 @item All @code{\score}s in a lilypond-book fragment are now inserted
329 into the document. Also, toplevel markups don't result in an entire
332 @item Alterations (such as a sharp and flat) may now be arbitrary
333 fractions. This allows some forms of microtonal music. For example,
334 Turkish makam music uses 1/9th tone alterations.
336 @lilypondfile{makam.ly}
340 @item Tie directions may be set with @code{^~} and @code{_~}
342 @item Tablature now supports harmonics and slides,
344 @lilypond[fragment,ragged-right,relative=1]
347 <c g'\harmonic> d\2\glissando e\2
351 This feature was sponsored by Mike Amundsen
353 @item Horizontal spacing now follows object outlines more
354 accurately. This allows tighter horizontal spacing.
356 @lilypond[fragment,ragged-right]
364 @item Objects that belong outside of the staff are
365 now positioned automatically to avoid collisions.
367 @lilypond[fragment,ragged-right,relative=1]
369 \once \override TextScript #'self-alignment-X = #CENTER
370 a,^"this doesn't collide with the c"
371 b^"this goes above the previous markup"
372 a8_"this goes below the dynamic"
376 @item Staves are spaced vertically using a skyline algorithm. This helps to avoid
377 uneven vertical spacing.
379 @lilypond[ragged-right]
381 %% todo: fix 'landscape PDF.
382 #(set-default-paper-size "a6" )
390 a,,1 | a'4 b' c'' d'' \break
391 \repeat unfold 2 {a' b' c'' d''} | b''''1
402 For older news, go to
403 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
404 or @uref{../,go back} to the Documentation index.