]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/topdocs/NEWS.tely
* Documentation/topdocs/NEWS.tely (Top): doc 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 Ties may be switched off for individual notes in tied chords,
70
71 @lilypond[ragged-right,relative,fragment]
72 <c e \untied g b> ~  < c e g b >
73 @end lilypond
74
75 This feature was sponsored by Steve Doonan.
76
77 @item Lyric extenders now have tunable padding.
78
79 This feature was sponsored by David Griffel
80
81
82 @item
83 Instrument changes are better supported: names in the margin can be
84 changed half-way during a staff, and cues are printed automatically.
85
86 This feature was sponsored by Kieren MacMillan.
87
88 @item
89 Barlines can be dashed now,
90
91 @lilypond[relative,ragged-right,fragment]
92 c4 \bar "dashed" c4
93 @end lilypond
94
95 This feature was sponsored by Kieren MacMillan.
96
97 @item
98 Grace notes maybe forced to use floating spacing, 
99
100 @lilypond[relative=2,ragged-right]
101 <<
102   \override Score.SpacingSpanner  #'strict-grace-spacing = ##t
103   \new Staff {
104      c'4
105      \afterGrace
106      c'4
107      { c'16[ c'8 c'16] }
108      c'4
109   }
110   \new Staff {
111      c'16[ c'16 c'16 c'16]
112      c'16[ c'16 c'16 c'16]
113      c'4
114   }
115 >>
116 @end lilypond
117
118 This feature was sponsored by Trevor Bača.
119
120
121 @item
122 Durations of grace notes are taken into account for spacing,
123
124 @lilypond[relative=2,ragged-right,fragment]
125   c
126   \grace { c8[ c16 d c8]  }
127   c
128 @end lilypond
129
130 This feature was sponsored by Trevor Bača.
131
132 @item
133 Tuplet brackets can be made to run to prefatory matter or
134 the next note
135
136 @lilypond[ragged-right]
137 \new RhythmicStaff {
138   \set tupletFullLength = ##t
139   \time 4/4
140   \times 4/5 {
141     c4 c1
142   }
143   \set tupletFullLengthNote = ##t
144   \time 2/4
145   \times 2/3 {
146     c4 c c 
147   }
148   \time 3/4
149   c4 
150 }
151 @end lilypond
152
153
154 This feature was sponsored by Trevor Bača.
155
156 @item
157 Falls and doits can be added to notes
158
159 @lilypond[fragment,ragged-right,relative=2]
160 \override Score.SpacingSpanner #'shortest-duration-space = #3.0
161 c4-\bendAfter #+5
162 c4-\bendAfter #-3
163 @end lilypond
164
165 This feature was sponsored by Anthony Youngman and Paul Scott.
166
167 @item
168 @code{lilypond-book} now includes support for PDF@TeX{}.
169
170 This feature was sponsored by David Roundy. 
171
172 @item
173 Nested tuplets can have different formatting for each nesting level,
174
175 @lilypond[ragged-right]
176 \new Staff {
177   \time 5/4
178   \tweak #'text #tuplet-number::calc-fraction-text
179   \times 5/3 {
180      \tweak #'text  #tuplet-number::calc-denominator-text
181      \times 2/3 {
182         c'8[ c'8 c'8]
183      }
184      \times 2/3 {
185         c'8[ c'8 c'8]
186      }
187      \times 2/3 {
188         c'8[ c'8 c'8]
189      }
190   }
191 }
192 @end lilypond
193
194 This feature was sponsored by Trevor Bača.
195
196
197 @item
198 New sections with different spacing parameters can be started with
199 @code{newSpacingSection}.  This is useful when there are  
200 sections with a different notions of long and short notes.
201
202 In the following example, the time signature change introduces a new
203 section, and hence the 16ths notes are spaced wider.
204
205 @lilypond[relative,fragment]
206   \time 2/4
207   c4 c8 c 
208   c8 c c4 c16[ c c8] c4
209
210   \newSpacingSection
211   \time 4/16
212   c16[ c  c8]
213 @end lilypond
214
215 This feature was sponsored by Trevor Bača, Michael Meixner and Vivian
216 Barty-Taylor.
217
218 @item
219 A new, automated testing technique has been added. It will detect
220 changes in the formatting automatically, which will make it easier to
221 spot regression errors in the future.
222
223 View @uref{../../test-results.html,test results}.
224
225 @item
226 Figured bass can also be added to @code{Staff} contexts directly. In
227 this case, their vertical position is adjusted automatically.
228
229 @lilypond[ragged-right,fragment]
230 <<
231   \new Staff = someUniqueName
232   \relative c'' {
233     c4 c'8 r8 c,4 c'
234   }
235
236   %% send to existing Staff.
237   \context Staff = someUniqueName 
238   \figuremode {
239     <4>4 <6 10>8 s8
240     
241     \set Staff.useBassFigureExtenders = ##t
242     <4 6>4 <4 6>
243   }
244 >>
245 @end lilypond
246
247 This feature was sponsored by Trent Johnston.
248
249 @item
250 Beams may be put on isolated stems, and beamlets may be paired by
251 setting the @code{max-beam-connect} property,
252
253 @lilypond[ragged-right,relative=2,fragment]
254   \override Stem #'max-beam-connect = #1
255   c16[ c16]   c32[] 
256 @end lilypond
257
258 This feature was sponsored by Trevor Bača.
259
260 @item
261 Beaming patterns obey the @code{beatGrouping} property.
262
263 @lilypond[ragged-right,relative=2,fragment]
264   \time 5/16
265   \set beatGrouping = #'(2 3)
266   c8[^"(2+3)" c16 c8]
267   \set beatGrouping = #'(3 2)
268   c8[^"(3+2)" c16 c8]
269 @end lilypond
270
271 This feature was sponsored by Trevor Bača.
272
273 @item
274 With the command @code{\transposedCueDuring} a cue's transposition can
275 be changed locally.  This can be used to prevent excessive ledger
276 lines on cues.
277
278 This feature was contributed by Werner Lemberg 
279
280 @item
281 By setting @code{hairpinToBarline}, hairpins will stop at
282 the barline preceding the ending note.
283
284 @lilypond[relative=2,fragment,ragged-right]
285 \set hairpinToBarline = ##t
286 \override Hairpin #'bound-padding = #1.0
287 c4\< c2. c4\!
288 @end lilypond
289
290 This feature was sponsored by Andrew Sidwell and Trevor Bača.
291
292 @item
293 Objects may be rotated using the @code{rotation} property.
294 @lilypond[ragged-right,fragment,relative=1]
295 {
296   \override Hairpin #'rotation = #'(20 -1 0)
297   g4\<^\markup { \rotate #180 "test" } b d f'\!
298 }
299 @end lilypond
300
301 This feature was contributed by Erlend Aasland.
302
303 @item
304 Hairpins now support circled tips (al niente notation).
305 @lilypond[ragged-right,fragment,relative=2]
306 {
307   \override Hairpin #'circled-tip = ##t
308   c2\< c\!
309   c4\> c\< c2\!
310 }
311 @end lilypond
312
313 This feature was contributed by Erlend Aasland.
314
315 @item 
316 The MusicXML convertor has been sped up, and has rudimentary support
317 for percussion notation.  It will also condense multi-bar rests to
318 enable part extraction.
319
320 @item
321 The beam printing code has been completely rewritten, and now includes
322 support for feathered beaming,
323
324 @lilypond[ragged-right,fragment,relative=2]
325 \featherDurations #(ly:make-moment 5 4) 
326 {
327   \override Beam #'grow-direction = #LEFT
328   c16[
329     c c c
330     c c c ]
331 }
332 @end lilypond 
333
334 Known bug: the \featherDuration command only works with very short music
335 snippets.
336
337 This feature was sponsored by Jamie Bullock.
338
339 @item
340 The @code{\note} markup command now also accepts note head styles.
341
342 @lilypond[ragged-right,fragment,relative=2]
343 c4^\markup {
344   \override #'(style . triangle) \note-by-number #2 #1 #1 = 100
345 }
346 @end lilypond
347
348 This feature was sponsored by Jamie Bullock.
349
350 @item
351 Tie chord formatting also works with arpegiated
352 ties.
353
354 @lilypond[ragged-right]
355 \relative c'' {
356   <e c a f>2~ <e c a f> |
357   \set tieWaitForNote = ##t
358   e8~ c~ a~ f~ <e' c a f>2 |
359   f,8~ a~ c~ e~ <f, a c e>2 |
360 }
361 @end lilypond
362
363
364 This feature was sponsored by Steve Doonan.
365
366
367 @end itemize
368
369
370
371 @ifhtml
372 For older news, go to
373 @uref{http://lilypond.org/doc/v2.8/Documentation/topdocs/NEWS.html},
374 or @uref{../,go back} to the Documentation index.
375
376
377 @end ifhtml
378
379 @bye