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
36 @top New features in 2.11 since 2.10
39 This document is also available in @uref{NEWS.pdf,PDF}. It is part of
40 the @uref{../,LilyPond Documentation}.
52 * only show verbatim input for syntax/input changes
54 * try to be as brief possible in those cases
56 * don't try to provide real-world examples, they often get too big,
57 which scares away people.
59 * Write complete sentences.
61 * only show user-visible changes.
66 Unbeamed 128th notes are now supported:
74 Straight flags (used in old scores of e.g. Bach, but also in different form in
75 modern scores of e.g. Stockhausen) are now implemented:
78 \override Stem #'flag = #modern-straight-flag
79 c,16 \acciaccatura {c'8} d4 d32
81 \override Stem #'flag = #old-straight-flag
82 c,16 \acciaccatura {c'8} d4 d32
87 @code{\bookpart} blocks may be used to split a book into several parts,
88 separated by a page break, in order to ease the page breaking, or to use
89 different @code{\paper} settings in different parts.
95 subtitle = "First part"
102 subtitle = "Second part"
110 Nested contexts of the same type are now allowed.
111 This deprecates @code{InnerStaffGroup} and @code{InnerChoirStaff}.
112 @lilypond[relative=1]
123 Percent repeat counters can be shown at regular intervals using the
124 context property @code{repeatCountVisibility}.
125 @lilypond[relative=1]
127 \set countPercentRepeats = ##t
128 \set repeatCountVisibility = #(every-nth-repeat-count-visible 2)
129 \repeat percent 8 { c4 d e f }
134 In addition to the already existing @code{showLastLength} property,
135 @code{showFirstLength} can now be set as well, rendering only the first
136 measures of a piece. Both properties may be set at the same time:
138 showFirstLength = R1*2
139 showLastLength = R1*3
140 \relative c' { c1 d e f g a b c }
144 The file extension for MIDI can be set using the command-line
145 program default @code{midi-extension}. For Windows, the default
146 extension has been changed to @code{.mid}.
149 Two variations on the default double repeat bar line are now available.
152 \set Score.doubleRepeatType = #":|.:"
165 Four automatic accidentals rules have been added: @code{neo-modern},
166 @code{neo-modern-cautionary}, @code{dodecaphonic} and @code{teaching}.
167 The following example illustrates @code{neo-modern} rule.
172 cis'8 fis, d'4 <a cis>8 f bis4 |
184 #(set-accidental-style 'neo-modern)
190 Flags can now be generated with Scheme-code using the @code{'flag}
191 @code{Stem} grob property. Existing scores will work without change.
198 #(define (inverted-flag stem-grob)
199 (let* ((dir (if (eqv? (ly:grob-property stem-grob 'direction) UP) "d" "u"))
200 (flag (retrieve-glyph-flag "" dir "" stem-grob))
201 (line-thickness (ly:staff-symbol-line-thickness stem-grob))
202 (stem-thickness (ly:grob-property stem-grob 'thickness))
203 (stem-width (* line-thickness stem-thickness))
204 (stroke-style (ly:grob-property stem-grob 'stroke-style))
205 (stencil (if (null? stroke-style) flag
206 (add-stroke-glyph flag stem-grob dir stroke-style "")))
207 (rotated-flag (ly:stencil-rotate-absolute stencil 180 0 0)))
208 (ly:stencil-translate rotated-flag (cons (- (/ stem-width 2)) 0))))
210 #(define-public (weight-flag stem-grob)
211 (let* ((log (- (ly:grob-property stem-grob 'duration-log) 2))
212 (is-up (eqv? (ly:grob-property stem-grob 'direction) UP))
213 (yext (if is-up (cons (* log -0.8) 0) (cons 0 (* log 0.8))))
214 (flag-stencil (make-filled-box-stencil '(-0.4 . 0.4) yext))
215 (stroke-style (ly:grob-property stem-grob 'stroke-style))
216 (stroke-stencil (if (equal? stroke-style "grace")
217 (make-line-stencil 0.2 -0.9 -0.4 0.9 -0.4)
219 (ly:stencil-add flag-stencil stroke-stencil)))
223 \override Stem #'flag = #weight-flag
226 \override Stem #'flag = #inverted-flag
232 Harp pedalling diagrams were added:
235 \markup { \harp-pedal #"^v-|vv-o^" }
239 Predefined, user-configurable, transposable fret diagrams
240 are now available in the @code{FretBoards} context:
242 \include "predefined-guitar-fretboards.ly"
260 The following syntax changes were made, in chronological order. In
261 addition, fret diagram properties have been moved to
262 @code{fret-diagram-details}, and the @code{#'style} property is
263 used to select solid/dashed lines instead of @code{#'dash-fraction}.
266 'break-align-symbol -> 'break-align-symbols
267 scripts.caesura -> scripts.caesura.curved
268 \setEasyHeads -> \easyHeadsOn
269 \easyHeadsOff (new command)
270 \fatText -> \textLengthOn
271 \emptyText -> \textLengthOff
272 \set hairpinToBarline -> \override Hairpin #'to-barline
273 \compressMusic -> \scaleDurations
274 \octave -> \octaveCheck
275 \arpeggioUp -> \arpeggioArrowUp
276 \arpeggioDown -> \arpeggioArrowDown
277 \arpeggioNeutral -> \arpeggioNormal
278 \setTextCresc -> \crescTextCresc
279 \setTextDecresc -> \dimTextDecresc
280 \setTextDecr -> \dimTextDecr
281 \setTextDim -> \dimTextDim
282 \setHairpinCresc -> \crescHairpin
283 \setHairpinDecresc -> \dimHairpin
284 \sustainUp -> \sustainOff
285 \sustainDown -> \sustainOn
286 \sostenutoDown -> \sostenutoOn
287 \sostenutoUp -> \sostenutoOff
288 'infinite-spacing-height -> 'extra-spacing-height
289 #(set-octavation oct) -> \ottava #oct
290 \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
291 \pointAndClickOn (new command)
292 \pointAndClickOff (new command)
293 \center-align -> \center-column
294 \hcenter -> \center-align
295 printallheaders -> print-all-headers
296 \bigger -> \larger (already existing command)
297 systemSeparatorMarkup -> system-separator-markup
301 Moreover, some files in the @code{ly/} directory have been renamed;
302 the *-init.ly filenames are now only used for files that are automatically
303 included, while such files as @code{makam-init.ly} or @code{gregorian-init.ly}
304 have been renamed to @code{makam.ly} or @code{gregorian.ly}.
307 The ``tex'' and ``texstr'' backends have been removed. Font are now
308 accessed via the fontconfig library; the Pango library is used to display
312 Metronome marks can now also contain a textual description. The
313 duration and count (if given) are shown in parentheses after the text.
320 \tempo "Andante" 4 = 120
333 In figured bass you can now also use a backslash through a number to
334 indicate a raised 6th step.
337 \new FiguredBass \figuremode { < 6\\ 5\\ > < 6/ > }
341 Arpeggios may now use ``parenthesis'' style brackets:
343 @lilypond[relative=1]
344 \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
346 % Note: does not work for cross-staff arpeggios.
347 \override Arpeggio #'X-extent = #ly:grob::stencil-width
348 <c g' c>2\arpeggio ~ c
352 Single-system scores are now naturally spaced instead of being
353 stretched to fill the line width. This can be changed by setting
354 @code{ragged-right = ##f}.
357 Enclosing text within boxes with rounded corners is now possible,
358 using the @code{\rounded-box} markup command.
361 @command{lilypond-book} can run any program instead of @command{latex}
362 to guess the line width, thanks to @code{--latex-program} command line
366 Underlining is now possible with the @code{\underline} markup command.
369 It is now possible to specify, using the @code{page-count} variable in
370 the paper block, the number of pages that will be used.
373 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
374 to books with many pages or a lot of text.
377 A table of contents is included using @code{\markuplines \table-of-contents}.
378 Elements are added to it using the @code{\tocItem} command.
381 Text spreading over several pages is entered using the
382 @code{\markuplines} keyword. Builtin markup list commands, such as
383 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
384 ones created using the @code{define-markup-list-command} Scheme macro.
387 Particular points of a book may be marked with the @code{\label}
388 command. Then, the page where these points are placed can be
389 referred to using the @code{\page-ref} markup command.
392 Page breaking and page turning commands (@code{\pageBreak},
393 @code{\noPageBreak}, etc.) can be used at top-level, between scores and
397 The following options are now changed as a @code{-d} sub-option:
398 @code{--backend}, @code{--safe}, @code{--preview} and
399 @code{--no-pages} (which became @code{-dno-print-pages}). The @code{-b}
400 option does not exist any more.
403 Improved testing procedures now catch changes in CPU and memory
404 performance, page layout, MIDI results and warnings. This helps to
405 reduce the number of regression errors during development, resulting
406 in more stable releases.
408 See @uref{INSTALL.html#Testing-LilyPond} for more information.
411 Nested properties, such as @code{'details} in @code{Slur}, can be
412 reverted as well. The syntax for this is
415 \revert Slur #'(details closeness-factor)
419 All line spanners are more flexible now in the configuration of
420 their end points. This includes glissando, voice followers, text
421 crescendos and other text spanners. The old syntax for setting
422 text on line spanners is no longer valid.
426 \override Glissando #'(bound-details right text) = \markup { \center-align \bold down }
427 \override Glissando #'(bound-details right Y) = #-4
428 \override Glissando #'(bound-details right padding) = #0.0
429 \override Glissando #'(bound-details left arrow) = ##t
430 \override Glissando #'(bound-details left padding) = #3.0
431 \override Glissando #'style = #'trill
432 \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
433 \override Glissando #'minimum-length = #12
439 This feature was sponsored by Trevor Bača.
442 The environment variable @code{LILYPONDPREFIX} has been renamed
443 @code{LILYPOND_DATADIR}.
446 Notes or rests, such as a typical end note, that fill an entire
447 measure are preceded by some more space.
449 @lilypond[relative=1]
458 All @code{\score}s in a lilypond-book fragment are now inserted
459 into the document. Also, toplevel markups don't result in an entire
463 Alterations (such as a sharp or flat) may now be arbitrary
464 fractions. This allows some forms of microtonal music. For example,
465 Turkish makam music uses 1/9th tone alterations.
467 @lilypondfile{makam-example.ly}
470 Tie directions may be set with @code{^~} and @code{_~}.
473 Tablature now supports harmonics and slides:
475 @lilypond[relative=1]
477 <c g'\harmonic>4 d\2\glissando e2\2
481 This feature was sponsored by Mike Amundsen
484 Horizontal spacing now follows object outlines more accurately.
485 This allows tighter horizontal spacing.
495 Objects that belong outside of the staff are now positioned
496 automatically to avoid collisions.
498 @lilypond[relative=1]
500 \once \override TextScript #'self-alignment-X = #CENTER
501 a,4^"this doesn't collide with the c"
502 b4^"this goes above the previous markup"
503 a8_"this goes below the dynamic"
508 Staves are spaced vertically using a skyline algorithm. This helps
509 prevent uneven vertical spacing.
511 @lilypond[ragged-right]
513 %% todo: fix 'landscape PDF.
514 #(set-default-paper-size "a6")
523 a'4 b' c'' d'' \break
524 \repeat unfold 2 { a'4 b' c'' d''}
536 For older news, go to
537 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
538 or @uref{../,go back} to the Documentation index.