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