LilyPond -- Changes
*******************

This document lists changes and new features in LilyPond version 2.27.2
since 2.26.

          Note: LilyPond releases can contain syntax changes, which may
          require modifications in your existing files written for older
          versions so that they work in the new version.  To upgrade
          files, it is *strongly recommended* to use the ‘convert-ly’
          tool distributed with LilyPond, which is described in
          (lilypond-usage)Updating files with convert-ly.  ‘convert-ly’
          can perform almost all syntax updates automatically.
          Frescobaldi users can run ‘convert-ly’ directly from
          Frescobaldi using “Tools > Update with convert-ly...”.  Other
          editing environments with LilyPond support may provide a way
          to run ‘convert-ly’ graphically.

LilyPond -- Changes
Major changes in LilyPond
New for musical notation
  Pitches improvements
  Rhythm improvements
  Expressive mark improvements
  Repeat improvements
  Editorial annotation improvements
  Text and font improvements
New for specialist notation
Miscellaneous improvements

Major changes in LilyPond
*************************

None so far.

New for musical notation
************************

Pitches improvements
====================

None so far.

Rhythm improvements
===================

   • The new ‘\measure’ command changes the measure length to match the
     duration of the given music and restores it afterward.

          \fixed c'' {
            d2( c)
            \measure { d\breve }
          }
[[image of music]]

   • The new ‘\measureRemainder’ command is similar to ‘\measure’, but
     it can be used to complete a measure that has already begun.

   • The new ‘\setMeasureLengthFromHere’ command simplifies creating
     irregular measures by setting the measure length relative to the
     current measure position.  This complements ‘\partial’, which
     changes the measure position relative to the measure length.  The
     new ‘\setDefaultMeasureLength’ command restores the measure length
     to the value dictated by the time signature.

   • The new ‘\premeasure MUSIC’ command is an abbreviation for
     ‘\partial DURATION MUSIC’ that computes the duration automatically.

   • By default, strictly alternating meters consisting of 4/4 and 2/2
     are printed in a historic style using multiple C or cut-C symbols.

          {
            \time #'((2 . 2) (2 . 2))
            b'1 2 2
          }
[[image of music]]

   • The automatic beaming algorithm now can be told to interrupt an
     automatically created beam at some point using ‘\beamBreak’.
     Similarly, using ‘\noBeamBreak’, two adjoining notes can be forced
     to get beamed together:

          \relative {
            c''8 c c c d d \beamBreak d d
            \time 2/4
            c8 8 8 8
            8 8 \noBeamBreak 8 8
            4. 8 \noBeamBreak
            8 4 8
          }
[[image of music]]

Expressive mark improvements
============================

None so far.

Repeat improvements
===================

None so far.

Editorial annotation improvements
=================================

   • The Scheme function ‘parenthesize-stencil’ got an optional argument
     to lengthen the parentheses.

   • The Scheme function ‘bracketify-stencil’ got an optional argument
     to lengthen the brackets.

Text and font improvements
==========================

   • An equal sign was added to the Emmentaler font.

   • A senza-misura time signature was added to the Emmentaler font.

[[image of music]]

   • Text variant glyphs for common time and cut time symbols were added
     to the Emmentaler font.  They can be either accessed directly as
     Unicode characters or using the ‘\text-common-time’ and
     ‘\text-cut-time’ markup commands.

[[image of music]]

   • Fonts may be changed in a single markup using ‘\font-select’.  The
     font names for the serif, sans and typewriter families are chosen
     independently.

          \markup \font-select #'((sans . "DejaVu Sans")
                                  (typewriter . "DejaVu Sans Mono"))
          {
            \sans \line { Sans-serif font. }
            \typewriter \line { Typewriter font. }
            \line { Default serif font. }
            \font-select #'(serif . "DejaVu Serif")
            \line { Changed serif font. }
          }
[[image of music]]

New for specialist notation
***************************

   • The chord name input ‘X:1/X’ gets now rendered as ‘N.C./X’.

          \chords { d:1/d }
[[image of music]]

   • White mensural ligatures now support final ascending longae facing
     backwards, obey tweaks in more cases, and handle errors more
     gracefully.

          \score {
            \new PetrucciStaff {
              \clef "petrucci-c4"
              \[ g\breve f \tweak ligature-pes ##t c'\longa \]
            }
          }
[[image of music]]

   • Stanza numbers in lyrics are now created with a dedicated ‘\stanza
     ...’ command.  This replaces the former syntax ‘\set stanza = ...’.

          \relative {
            c'4 c g' g
            a a g2
          }
          \addlyrics {
            \stanza "1."
            Twin -- kle, twin -- kle, lit -- tle star
          }
          \addlyrics {
            \stanza "2."
            When the bla -- zing sun is gone
          }
[[image of music]]

   • Stanza numbers in lyrics can now be auto-repeated at the beginning
     of each line.  To activate this feature, set the ‘stanzaReminders’
     property to ‘#t’:

          \new Voice \relative {
            \key e \minor
            b'4 b a g
            fis2 e \break
            b'4 cis d b
            e2 dis \break
            e4 g fis fis
            e1
          }
          \addlyrics {
            \stanza "1."
            \set stanzaReminders = ##t
            Je -- su, mei -- ne Freu -- de,
            mei -- nes Her -- zens Wei -- de,
            \set stanzaReminderText = "(1st)"
            Je -- su, mei -- ne Zier.
          }
          \addlyrics {
            \stanza "2."
            Un -- ter dei -- nem Schir -- men
            bin ich vor den Stür -- men
            \set stanzaReminders = ##t
            \set stanzaReminderText = #make-tiny-markup
            al -- ler Fein -- de frei.
          }
[[image of music]]

   • An alternative to using ‘\pes’ and ‘\flexa’ (which internally do
     the same) is the command ‘\~’.  This isn't new (being introduced in
     2003); however, it stayed undocumented and was broken for some
     time.

          \new VaticanaScore {
            \new VaticanaVoice \relative {
              \[ a \pes b \flexa g \]
            }
          }
[[image of music]]

          \new VaticanaScore {
            \new VaticanaVoice \relative {
              \[ a \~ b \~ g \]
            }
          }
[[image of music]]

Miscellaneous improvements
**************************

   • The new ‘\verboseBarNumbers’ command simplifies documentation
     examples where bar numbers are a central concern.  It might also be
     useful for debugging.

   • The new commands ‘\startGradualTempoChange’ and
     ‘\stopGradualTempoChange’ describe a temporary departure from the
     prevailing tempo.  Currently, these affect only MIDI output.

   • These functions, which have been deprecated since version 2.13.19,
     have been removed: ‘\deprecatedcresc’, ‘\deprecatedendcresc’,
     ‘\deprecateddim’, and ‘\deprecatedenddim’.

   • The ‘glyph-name’ property of a ‘NoteHead’ grob now contains a fully
     qualified glyph name, as documented.  It is no longer necessary to
     replace the stencil just to draw a different note head glyph;
     setting this property suffices.

          {
            c'4
            \once\override NoteHead.glyph-name = "noteheads.s2triangle"
            c'4
          }
[[image of music]]

     As a side effect, the Scheme function ‘note-head::calc-glyph-name’
     is not needed anymore and will be removed after a deprecation
     cycle.  Depending on the intended use case, its use may be replaced
     either by accessing the ‘glyph-name’ property of a specific
     ‘NoteHead’ grob, or by calling ‘select-head-glyph’ for a specific
     notehead style and duration-log.

