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

This document lists changes and new features in LilyPond version 2.27.1
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
===================

   • 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 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.

