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