]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/topdocs/NEWS.tely
(Top): add new feature.
[lilypond.git] / Documentation / topdocs / NEWS.tely
1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
2 @setfilename NEWS.info
3 @settitle NEWS
4
5 @ifhtml
6 @macro inputfileref{DIR,NAME}
7 @uref{../../\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
8 @end macro
9 @macro usermanref{NAME}
10 @inforef{\NAME\,,../user/lilypond/lilypond}@c
11 @end macro
12 @end ifhtml
13
14 @ifnothtml
15 @macro inputfileref{DIR,NAME}
16 @file{\DIR\/\NAME\}@c
17 @end macro
18 @macro usermanref{NAME}
19 See user manual, \NAME\
20 @end macro
21 @end ifnothtml
22
23
24 @macro textanchor{NAME}
25 @html
26 <a name="\NAME\"></a>
27 @end html
28 @end macro
29
30
31 @documentencoding utf-8
32 @documentlanguage en
33
34 @finalout
35
36 @ifnottex
37 @node Top
38 @top
39 @end ifnottex
40 @unnumbered New features in 2.9 since 2.8
41
42 @ifhtml
43 This document is also available in @uref{NEWS.pdf,PDF}. It's part of
44 the @uref{../,LilyPond Documentation} 
45 @end ifhtml
46
47
48
49
50 @itemize @bullet
51
52 @ignore
53
54 HINTS
55
56 * only show verbatim input for syntax/input changes
57
58 * try to be as brief possible in those cases
59
60 * don't try to provide real-world examples, they often get too big,
61 which scares away people.
62
63 * Write complete sentences.
64
65 * only show user-visible changes. 
66
67 @end ignore
68
69 @item Lyric texts may include tie symbols by using the @code{~}
70 symbol,
71
72 @lilypond[relative=1,fragment,ragged-right]
73   { c4 f2 g4 }
74   \addlyrics {
75     o la~la la
76   } 
77 @end lilypond
78
79 @item Calculation of note head durations is now softcoded. 
80
81 @lilypond[relative=1,fragment,ragged-right]
82   %% use half heads for whole notes.
83   \override NoteHead #'duration-log = 1                                         
84   c1 c2 c4 c8[ c16 c]
85 @end lilypond
86
87
88 @c Please insert any new material above this line.  -gp
89
90 @item Chords can now be partially tied,
91
92 @lilypond[ragged-right,relative,fragment]
93 <c~ e g~ b>  <c e g b>
94 @end lilypond
95
96 This feature was sponsored by Steve Doonan.
97
98 @item Lyric extenders now have tunable padding.
99
100 This feature was sponsored by David Griffel.
101
102 @item
103 Instrument changes are better supported: names in the margin can be
104 changed half-way during a staff, and cues are printed automatically.
105
106 This feature was sponsored by Kieren MacMillan.
107
108 @item
109 Barlines can be dashed now,
110
111 @lilypond[relative,ragged-right,fragment]
112 c4 \bar "dashed" c4
113 @end lilypond
114
115 This feature was sponsored by Kieren MacMillan.
116
117 @item
118 Grace notes may be forced to use floating spacing, 
119
120 @lilypond[relative=2,ragged-right]
121 <<
122   \override Score.SpacingSpanner  #'strict-grace-spacing = ##t
123   \new Staff {
124      c'4
125      \afterGrace
126      c'4
127      { c'16[ c'8 c'16] }
128      c'4
129   }
130   \new Staff {
131      c'16[ c'16 c'16 c'16]
132      c'16[ c'16 c'16 c'16]
133      c'4
134   }
135 >>
136 @end lilypond
137
138 This feature was sponsored by Trevor Bača.
139
140
141 @item
142 Durations of grace notes are taken into account for spacing,
143
144 @lilypond[relative=2,ragged-right,fragment]
145   c
146   \grace { c8[ c16 d c8]  }
147   c
148 @end lilypond
149
150 This feature was sponsored by Trevor Bača.
151
152 @item
153 Tuplet brackets can be made to run to prefatory matter or
154 the next note
155
156 @lilypond[ragged-right]
157 \new RhythmicStaff {
158   \set tupletFullLength = ##t
159   \time 4/4
160   \times 4/5 {
161     c4 c1
162   }
163   \set tupletFullLengthNote = ##t
164   \time 2/4
165   \times 2/3 {
166     c4 c c 
167   }
168   \time 3/4
169   c4 
170 }
171 @end lilypond
172
173
174 This feature was sponsored by Trevor Bača.
175
176 @item
177 Falls and doits can be added to notes
178
179 @lilypond[fragment,ragged-right,relative=2]
180 \override Score.SpacingSpanner #'shortest-duration-space = #3.0
181 c4-\bendAfter #+5
182 c4-\bendAfter #-3
183 @end lilypond
184
185 This feature was sponsored by Anthony Youngman and Paul Scott.
186
187 @item
188 @code{lilypond-book} now includes support for PDF@TeX{}.
189
190 This feature was sponsored by David Roundy. 
191
192 @item
193 Nested tuplets can have different formatting for each nesting level,
194
195 @lilypond[ragged-right]
196 \new Staff {
197   \time 5/4
198   \tweak #'text #tuplet-number::calc-fraction-text
199   \times 5/3 {
200      \tweak #'text  #tuplet-number::calc-denominator-text
201      \times 2/3 {
202         c'8[ c'8 c'8]
203      }
204      \times 2/3 {
205         c'8[ c'8 c'8]
206      }
207      \times 2/3 {
208         c'8[ c'8 c'8]
209      }
210   }
211 }
212 @end lilypond
213
214 This feature was sponsored by Trevor Bača.
215
216
217 @item
218 New sections with different spacing parameters can be started with
219 @code{newSpacingSection}.  This is useful when there are  
220 sections with a different notions of long and short notes.
221
222 In the following example, the time signature change introduces a new
223 section, and hence the 16ths notes are spaced wider.
224
225 @lilypond[relative,fragment]
226   \time 2/4
227   c4 c8 c 
228   c8 c c4 c16[ c c8] c4
229
230   \newSpacingSection
231   \time 4/16
232   c16[ c  c8]
233 @end lilypond
234
235 This feature was sponsored by Trevor Bača, Michael Meixner and Vivian
236 Barty-Taylor.
237
238 @item
239 A new, automated testing technique has been added. It will detect
240 changes in the formatting automatically, which will make it easier to
241 spot regression errors in the future.
242
243 View @uref{../../test-results.html,test results}.
244
245 @item
246 Figured bass can also be added to @code{Staff} contexts directly. In
247 this case, their vertical position is adjusted automatically.
248
249 @lilypond[ragged-right,fragment]
250 <<
251   \new Staff = someUniqueName
252   \relative c'' {
253     c4 c'8 r8 c,4 c'
254   }
255
256   %% send to existing Staff.
257   \context Staff = someUniqueName 
258   \figuremode {
259     <4>4 <6 10>8 s8
260     
261     \set Staff.useBassFigureExtenders = ##t
262     <4 6>4 <4 6>
263   }
264 >>
265 @end lilypond
266
267 This feature was sponsored by Trent Johnston.
268
269 @item
270 Beams may be put on isolated stems, and beamlets may be paired by
271 setting the @code{max-beam-connect} property,
272
273 @lilypond[ragged-right,relative=2,fragment]
274   \override Stem #'max-beam-connect = #1
275   c16[ c16]   c32[] 
276 @end lilypond
277
278 This feature was sponsored by Trevor Bača.
279
280 @item
281 Beaming patterns obey the @code{beatGrouping} property.
282
283 @lilypond[ragged-right,relative=2,fragment]
284   \time 5/16
285   \set beatGrouping = #'(2 3)
286   c8[^"(2+3)" c16 c8]
287   \set beatGrouping = #'(3 2)
288   c8[^"(3+2)" c16 c8]
289 @end lilypond
290
291 This feature was sponsored by Trevor Bača.
292
293 @item
294 With the command @code{\transposedCueDuring} a cue's transposition can
295 be changed locally.  This can be used to prevent excessive ledger
296 lines on cues.
297
298 This feature was contributed by Werner Lemberg 
299
300 @item
301 By setting @code{hairpinToBarline}, hairpins will stop at
302 the barline preceding the ending note.
303
304 @lilypond[relative=2,fragment,ragged-right]
305 \set hairpinToBarline = ##t
306 \override Hairpin #'bound-padding = #1.0
307 c4\< c2. c4\!
308 @end lilypond
309
310 This feature was sponsored by Andrew Sidwell and Trevor Bača.
311
312 @item
313 Objects may be rotated using the @code{rotation} property.
314 @lilypond[ragged-right,fragment,relative=1]
315 {
316   \override Hairpin #'rotation = #'(20 -1 0)
317   g4\<^\markup { \rotate #180 "test" } b d f'\!
318 }
319 @end lilypond
320
321 This feature was contributed by Erlend Aasland.
322
323 @item
324 Hairpins now support circled tips (al niente notation).
325 @lilypond[ragged-right,fragment,relative=2]
326 {
327   \override Hairpin #'circled-tip = ##t
328   c2\< c\!
329   c4\> c\< c2\!
330 }
331 @end lilypond
332
333 This feature was contributed by Erlend Aasland.
334
335 @item 
336 The MusicXML convertor has been sped up, and has rudimentary support
337 for percussion notation.  It will also condense multi-bar rests to
338 enable part extraction.
339
340 @item
341 The beam printing code has been completely rewritten, and now includes
342 support for feathered beaming,
343
344 @lilypond[ragged-right,fragment,relative=2]
345 \featherDurations #(ly:make-moment 5 4) 
346 {
347   \override Beam #'grow-direction = #LEFT
348   c16[
349     c c c
350     c c c ]
351 }
352 @end lilypond 
353
354 Known bug: the \featherDuration command only works with very short music
355 snippets.
356
357 This feature was sponsored by Jamie Bullock.
358
359 @item
360 The @code{\note} markup command now also accepts note head styles.
361
362 @lilypond[ragged-right,fragment,relative=2]
363 c4^\markup {
364   \override #'(style . triangle) \note-by-number #2 #1 #1 = 100
365 }
366 @end lilypond
367
368 This feature was sponsored by Jamie Bullock.
369
370 @item
371 Tie chord formatting also works with arpegiated
372 ties.
373
374 @lilypond[ragged-right]
375 \relative c'' {
376   <e c a f>2~ <e c a f> |
377   \set tieWaitForNote = ##t
378   e8~ c~ a~ f~ <e' c a f>2 |
379   f,8~ a~ c~ e~ <f, a c e>2 |
380 }
381 @end lilypond
382
383
384 This feature was sponsored by Steve Doonan.
385
386
387 @end itemize
388
389
390
391 @ifhtml
392 For older news, go to
393 @uref{http://lilypond.org/doc/v2.8/Documentation/topdocs/NEWS.html},
394 or @uref{../,go back} to the Documentation index.
395
396
397 @end ifhtml
398
399 @bye