1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
2 @setfilename lilypond-changes.info
3 @settitle LilyPond Changes
8 @macro inputfileref{DIR,NAME}
9 @uref{../../\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
11 @macro usermanref{NAME}
12 @inforef{\NAME\,,../user/lilypond/lilypond}@c
17 @macro inputfileref{DIR,NAME}
20 @macro usermanref{NAME}
21 See user manual, \NAME\
25 @macro textanchor{NAME}
32 @documentencoding utf-8
39 @top New features in 2.18 since 2.16
41 @allowcodebreaks false
49 * add new items at the top
51 * only show verbatim input for syntax/input changes
53 * try to be as brief possible in those cases
55 * don't try to provide real-world examples, they often get too big,
56 which scares away people.
58 * Write complete sentences.
60 * only show user-visible changes.
65 Tuplets are now created with the @code{\tuplet} command, which
66 takes a fraction @code{@var{t}/@var{n}} to specify that @var{t}
67 notes are played in the time usually allowed for @var{n}. One
68 @code{\tuplet} command can create several tuplet groups if their
69 duration is typed after the fraction.
70 @lilypond[quote,verbatim,relative=2]
71 \tuplet 3/2 { c8 d e } \tuplet 3/2 { f e d } c2
72 \tuplet 3/2 4 { c8 d e f e d } c2
74 The @code{\times} command with its inverted fraction order
75 @code{@var{n}/@var{t}} is still available.
78 Introducing two new markup-commands; @code{\draw-dashed-line} and
79 @code{\draw-dotted-line}.
82 The dashed-line extends to the whole length given by @var{dest}, if
83 @code{full-length} is set to @code{#t} (this is the default) without any
84 space at the beginning or end. @code{off} will then be altered to fit.
85 To insist on the given (or default) values of @code{on}, @code{off} use
86 @code{\override #'(full-length . #f)}. Manual settings for @code{on},
87 @code{off} and @code{phase} are possible.
90 The dotted-line always extends to the whole length given by @var{dest},
91 without any space at the beginning or end. Manual settings for
92 @code{off} are possible to get larger or smaller space between the dots.
93 The given (or default) value of @code{off} will be altered to fit the
96 @lilypond[verbatim,quote]
98 \draw-dashed-line #'(5.1 . 2.3)
99 \override #'(on . 0.3)
100 \override #'(off . 0.5)
101 \draw-dashed-line #'(5.1 . 2.3)
102 \draw-dotted-line #'(5.1 . 2.3)
103 \override #'(thickness . 2)
104 \override #'(off . 0.2)
105 \draw-dotted-line #'(5.1 . 2.3)
110 Starting with version@tie{}2.17.10, error messages or the
111 @code{textedit} @acronym{URI} used for point-and-click
112 functionality specify column numbers starting with@tie{}1 rather
113 than@tie{}0. The byte offset (also part of @code{textedit}
114 @acronym{URI}s) still starts at@tie{}0.
117 The @code{\clef} command supports optional octavation:
118 @lilypond[verbatim,quote,relative=1]
126 The LilyPond syntax of dot-separated words @code{Voice.Accidental}
127 has been made interchangeable with @code{#'(Voice Accidental)}, a
128 Scheme list of symbols. As one result, code like
130 \override Voice.TextSpanner #'(bound-details left text) = "rit."
134 \override Voice.TextSpanner bound-details.left.text = "rit."
138 \override #'(Voice TextSpanner) bound-details.left.text = "rit."
142 Grob and grob property path no longer need to be specified as two
143 separate arguments to commands like @samp{\override} and
144 @code{\revert}, allowing for the syntax
146 \override Voice.TextSpanner.bound-details.left.text = "rit."
148 Since complementary music functions like @samp{\overrideProperty}
149 cannot support forms with and without separating space at the same
150 time, using a single dotted path is now the preferred form.
151 Specifying grob path and grob property path separately, currently
152 still supported with @samp{\override} and @samp{\revert} for
153 compatibility reasons, is deprecated.
156 Due to words now being accepted as symbol function arguments, the
157 interfaces of @samp{\accidentalStyle}, @samp{\alterBroken},
158 @samp{\footnote} and @samp{\tweak} had to be redesigned where
159 optional symbol arguments were involved. Please check the
160 respective music function documentation for details.
163 Several commands now accept symbol lists (conveniently entered as
164 dot-separated words) for various kinds of arguments. These
165 include @samp{\accidentalStyle}, @samp{\alterBroken},
166 @samp{\footnote}, @samp{\hide}, @samp{\omit},
167 @samp{\overrideProperty}, @samp{\shape}, and @samp{\tweak}.
170 The bar line user interface has changed. Bar glyphs now resemble the
171 appearance of the bar line, so a left repeat sign has to be coded
172 as @code{.|:}. The command @code{\defineBarLine} provides an easy way
173 to define additional bar line styles.
176 Accidentals in the key signature may be printed in octaves other
177 than their traditional positions, or in multiple octaves.
178 @lilypond[quote,relative=0]
179 \override Staff.KeySignature #'flat-positions = #'((-5 . 5))
180 \override Staff.KeyCancellation #'flat-positions = #'((-5 . 5))
181 \clef bass \key es\major es g bes d
182 \clef treble \bar "||" \key es\major es g bes d
183 \override Staff.KeySignature #'sharp-positions = #'(2)
184 \bar "||" \key d\major b fis b2
190 For older news, go to
191 @uref{http://lilypond.org/doc/v2.16/Documentation/changes/},
192 @uref{http://lilypond.org/doc/v2.14/Documentation/changes/},
193 or @uref{../,go back} to the Documentation index.