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 A few syntax changes were made:
90 2.11.23: #'break-align-symbol -> #'break-align-symbols
91 2.11.35: scripts.caesura -> scripts.caesura.curved.
92 Use #'style not #'dash-fraction to select solid/dashed lines.
93 2.11.38: \setEasyHeads -> \easyHeadsOn, \fatText -> \textLengthOn,
94 \emptyText -> \textLengthOff
95 2.11.46: \set hairpinToBarline -> \override Hairpin #'to-barline
96 2.11.48: \compressMusic -> \scaleDurations
97 2.11.50: metronomeMarkFormatter uses text markup as second argument,
98 fret diagram properties moved to fret-diagram-details.
99 2.11.51: \octave -> \octaveCheck, \arpeggioUp -> \arpeggioArrowUp,
100 \arpeggioDown -> \arpeggioArrowDown, \arpeggioNeutral -> \arpeggioNormal,
101 \setTextCresc -> \crescTextCresc, \setTextDecresc -> \dimTextDecresc,
102 \setTextDecr -> \dimTextDecr, \setTextDim -> \dimTextDim,
103 \setHairpinCresc -> \crescHairpin, \setHairpinDecresc -> \dimHairpin,
104 \sustainUp -> \sustainOff, \sustainDown -> \sustainOn
105 \sostenutoDown -> \sostenutoOn, \sostenutoUp -> \sostenutoOff
106 2.11.53: infinite-spacing-height -> extra-spacing-height
107 2.11.55: #(set-octavation oct) -> \ottava #oct,
108 \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
112 Arpeggios may now use ``parenthesis'' style brackets:
114 @lilypond[relative,ragged-right]
115 \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
117 % Note: does not work for cross staff arpeggios.
118 \override Arpeggio #'X-extent = #ly:grob::stencil-width
119 <c g' c>2\arpeggio ~ c
123 Enclosing text within boxes with rounded corners is now possible,
124 using the @code{rounded-box} command.
127 @command{lilypond-book} can run any program instead of @command{latex}
128 to guess the line width, thanks to @code{--latex-program} command line
132 @code{\setEasyHeads} has been renamed to @code{\easyHeadsOn}, and a new
133 command @code{\easyHeadsOff} reverts note heads to normal heads.
136 @code{\fatText}, @code{\emptyText} and @code{\compressMusic} have been
137 renamed to @code{\textLengthOn}, @code{\textLengthOff} and
138 @code{\scaleDurations}, respectively.
141 Underlining is now possible with the @code{\underline} markup command.
144 It is now possible to specify, using the @code{page-count} variable in
145 the paper block, the number of pages that will be used.
148 A new page breaking function, @code{ly:minimal-breaking}, is dedicated
149 to books with many pages or a lot of texts.
152 A table of contents is included using @code{\markuplines \table-of-contents}.
153 Elements are added to it using the @code{\tocItem} command.
156 Text spreading over several pages is entered using the
157 @code{\markuplines} keyword. Builtin markup list commands, such as
158 @code{\justified-lines} or @code{\wordwrap-lines} may be used, and new
159 ones created using the @code{define-markup-list-command} Scheme macro.
162 Particular points of a book may be marked with the @code{\label}
163 command. Then, the page where these points are placed can be refered to
164 using the @code{\page-ref} markup command.
167 Page breaking and page turning commands (@code{\pageBreak},
168 @code{\noPageBreak}, etc) can be used at top-level, between scores and
172 The following options are now changed as a @code{-d} sub-option:
173 @code{--backend}, @code{--safe}, @code{--preview} and
174 @code{--no-pages} (which became @code{-dno-print-pages}). The @code{-b}
175 option does not exist any more.
178 Improved testing procedure now catch changes in CPU and memory
179 performance, page layout, MIDI results and warnings. This helps to
180 reduce the number of regression errors during development, resulting
181 in more stable releases.
183 See @uref{INSTALL.html#testing} for more information.
185 Nested properties, such as @code{details} in @code{Slur}, can be
186 reverted as well. The syntax for this is
189 \revert Slur #'(details closeness-factor)
193 All line spanners are more flexible now in the configuration of
194 their end points. This includes glissando, voice followers, text
195 crescendos and other text spanners. The old syntax for setting
196 text on line spanners is no longer valid.
200 \override Glissando #'bound-details #'right #'text = \markup { \hcenter \bold down }
201 \override Glissando #'bound-details #'right #'Y = #-4
202 \override Glissando #'bound-details #'right #'padding = #0.0
203 \override Glissando #'bound-details #'left #'arrow = ##t
204 \override Glissando #'bound-details #'left #'padding = #3.0
205 \override Glissando #'style = #'trill
206 \override Glissando #'springs-and-rods = #ly:spanner::set-spacing-rods
207 \override Glissando #'minimum-length = #12
213 This feature was sponsored by Trevor Bača.
217 The environment variable LILYPONDPREFIX has been renamed to
221 Notes or rests, such as a typical end note, that fill an entire
222 measure are preceded by some more space.
224 @lilypond[ragged-right]
234 @item All @code{\score}s in a lilypond-book fragment are now inserted
235 into the document. Also, toplevel markups don't result in an entire
238 @item Alterations (such as a sharp and flat) may now be arbitrary
239 fractions. This allows some forms of microtonal music. For example,
240 Turkish makam music uses 1/9th tone alterations.
242 @lilypondfile{makam.ly}
246 @item Tie directions may be set with @code{^~} and @code{_~}
248 @item Tablature now supports harmonics and slides,
250 @lilypond[fragment,ragged-right,relative=1]
253 <c g'\harmonic> d\2\glissando e\2
257 This feature was sponsored by Mike Amundsen
259 @item Horizontal spacing now follows object outlines more
260 accurately. This allows tighter horizontal spacing.
262 @lilypond[fragment,ragged-right]
270 @item Objects that belong outside of the staff are
271 now positioned automatically to avoid collisions.
273 @lilypond[fragment,ragged-right,relative=1]
275 \once \override TextScript #'self-alignment-X = #CENTER
276 a,^"this doesn't collide with the c"
277 b^"this goes above the previous markup"
278 a8_"this goes below the dynamic"
282 @item Staves are spaced vertically using a skyline algorithm. This helps to avoid
283 uneven vertical spacing.
285 @lilypond[ragged-right]
287 %% todo: fix 'landscape PDF.
288 #(set-default-paper-size "a6" )
296 a,,1 | a'4 b' c'' d'' \break
297 \repeat unfold 2 {a' b' c'' d''} | b''''1
303 @item Metronome marks can now also contain a textual description. The
304 duration and count (if given) are shown in parentheses after the text.
311 \tempo "Andante" 4 = 120
323 @item In figured bass you can now also use a backslash through a number to
324 indicate a raised 6th step.
326 @lilypond[ragged-right]
327 \new FiguredBass \figuremode { < 6\\ 5\\ > < 6/ > }
335 For older news, go to
336 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
337 or @uref{../,go back} to the Documentation index.