Documentation/changes.tely

   1 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
   2 @setfilename lilypond-changes.info
   3 @settitle LilyPond Changes
   4
   5 @include macros.itexi
   6
   7 @ifhtml
   8 @macro inputfileref{DIR,NAME}
   9 @uref{../../\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
  10 @end macro
  11 @macro usermanref{NAME}
  12 @inforef{\NAME\,,../user/lilypond/lilypond}@c
  13 @end macro
  14 @end ifhtml
  15
  16 @ifnothtml
  17 @macro inputfileref{DIR,NAME}
  18 @file{\DIR\/\NAME\}@c
  19 @end macro
  20 @macro usermanref{NAME}
  21 See user manual, \NAME\
  22 @end macro
  23 @end ifnothtml
  24
  25 @macro textanchor{NAME}
  26 @html
  27 <a name="\NAME\"></a>
  28 @end html
  29 @end macro
  30
  31
  32 @documentencoding utf-8
  33 @documentlanguage en
  34 @afourpaper
  35
  36 @finalout
  37
  38 @node Top
  39 @top New features in 2.13 since 2.12
  40
  41 @allowcodebreaks false
  42
  43 @itemize @bullet
  44
  45 @ignore
  46
  47 HINTS
  48
  49 * add new items at the top
  50
  51 * only show verbatim input for syntax/input changes
  52
  53 * try to be as brief possible in those cases
  54
  55 * don't try to provide real-world examples, they often get too big,
  56 which scares away people.
  57
  58 * Write complete sentences.
  59
  60 * only show user-visible changes.
  61
  62 @end ignore
  63
  64 @item
  65 The Articulate script by Peter Chubb, which is GPLv3 licensed, is now
  66 a part of the distribution.  It allows easy generation of improved
  67 MIDI files that perform non-legato by default, legato slurs, staccato,
  68 tempo markings, trills, etc.
  69
  70 @example
  71 \include "articulate.ly"
  72 \articulate <<
  73       all the rest of the score...
  74 >>
  75 @end example
  76
  77 @item
  78 Single beat repeats for sixteenth or shorter notes and beat repeats for
  79 measures containing notes of varying durations are now supported.
  80
  81 @lilypond[fragment,relative=2]
  82 \repeat percent 2 { c16 d }
  83 \repeat percent 2 { c32 e }
  84 \repeat percent 2 { c64 f }
  85 \repeat percent 2 { c128 g' }
  86 @end lilypond
  87
  88
  89 @item
  90 Lilypond now engraves woodwind fingering charts.
  91
  92 @lilypond
  93 \relative c' {
  94   \textLengthOn
  95   des1^\markup {
  96     \woodwind-diagram #'bassoon #'((lh . (thumb-cis))
  97                                    (cc . (one two three five six))
  98                                    (rh . (f)))
  99     } _"bassoon"
 100   c1^\markup {
 101     \woodwind-diagram #'oboe #'((rh . (c))
 102                                 (lh . ())
 103                                 (cc . (one two three four five six)))
 104     } _"oboe"
 105
 106 }
 107 @end lilypond
 108
 109 @item
 110 MIDI output has been improved
 111 @itemize @bullet
 112 @item voices are kept separated, which makes the MIDI much more useful for postprocessing
 113 @item optimal channel distribution: identical instruments share the same channel.  This means that e.g. for a full orchestral score there are always 16 (15 plus percussion) diffently sounding instruments available, unrestricted by the number of staves or voices.
 114 @item dynamics are now rendered as note velocities, no longer as midi dynamics.  This improves the sound on [high end] midi renderers.
 115 @end itemize
 116
 117 @item
 118 MIDI-import through Midi2ly is improved
 119 @itemize @bullet
 120 @item Midi2ly now also works on Windows systems
 121 @item MIDI-files with more than 32 tracks are now handled
 122 @item notes on certain simultaneous voices no longer ignored
 123 @item notes overrunning a bar line are no longer truncated
 124 @item initial key signature and time signature are respected
 125 @item a problem with octaves in subsequent tracks/voices is fixed
 126 @item initial support for multiple voices notated on one staff
 127 @item the instrumentName is set from track data
 128 @item new --skip option, rests are displayed by default
 129 @item rests overrunning a bar line are not truncated
 130 @item new --include-header option for setting titles
 131 @item new --preview option for big MIDI-files
 132 @end itemize
 133 The first feature was sponsored by Valentin Villenave,
 134 the other features were sponsored by Image-Line Software for FL Studio.
 135
 136 @item
 137 A new @code{Completion_rest_engraver} is available for automatically
 138 converting long rests which overrun bar lines, matching the
 139 @code{Completion_heads_engraver} for notes
 140 @example
 141 \layout @{
 142   \context @{
 143     \Voice
 144     \remove "Note_heads_engraver"
 145     \consists "Completion_heads_engraver"
 146     \remove "Rest_engraver"
 147     \consists "Completion_rest_engraver"
 148   @}
 149 @}
 150 @end example
 151 This feature was sponsored by Image-Line Software for FL Studio.
 152
 153 @item
 154 Dots can be added to the table of contents items using:
 155 @example
 156 \paper @{
 157   tocItemMarkup = \tocItemWithDotsMarkup
 158 @}
 159 @end example
 160
 161 @item
 162 New markup commands @code{\pattern} and @code{\fill-with-pattern} are available.
 163 @lilypond
 164 \markup \column {
 165   \pattern #3 #Y #0.3 \flat
 166   \null
 167   \pattern #7 #X #2 \flat
 168   \override #'(line-width . 40) \fill-with-pattern #1 #CENTER . left right
 169 }
 170 @end lilypond
 171
 172 @item
 173 A minimal composer toolkit of modal transformations is provided.
 174 A motif may be @notation{transposed}, @notation{inverted} and/or
 175 converted to its @notation{retrograde} within any scale.
 176
 177 @lilypond
 178 pentatonicScale = \relative a' { a c d f g }
 179 motif = \relative c'' { d8 c f,4 <a f'> <a f'> }
 180
 181 \new Staff <<
 182   {
 183     \partial 4
 184     \pentatonicScale
 185     \motif
 186     \modalTranspose c a, \pentatonicScale \motif
 187     \modalInversion d'' a' \pentatonicScale \motif
 188     \retrograde \motif
 189   }
 190   {
 191     \partial 4
 192     s4^"pentatonic scale"
 193     s1
 194     s1^"motif"
 195     s1^"transposition"
 196     s1^"inversion"
 197     s1^"retrograde"
 198   }
 199 >>
 200 @end lilypond
 201
 202 @item
 203 Added minimal support for black mensural notation.
 204
 205 @item
 206 Enhanced support for obliqua shapes within white mensural ligatures.
 207
 208 @lilypond
 209 \context MensuralStaff
 210 {
 211   \clef "petrucci-c3"
 212   \[
 213     \override NoteHead #'style = #'semipetrucci
 214     c'\maxima
 215     \override NoteHead #'style = #'blackpetrucci
 216     a\breve
 217     \revert NoteHead #'style
 218     \override NoteHead #'ligature-flexa = ##t
 219     \override NoteHead #'flexa-width = #3
 220     g
 221     g'
 222     \override NoteHead #'flexa-width = #5
 223     c'
 224     d'
 225     \revert NoteHead #'style
 226     c'\longa
 227   \]
 228 }
 229 @end lilypond
 230
 231 @item
 232 Compound time signatures are now supported by the @code{\compoundMeter} command,
 233 which can be used instead of @code{\time}:
 234
 235 @lilypond
 236 \relative c'' {
 237   \compoundMeter #'(3 1 8)
 238   c8 c c c
 239   \compoundMeter #'((2 8) (5 8))
 240   c8 c c c c c c
 241   \compoundMeter #'((1 2 3 8) (1 4) (3 8))
 242   c8 c c c c c c4 c8 c c
 243 }
 244 @end lilypond
 245
 246 @item
 247 Lyrics above a staff must have their @code{staff-affinity} set to
 248 @code{DOWN} or must have their @code{alignAboveContext} property
 249 set in order to be properly aligned.  For more information, see
 250 @ruser{Placing lyrics vertically}.
 251
 252 @item
 253 @code{stringTunings} property values have changed from a list of
 254 semitones above middle C to a list of LilyPond pitch values.
 255 convert-ly will handle the change automatically where the value
 256 of @code{stringTunings} is set to a Scheme constant value.
 257
 258 New commands @code{makeStringTuning} and @code{contextStringTuning}
 259 allow the creation of string tunings in the form of a Lilypond
 260 chord construct.
 261
 262 @item
 263 By using @code{\cueDuringWithClef}, cue notes can now also have their own
 264 clef, which is correctly reset at the end of the cue notes.  At the begin
 265 of each line, the standard clef is still displayed, but the cue clef is
 266 shown after the time/key signature in smaller size.
 267
 268 @lilypond
 269 vI = \relative c'' { \clef "treble" \repeat unfold 40 g4 }
 270 \addQuote vIQuote { \vI }
 271
 272 Solo = \relative c {
 273   \clef "bass"
 274   \cueDuringWithClef #"vIQuote" #DOWN #"treble" { R1 } |
 275   c4 \cueDuringWithClef #"vIQuote" #DOWN #"treble" {
 276     r4 r2 |
 277     r4
 278   } c4 c2 |
 279   \cueDuringWithClef #"vIQuote" #DOWN "soprano" { R1*2 \break R1 } |
 280   c1
 281 }
 282
 283 \score {
 284   <<
 285     \new Staff \new Voice \Solo
 286   >>
 287 }
 288 @end lilypond
 289
 290
 291 @item
 292 Note names can be selected with a new
 293 @code{@bs{}language "italiano"} command, which
 294 can be used in safe mode.  The old
 295 @code{@bs{}include "italiano.ly"} syntax is
 296 still supported for now, but will be deprecated
 297 in the future.
 298
 299 @item
 300 autobeaming is now disabled by @code{\cadenzaOn} and enabled by
 301 @code{\cadenzaOff}.  Beaming in cadenzas should be indicated manually.
 302 Also, if a cadenza is used in a piece with autobeaming disabled, it
 303 will need to be disabled again after the cadenza.
 304
 305 @item
 306 The user is now able to specify the name of the predefined fretboard
 307 table.  This allows the use of multiple tables, with switching between them
 308 based on user input.
 309
 310 @item
 311 The part-combiner's decision to combine/not combine notes can now be customized
 312
 313 @lilypond[quote,relative=2]
 314 \partcombine
 315 \relative c' { c2 \partcombineApart c | \partcombineChordsOnce e' e }
 316 \relative c' { c2 \partcombineApart c | c c }
 317 @end lilypond
 318
 319 @item
 320 Tablature staves show fret numbers only by default. To get the
 321 former style, @code{\tabFullNotation} is provided.
 322
 323 @item
 324 Funk-style and Walker-style shape notes have been added.
 325
 326 @item
 327 Rests will no longer keep a staff alive if @code{\RemoveEmptyStaffContext}
 328 is used.
 329
 330 @item
 331 New option @code{-dinclude-settings=INCLUDEFILE.ly}, which causes lilypond
 332 to include the given file before the score is processed. This allows the
 333 user to change global settings without the need to change the score itself.
 334 That way, several different editions/version (e.g. different page sizes)
 335 can be generated from a file without having to modify the score for each
 336 version.
 337
 338 @item
 339 The autobeaming settings syntax has been changed.  beatLength,
 340 beatGrouping, beamSettings, and measureGrouping have all been eliminated.
 341 Autobeaming is now controlled by baseMoment, beatStructure, and
 342 beamExceptions.  Default settings for each of these properties can be
 343 stored for any time signature in time-signature-settings, so that
 344 when the time signature is changed, the autobeaming will automatically
 345 change.  The new syntax should be much easier and require fewer
 346 overrides.
 347
 348 @item
 349 The SVG backend has optional support for
 350 @uref{http://www.w3.org/Submission/WOFF, WOFF fonts}.  Using the Scheme
 351 option @code{-d svg-woff} together with the SVG backend selection
 352 @code{-d backend=svg}, produces SVG output with CSS WOFF font selection.
 353
 354 @item
 355 The LilyPond G clef has been rotated 1.5 degrees clockwise for improved
 356 balance.  The old and new versions can be compared by looking at the
 357 documentation:
 358 @uref{http://lilypond.org/doc/v2.12/Documentation/user/lilypond/The-Feta-font.html#Clef-glyphs,
 359 old version},
 360 @uref{http://lilypond.org/doc/v2.13/Documentation/notation/the-feta-font.html#Clef-glyphs,
 361 new version}.
 362
 363
 364 @item
 365 Text crescendo spanners can now be added directly using @code{\cresc},
 366 @code{\dim} and @code{\decresc}.
 367 @lilypond[quote,relative=2]
 368 c4\cresc c c c\f |
 369 c4\dim c c c\!
 370 @end lilypond
 371
 372
 373 @item
 374 The documented syntax of @samp{lilypond} environments in the @LaTeX{}
 375 mode of @command{lilypond-book} has been changed to conform with
 376 standard @LaTeX{} syntax: options now come after the environment name:
 377 @example
 378 \begin@{lilypond@}[@var{options}] @dots{}
 379 @end example
 380
 381 The previous syntax with options after @samp{\begin} is still accepted
 382 by @command{lilypond-book} but deprecated.  Something like
 383 @example
 384 sed -i '/begin\[/s/begin\(\[[^]]*]\)\(@{lilypond@}\)/begin\2\1/'
 385 @end example
 386
 387 might do the trick for conversion.
 388
 389 @item
 390 Aesthetics of shape note heads have been enhanced.  Variable line thicknesses
 391 have been implemented.  All note widths have been made consistent.
 392 Minor shape note commands that use the relative major key for scale steps
 393 have been added.
 394
 395 @item
 396 A variant of the Segno sign is provided:
 397 @lilypond[quote,relative=2]
 398 c4 d e f \bar "S"
 399 g4 f e d
 400 @end lilypond
 401
 402 @item
 403 Context modifications (@code{\with} blocks) can be stored in variables and
 404 inserted into contexts or other @code{\with} blocks:
 405 @lilypond[quote,verbatim]
 406 coloredheads = \with { \override NoteHead #'color = #red }
 407 noclef = \with { \remove "Clef_engraver" }
 408 \score {
 409   \new Staff {
 410     \new Voice \with { \coloredheads } \relative c' { c4 e g c }
 411   }
 412   \layout {
 413     \context {
 414       \Staff
 415       \noclef
 416     }
 417   }
 418 }
 419 @end lilypond
 420
 421 @item
 422 A half-open articulation was added:
 423 @lilypond[quote,relative=2]
 424 c4\halfopen
 425 @end lilypond
 426 This is sometimes used to indicate half-open hi-hats.
 427
 428 @item
 429 The Unicode Bidirectional Algorithm is now fully supported for
 430 single-line markup due to enhanced integration with Pango.
 431
 432 @item
 433 LilyPond is now licensed under the GNU GPL v3+.
 434
 435 @item
 436 In tablature, frets can be indicated with labels other than numbers:
 437
 438 @lilypond[verbatim,quote,relative=1]
 439 \new TabStaff
 440 \with {
 441   stringTunings = #`(,(ly:make-pitch 1 3 NATURAL)
 442                      ,(ly:make-pitch 1 1 NATURAL)
 443                      ,(ly:make-pitch 0 5 NATURAL)
 444                      ,(ly:make-pitch 0 3 NATURAL)
 445                      ,(ly:make-pitch 0 1 NATURAL)
 446                      ,(ly:make-pitch -1 5 NATURAL))
 447   tablatureFormat = #fret-letter-tablature-format
 448 }
 449 \new TabVoice {
 450   \set fretLabels = #`(,(markup #:with-color red "a")
 451                        "b"
 452                        ,(markup #:italic #:smaller "c"))
 453   <f d>4. <bes>8 <g e>4
 454 }
 455 @end lilypond
 456
 457 @item
 458 Layout objects can be printed over a white background, which whites-out objects
 459 in lower layers which lie beneath:
 460
 461 @lilypond[verbatim,quote,relative=1]
 462 \time 3/4
 463 \override Staff.StaffSymbol #'layer = #4
 464 \once \override Tie #'layer = #2
 465 b'2.~
 466 \once \override Staff.TimeSignature #'whiteout = ##t
 467 \once \override Staff.TimeSignature #'layer = #3
 468 \time 5/4
 469 b4
 470 @end lilypond
 471
 472 @item
 473 Chords can be repeated using the @code{q} shortcut:
 474
 475 @lilypond[verbatim,quote,relative=2]
 476 <c e g>8.-^ q16 q4-^
 477 @end lilypond
 478
 479 @item
 480 With two-sided mode, margins for odd and even pages can be set using
 481 @code{inner-margin} and @code{outer-margin}:
 482
 483 @example
 484 \paper @{
 485   two-sided = ##t
 486   inner-margin = 10 \mm
 487   outer-margin = 20 \mm
 488 @}
 489 @end example
 490
 491 @item
 492 Paper margin defaults, as specified in @file{ly/paper@/-defaults-init.ly}, apply
 493 to the default paper size (a4) and are automatically scaled according to the
 494 paper size chosen.
 495
 496 @item
 497 All combinations of @code{left-margin}, @code{right-margin} and
 498 @code{line-width} work now.  There is no more need to set @code{line-width}
 499 manually unless you explicitly want to.
 500
 501 @item
 502 Support for using an alternative music font, such as Gonville, is now
 503 added.
 504
 505 @item
 506 In addition to the existing @code{\hspace} markup command,
 507 a new @code{\vspace} command has been added to provide an easy
 508 and flexible way to add vertical space in markups.
 509
 510 @item
 511 The direction of manual beams can be set with @code{^[} and @code{_[}.
 512
 513 @item
 514 A version of the breve note head has been added with two vertical lines on each side.
 515 @lilypond[quote,relative=2]
 516 \time 4/2
 517 \override Staff.NoteHead #'style = #'altdefault
 518 c\breve | b\breve
 519 @end lilypond
 520
 521 @item
 522 Instrument names and vocal names now take into account the extent of
 523 system start delimiters in other staves for their positioning,
 524 resulting in improved default alignment for left-, center- and
 525 right-aligned names.
 526 @lilypond[quote,indent=18\mm]
 527 <<
 528   \new StaffGroup <<
 529     \new GrandStaff <<
 530       \new Staff {
 531         \set Staff.instrumentName = #"Piccolo"
 532         c''1
 533       }
 534       \new Staff {
 535         \set Staff.instrumentName = #"Flute"
 536         c''1
 537       }
 538     >>
 539     \new Staff {
 540       \set Staff.instrumentName = #"Bassoon"
 541       \clef tenor
 542       c'1
 543     }
 544   >>
 545   \new PianoStaff <<
 546     \set PianoStaff.instrumentName = #"Piano"
 547     \context Staff = "up" {
 548       c'1
 549     }
 550     \context Staff = "down" {
 551       \clef bass
 552       c1
 553     }
 554   >>
 555 >>
 556 @end lilypond
 557
 558 @item
 559 Braces in markup can now be selected by point size using the markup commands
 560 @code{\left-brace} and @code{\right-brace}.
 561 @lilypond[quote]
 562 \markup {
 563   \left-brace #35
 564   \hspace #2
 565   \right-brace #45
 566 }
 567 @end lilypond
 568
 569 @item
 570 Intermediate .ps files which are created by LilyPond
 571 during compilation are now deleted by default.  To keep them,
 572 add the following line to your input files:
 573 @example
 574 #(ly:set-option 'delete-intermediate-files #f)
 575 @end example
 576
 577 @item
 578 Dashed and dotted slurs, phrasing slurs, and ties
 579 have been made variable thickness, and
 580 partially dashed slurs are now available:
 581 @lilypond[quote,relative=2]
 582 \slurDashed
 583 c4( d e f) |
 584 \slurDotted
 585 g4( f e d) |
 586 \slurHalfDashed
 587 c4( d e f)
 588 @end lilypond
 589
 590 @item
 591 An eyeglasses markup was added, indicating strongly to look at the
 592 conductor for instructions:
 593 @lilypond[quote,relative=2]
 594 \mark \markup { \eyeglasses }
 595 c4_\markup { \eyeglasses }
 596 @end lilypond
 597
 598 @item
 599 A snap-pizzicato (also known as Bartok-pizzicato) articulation was added:
 600 @lilypond[quote,relative=2]
 601 c4\snappizzicato
 602 @end lilypond
 603
 604 @item
 605 Tuplet number formatting functions are now available to print other fractions
 606 and to add notes to the number or fraction:
 607 @lilypond[quote,relative=2]
 608 \once \override TupletNumber #'text =
 609   #(tuplet-number::non-default-tuplet-denominator-text 7)
 610 \times 2/3 { c4. c4. c4. c4. }
 611
 612 \once \override TupletNumber #'text =
 613   #(tuplet-number::non-default-tuplet-fraction-text 12 7)
 614 \times 2/3 { c4. c4. c4. c4. }
 615 \once \override TupletNumber #'text =
 616   #(tuplet-number::append-note-wrapper
 617     (tuplet-number::non-default-tuplet-fraction-text 12 7) "8")
 618 \times 2/3 { c4. c4. c4. c4. }
 619
 620 \once \override TupletNumber #'text =
 621   #(tuplet-number::append-note-wrapper tuplet-number::calc-denominator-text "4")
 622 \times 2/3 { c8 c8 c8 c8 c8 c8 }
 623 \once \override TupletNumber #'text =
 624   #(tuplet-number::append-note-wrapper tuplet-number::calc-fraction-text "4")
 625 \times 2/3 { c8 c8 c8 c8 c8 c8 }
 626
 627 \once \override TupletNumber #'text =
 628   #(tuplet-number::fraction-with-notes "4." "8")
 629 \times 2/3 { c4. c4. c4. c4. }
 630 \once \override TupletNumber #'text =
 631   #(tuplet-number::non-default-fraction-with-notes 12 "8" 4 "4")
 632 \times 2/3  { c4. c4. c4. c4. }
 633 @end lilypond
 634
 635 @item
 636 FretBoards now have a chordChanges property to keep repeated FretBoard objects
 637 from being typeset.
 638
 639 @item
 640 The vertical spacing engine has been drastically changed, making
 641 it more flexible and easier to control.
 642 The spacing between staves within a system can now change
 643 to better use the space on the page.
 644 User-defined contexts may participate in this flexible spacing,
 645 depending on how their @code{staff-affinity} is defined.
 646 Some page formatting variables (@code{page-top-space},
 647 @code{between-system-space -padding}, and
 648 @code{before- between- after-title-space}) have been replaced
 649 by flexible vertical dimensions.
 650
 651 @end itemize
 652
 653
 654
 655 @ifhtml
 656 For older news, go to
 657 @uref{http://lilypond.org/doc/v2.12/Documentation/topdocs/NEWS.html},
 658 @uref{http://lilypond.org/doc/v2.10/Documentation/topdocs/NEWS.html},
 659 or @uref{../,go back} to the Documentation index.
 660
 661
 662 @end ifhtml
 663
 664 @bye