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