]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/topdocs/NEWS.tely
release commit
[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\/out-www/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
8 @end macro
9 @macro usermanref{NAME}
10 @inforef{\NAME\,,../../user/out-www/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 @ifnottex
35 @node Top
36 @top
37 @end ifnottex
38 @unnumbered New features in 2.7 since 2.6
39
40 @ifhtml
41 This document is also available in @uref{NEWS.pdf,PDF}.
42 @end ifhtml
43
44
45
46
47 @itemize @bullet
48
49 @item 
50 Vertical spacing for page layout can now be tuned for each system
51 individually.  The dimensions that can be tuned can be visualized.
52
53 @lilypond[verbatim]
54 #(set-default-paper-size "a7" 'landscape)
55 \book {
56  \score { { c4 } }
57  \paper { annotatespacing = ##t }
58 }
59 @end lilypond
60
61 This feature was sponsored by Trevor Baca and Nicolas Sceaux.
62
63 @item
64 The slope of a stem-tremolo may be set manually
65
66 @lilypond[fragment,relative=1,raggedright]
67 c8:16[ 
68 \once \override StemTremolo #'slope = #0.45
69 c:16 c:16 c:16 ]
70 @end lilypond 
71
72 This feature was sponsored by Sven Axelsson.
73
74 @item
75 Laissez vibrer ties can be created with @code{\laissezVibrer},
76
77 @lilypond[fragment,raggedright,relative=1]
78   <c e g>\laissezVibrer r  <d f>\laissezVibrer
79 @end lilypond
80
81 This feature was sponsored by Henrik Frisk.
82
83 @item
84 The order of words in @code{\markup} commands may now be reversed by
85 setting the @code{text-direction} property. This is useful for
86 Right-to-Left languages like Hebrew.
87
88 This feature was sponsored by Aaron Mehl.
89
90 @item
91 Texts over multi measure rests can stretch the corresponding measure,
92 if the appropriate @code{spacing-procedure} property is set.
93
94 @lilypond[relative=2,fragment,raggedright]
95 \override MultiMeasureRestText #'spacing-procedure
96   = #Multi_measure_rest::set_text_rods
97 c1 R1 R1^"Very long long long text" 
98 @end lilypond
99
100 This feature was sponsored by Kris Shaffer.
101
102
103 @item @textanchor{tie-chords}
104 Formatting of ties in chords has been improved. Ties no longer collide
105 with note heads and stems. In addition, it is possible to manually
106 specify tie formatting
107
108 @lilypond[relative=2, fragment,raggedright]
109   <a c d f> ~ <a c d f>
110   
111   \override TieColumn #'tie-configuration =
112   #'((0 . -1)  (2 . -1) (5.5 . 1) (7 . 1))
113   <b d f g> ~ <b d f g>
114 @end lilypond
115
116 This improvement has been sponsored by Bertalan Fodor, Jay Hamilton,
117 Kieren MacMillan, Steve Doonan, Trevor Baca, and Vicente Solsona
118 Dell¡.
119
120 @item
121 Formatting of isolated, single ties has been improved. Now, ties avoid
122 staff lines, flags and dots, without compromising their shape.
123
124 @lilypond[fragment,raggedright]
125 \relative c'' {
126   \stemUp
127   c16 c2...~ c16 ~ c2... |
128   c4~c8 c8~c16 c16~c32 c16.~[ c64]~ c64[ c8..] |
129 }
130 @end lilypond
131
132 This improvement has been sponsored by Bertalan Fodor, Jay Hamilton,
133 Kieren MacMillan, Steve Doonan, Trevor Baca, and Vicente Solsona
134 Dell¡.
135  
136
137 @item  @textanchor{repeat-counter}
138 With the @code{countPercentRepeats} property,
139 percent repeats get incremental numbers to indicate the accumulated repeat count.
140
141 @lilypond[relative=2,fragment,raggedright]
142 \set countPercentRepeats = ##t
143 \repeat percent 4 { c1 }
144 \time 2/4
145 \repeat percent 4 { c2 c2 }
146 @end lilypond
147
148 This feature was sponsored by Yoshinobu Ishizaki
149                   
150 @item
151 Text scripts such as fingering instructions and dynamics avoid
152 collisions with slurs
153
154 @lilypond[fragment,relative=1]
155 {
156   b_1( f'_1_2_3 c_3_4_5 a)
157   b( f'\p b,)
158   c-2_\markup { \italic {"cresc."}} ( f_\markup {x} c)
159 }
160 @end lilypond
161
162 @item
163 Tuplets can be made to reach the next non-tuplet note by setting the
164 @code{tupletFullLength}  property,
165
166 @lilypond[fragment,relative=2]
167 \new Voice \with {
168   \remove Forbid_line_break_engraver
169   allowBeamBreak = ##t
170 }
171 {
172   \set Score.proportionalNotationDuration = #(ly:make-moment 1 32)
173   \set tupletFullLength = ##t
174   \times 2/3 { c8[ c c] }
175   c4
176 }
177 @end lilypond  
178
179 This feature was sponsored by Trevor Baca. 
180
181 @item
182 When @code{strict-note-spacing} is set, notes are spaced without regard
183 for clefs, bar lines, and grace notes. For example,
184
185 @lilypond[fragment,relative=2]
186 \override Score.SpacingSpanner #'strict-note-spacing = ##t 
187 \new Staff { c8[ c \clef alto c \grace { c16[ c] } c8 c c]  c32[ c32] }
188 @end lilypond
189
190 This feature was sponsored by Trevor Baca. 
191
192 @item
193 Beams support the @code{break-overshoot} property, for example
194
195 @lilypond[relative=2,fragment]
196 \set allowBeamBreak = ##t
197 \override Beam #'break-overshoot = #'(1.0 . 2.0)
198 c2.. c8[ \break c]
199 @end lilypond
200  
201 This feature was sponsored by Trevor Baca. 
202
203 @item
204 Proportional notation is supported.  Notes can be spaced proportional
205 to their time-difference by assigning a duration to
206 @code{proportionalNotationDuration}. For example,
207
208 @lilypond[relative=2,fragment,raggedright]
209 <<
210   \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
211   \new Staff { c8[ c c c c c]  c4 c2 r2 }
212   \new Staff { c2  \times 2/3 { c8 c c } c4 c1 }
213 >>
214 @end lilypond
215
216 This feature was sponsored by Trevor Baca.
217
218 @item 
219 Symbol sizes (e.g. accidentals) are disregarded for spacing if
220 @code{uniform-stretching} of the @code{SpacingSpanner} grob is set,
221
222
223 @lilypond[relative=2,fragment]
224 <<
225   \override  Score.SpacingSpanner #'uniform-stretching = ##t 
226   \new Staff { c16[ c c c c c c c c c16]  }
227   \new Staff {
228     \times 6/7 { c16 c c cis c c c }
229     c8[ c32 c32 c16]
230   }
231 >>
232 @end lilypond
233
234 This feature was sponsored by Trevor Baca.
235  
236 @item
237 Endings of broken tuplet brackets can be tuned.  For example, you can
238 add arrows to the brackets,
239
240 @lilypond[fragment,raggedright,relative=2]
241 \override TupletBracket
242  #'edge-text = #(cons
243              (markup #:arrow-head X LEFT #f)
244              (markup #:arrow-head X RIGHT #f))
245 \times 4/5 {
246  c c c \bar "empty" \break c c
247 }
248 @end lilypond
249
250 This feature was sponsored by Trevor Baca.
251
252
253 @item @textanchor{arrow-glyph}
254 Arrow heads were added to the Feta font.
255
256 @lilypond[]
257 \lyrics {
258   \markup {
259     filled, to the right:  \hspace #2.0 \fontsize #6 \arrow-head #0 #1 ##t
260     open, down: \hspace #2.0 \fontsize #6 \arrow-head #1 #-1 ##f
261   }
262 }
263 @end lilypond
264
265 These glyphs have been sponsored by Trevor Baca.
266
267
268 @item
269 Nested tuplets are automatically positioned,
270
271 @lilypond[fragment,raggedright,relative=2]
272 \set tupletNumberFormatFunction = #fraction-tuplet-formatter
273 \times 4/6 {
274   a4 a 
275   \times 3/5 { a a a a a }
276 }
277 @end lilypond
278
279 @c This feature was sponsored by Trevor Baca.
280 @c where does this fail?
281 This feature was sponsored by Trevor Bača.
282
283 @item
284 Music expressions can be displayed, in LilyPond notation, using the
285 new @code{\displayLilyMusic} function. For instance:
286 @verbatim
287 \displayLilyMusic \transpose c a, { c d e f }
288 @end verbatim
289 will print:
290 @verbatim
291 { a, b, cis d }
292 @end verbatim
293
294 This feature was contributed by Nicolas Sceaux.
295
296 @item
297 The current bar number may be checked with @code{\barNumberCheck}, eg.
298
299 @verbatim
300 \barNumberCheck #22
301 @end verbatim
302
303 @noindent
304 will print a warning if it doesn't happen in measure 22.
305  
306 @item
307 If @code{showLastLength} is set, only the last few measures of a piece
308 are rendered, which speeds up correcting scores. For example, setting
309
310 @verbatim
311 showLastLength = R1*5
312 \score { ... }
313 @end verbatim
314
315 @noindent
316 will render only the last five measures (assuming 4/4 time signature)
317 of a piece.
318
319 @item @textanchor{simple-melismata}
320 Melismata can be specified simply in the lyrics now, eg.
321
322 @lilypond[relative=1,verbatim,fragment]
323 {
324   c d( e) f e d
325 } \addlyrics {
326   Ky -- _ _ ri e
327 }
328 @end lilypond 
329
330 This feature was sponsored by Nancho Alvarez 
331
332 @item
333 Suggested accidentals (for notating musica ficta) may be switched on
334 with @code{suggestAccidentals}
335
336 @lilypond[verbatim,fragment,relative=2]
337 \set suggestAccidentals = ##t
338 ais bis
339 @end lilypond 
340
341 This feature was sponsored by Nancho Alvarez.
342
343 @item
344 The setting @code{whichBar} and time-bookkeeping is now split into a
345 @code{Default_bar_line_engraver} and @code{Timing_translator}
346 respectively.
347
348 @item @textanchor{pitched-trill}
349 Explicit pitches may be added to trills,
350
351 @lilypond[relative,verbatim,fragment]
352   \pitchedTrill c4\startTrillSpan fis f\stopTrillSpan
353 @end lilypond 
354
355 This feature was sponsored by D. Josiah Boothby and Jamie Bullock
356
357 @item
358 Markup now supports formatting of text paragraphs, using
359 @code{\wordwrap} and @code{\justify}.
360
361 This feature was sponsored by Sven Axelsson.
362 @end itemize
363
364 @ifhtml
365 For older news, go to
366 @uref{http://lilypond.org/doc/v2.6/Documentation/topdocs/out-www/NEWS.html}.
367 @end ifhtml
368
369 @bye