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's 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 @code{\bookpart} blocks may be used to split a book into several parts,
67 separated by a page break, in order to ease the page breaking, or to use
68 different @code{\paper} settings in different parts.
74 subtitle = "First part"
81 subtitle = "Second part"
89 Nested contexts of the same type are now allowed.
90 This deprecates @code{InnerStaffGroup} and @code{InnerChoirStaff}.
102 In addition to the already existing @code{showLastLength} property,
103 @code{showFirstLength} can now be set as well, rendering only the first
104 measures of a piece. Both properties may be set at the same time:
106 showFirstLength = R1*2
107 showLastLength = R1*3
108 \relative c' { c1 d e f g a b c }
112 The file extension for MIDI can be set using the command-line
113 program default @code{midi-extension}. For Windows, the default
114 extension has been changed to @code{.mid}.
117 Two variations on the default double repeat bar line are now available.
120 \set Score.doubleRepeatType = #":|.:"
133 Four automatic accidentals rules have been added: @code{neo-modern},
134 @code{neo-modern-cautionary}, @code{dodecaphonic} and @code{teaching}.
135 The following example illustrates @code{neo-modern} rule.
140 cis'8 fis, d'4 <a cis>8 f bis4 |
152 #(set-accidental-style 'neo-modern)
158 Flags can now be generated with Scheme-code using the @code{'flag}
159 @code{Stem} grob property. Existing scores will work without change.
166 #(define (inverted-flag stem-grob)
167 (let* ((dir (if (eqv? (ly:grob-property stem-grob 'direction) UP) "d" "u"))
168 (flag (retrieve-glyph-flag "" dir "" stem-grob))
169 (line-thickness (ly:staff-symbol-line-thickness stem-grob))
170 (stem-thickness (ly:grob-property stem-grob 'thickness))
171 (stem-width (* line-thickness stem-thickness))
172 (stroke-style (ly:grob-property stem-grob 'stroke-style))
173 (stencil (if (null? stroke-style) flag
174 (add-stroke-glyph flag stem-grob dir stroke-style "")))
175 (rotated-flag (ly:stencil-rotate-absolute stencil 180 0 0)))
176 (ly:stencil-translate rotated-flag (cons (- (/ stem-width 2)) 0))))
178 #(define-public (weight-flag stem-grob)
179 (let* ((log (- (ly:grob-property stem-grob 'duration-log) 2))
180 (is-up (eqv? (ly:grob-property stem-grob 'direction) UP))
181 (yext (if is-up (cons (* log -0.8) 0) (cons 0 (* log 0.8))))
182 (flag-stencil (make-filled-box-stencil '(-0.4 . 0.4) yext))
183 (stroke-style (ly:grob-property stem-grob 'stroke-style))
184 (stroke-stencil (if (equal? stroke-style "grace")
185 (make-line-stencil 0.2 -0.9 -0.4 0.9 -0.4)
187 (ly:stencil-add flag-stencil stroke-stencil)))
191 \override Stem #'flag = #weight-flag
194 \override Stem #'flag = #inverted-flag
200 Harp pedalling diagrams were added:
203 \markup { \harp-pedal #"^v-|vv-o^" }
207 Predefined, user-configurable, transposable fret diagrams
208 are now available in the @code{FretBoards} context:
210 \include "predefined-guitar-fretboards.ly"
228 The following syntax changes were made, in chronological order. In
229 addition, fret diagram properties have been moved to
230 @code{fret-diagram-details}, and the @code{#'style} property is
231 used to select solid/dashed lines instead of @code{#'dash-fraction}.
234 'break-align-symbol -> 'break-align-symbols
235 scripts.caesura -> scripts.caesura.curved
236 \setEasyHeads -> \easyHeadsOn
237 \easyHeadsOff (new command)
238 \fatText -> \textLengthOn
239 \emptyText -> \textLengthOff
240 \set hairpinToBarline -> \override Hairpin #'to-barline
241 \compressMusic -> \scaleDurations
242 \octave -> \octaveCheck
243 \arpeggioUp -> \arpeggioArrowUp
244 \arpeggioDown -> \arpeggioArrowDown
245 \arpeggioNeutral -> \arpeggioNormal
246 \setTextCresc -> \crescTextCresc
247 \setTextDecresc -> \dimTextDecresc
248 \setTextDecr -> \dimTextDecr
249 \setTextDim -> \dimTextDim
250 \setHairpinCresc -> \crescHairpin
251 \setHairpinDecresc -> \dimHairpin
252 \sustainUp -> \sustainOff
253 \sustainDown -> \sustainOn
254 \sostenutoDown -> \sostenutoOn
255 \sostenutoUp -> \sostenutoOff
256 'infinite-spacing-height -> 'extra-spacing-height
257 #(set-octavation oct) -> \ottava #oct
258 \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
259 \pointAndClickOn (new command)
260 \pointAndClickOff (new command)
261 \center-align -> \center-column
262 \hcenter -> \center-align
263 printallheaders -> print-all-headers
264 \bigger -> \larger (already existing command)
265 systemSeparatorMarkup -> system-separator-markup
269 Moreover, some files in the @code{ly/} directory have been renamed;
270 the *-init.ly filenames are now only used for files that are automatically
271 included, while such files as @code{makam-init.ly} or @code{gregorian-init.ly}
272 have been renamed to @code{makam.ly} or @code{gregorian.ly}.
275 Metronome marks can now also contain a textual description. The
276 duration and count (if given) are shown in parentheses after the text.
283 \tempo "Andante" 4 = 120
296 In figured bass you can now also use a backslash through a number to
297 indicate a raised 6th step.
300 \new FiguredBass \figuremode { < 6\\ 5\\ > < 6/ > }
304 Arpeggios may now use ``parenthesis'' style brackets:
306 @lilypond[relative=1]
307 \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
309 % Note: does not work for cross-staff arpeggios.
310 \override Arpeggio #'X-extent = #ly:grob::stencil-width
311 <c g' c>2\arpeggio ~ c
315 Single-system scores are now naturally spaced instead of being
316 stretched to fill the line width. This can be changed by setting
317 @code{ragged-right = ##f}.
320 Enclosing text within boxes with rounded corners is now possible,
321 using the @code{\rounded-box} markup command.
324 @command{lilypond-book} can run any program instead of @command{latex}
325 to guess the line width, thanks to @code{--latex-program} command line
329 Underlining is now possible with the @code{\underline} markup command.
332 It is now possible to specify, using the @code{page-count} variable in
333 the paper block, the number of pages that will be used.
336 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
337 to books with many pages or a lot of text.
340 A table of contents is included using @code{\markuplines \table-of-contents}.
341 Elements are added to it using the @code{\tocItem} command.
344 Text spreading over several pages is entered using the
345 @code{\markuplines} keyword. Builtin markup list commands, such as
346 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
347 ones created using the @code{define-markup-list-command} Scheme macro.
350 Particular points of a book may be marked with the @code{\label}
351 command. Then, the page where these points are placed can be
352 referred to using the @code{\page-ref} markup command.
355 Page breaking and page turning commands (@code{\pageBreak},
356 @code{\noPageBreak}, etc.) can be used at top-level, between scores and
360 The following options are now changed as a @code{-d} sub-option:
361 @code{--backend}, @code{--safe}, @code{--preview} and
362 @code{--no-pages} (which became @code{-dno-print-pages}). The @code{-b}
363 option does not exist any more.
366 Improved testing procedures now catch changes in CPU and memory
367 performance, page layout, MIDI results and warnings. This helps to
368 reduce the number of regression errors during development, resulting
369 in more stable releases.
371 See @uref{INSTALL.html#Testing-LilyPond} for more information.
374 Nested properties, such as @code{'details} in @code{Slur}, can be
375 reverted as well. The syntax for this is
378 \revert Slur #'(details closeness-factor)
382 All line spanners are more flexible now in the configuration of
383 their end points. This includes glissando, voice followers, text
384 crescendos and other text spanners. The old syntax for setting
385 text on line spanners is no longer valid.
389 \override Glissando #'bound-details #'right #'text = \markup { \center-align \bold down }
390 \override Glissando #'bound-details #'right #'Y = #-4
391 \override Glissando #'bound-details #'right #'padding = #0.0
392 \override Glissando #'bound-details #'left #'arrow = ##t
393 \override Glissando #'bound-details #'left #'padding = #3.0
394 \override Glissando #'style = #'trill
395 \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
396 \override Glissando #'minimum-length = #12
402 This feature was sponsored by Trevor Bača.
405 The environment variable @code{LILYPONDPREFIX} has been renamed
406 @code{LILYPOND_DATADIR}.
409 Notes or rests, such as a typical end note, that fill an entire
410 measure are preceded by some more space.
412 @lilypond[relative=1]
421 All @code{\score}s in a lilypond-book fragment are now inserted
422 into the document. Also, toplevel markups don't result in an entire
426 Alterations (such as a sharp or flat) may now be arbitrary
427 fractions. This allows some forms of microtonal music. For example,
428 Turkish makam music uses 1/9th tone alterations.
430 @lilypondfile{makam-example.ly}
433 Tie directions may be set with @code{^~} and @code{_~}.
436 Tablature now supports harmonics and slides:
438 @lilypond[relative=1]
440 <c g'\harmonic>4 d\2\glissando e2\2
444 This feature was sponsored by Mike Amundsen
447 Horizontal spacing now follows object outlines more accurately.
448 This allows tighter horizontal spacing.
458 Objects that belong outside of the staff are now positioned
459 automatically to avoid collisions.
461 @lilypond[relative=1]
463 \once \override TextScript #'self-alignment-X = #CENTER
464 a,4^"this doesn't collide with the c"
465 b4^"this goes above the previous markup"
466 a8_"this goes below the dynamic"
471 Staves are spaced vertically using a skyline algorithm. This helps
472 prevent uneven vertical spacing.
474 @lilypond[ragged-right]
476 %% todo: fix 'landscape PDF.
477 #(set-default-paper-size "a6")
486 a'4 b' c'' d'' \break
487 \repeat unfold 2 { a'4 b' c'' d''}
499 For older news, go to
500 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
501 or @uref{../,go back} to the Documentation index.