ANNOUNCEMENT — v6.2.0 released

[Fr. Samuel Springuel]

The Gregorio team is happy to announce the release of v6.2.0 of Gregorio. The release marks the first time we've had complete test coverage on all 3 major OS families (Windows, Linux, and macOS).

Due to delays in publishing this release, it is not part of TeX Live 2026 and will not be pushed to CTAN. To upgrade, you must install using the appropriate resource from the release page linked below. Since this is not the first time we've had problems getting a release completed in time for TeX Live's annual release (though it is the first time we've actually missed the release in a while), we'll be revising our release timeline in order to ensure that our next release makes it into TeX Live 2027.

Download here: https://github.com/gregorio-project/gregorio/releases/tag/v6.2.0

## UPGRADE from 6.1

### LuaTeX >= 1.0 required

The minimum required version of LuaTeX is now 1.0 (released in 2016). Attempts to compile documents with older versions of LuaTeX will result in an error.

### `grefinalpenalty`

The count `grefinalpenalty` no longer has any effect and will be removed in a future release.

### Final `Z` and `z`

Forced line breaks (`Z` or `z`) at the very end of a score are discouraged. Please use `\gresetlastline{ragged}` or `\gresetlastline{justified}` instead to set the appearance of the last line.

### `spaceabovelines` and `abovelinestextheight` changed meaning

The meanings of these distances were changed to be (hopefully) easier to use and closer to their descriptions in the documentation. Please see the section "Vertical spacing" in GregorioRef.pdf for more information. Scores that use the default settings and have above-lines text (`<alt>`) will now have slightly more whitespace above the above-lines text. Scores that set either of these two distances explicitly may experience larger changes in whitespace between staves, and should be checked.

### `spaceabovelines` and `spacebeforesigns` changed from skips to dimens

These spaces were changed from skips to dimens; that is, they can no longer have stretch or shrink (`plus` or `minus`). For example, a command `\grechangedim{spacebeforesigns}{0.050 cm plus 0.004 cm minus 0.004 cm}{scalable}` should be changed to `\grechangedim{spacebeforesigns}{0.050 cm}{scalable}`.

- In previous versions, stretch/shrink on `spaceabovelines` was ignored, so removing stretch/shrink will not change the output.
- In previous versions, stretch/shrink on `spacebeforesigns` was causing a double punctum mora to be misaligned, so removing stretch/shrink should improve the output.


## What's Changed
* One-pass computation of line spacing by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1641
* Trim staff lines on last line by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1627
* Fix overfull \hbox warning in ledger lines by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1646
* Fix bug causing an error on scores with two line breaks in a row by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1653
* Change mora_vposition from a bitfield to its own field by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1654
* Clarify vertical spacing by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1659
* Some fixes to the documentation by @rpspringuel in https://github.com/gregorio-project/gregorio/pull/1651
* Windows make by @rpspringuel in https://github.com/gregorio-project/gregorio/pull/1640
* Speed up \gre@createdim by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1664
* Add missing newlines in error messages by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1666
* NABC+abovelinestext and NABC below lines by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1662
* Eliminate \gre@luasavedim by using the "new" token library by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1679
* Yearly Maintenance plus by @rpspringuel in https://github.com/gregorio-project/gregorio/pull/1687
* Print commentary even when first syllable has no text (#1678) by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1681
* Add overtie/undertie symbols, and lyric tying shorthand by @lbssousa in https://github.com/gregorio-project/gregorio/pull/1684
* Change spacebeforesigns from a skip to a dimen (#1656) by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1682
* Missing CHANGELOG entry by @rpspringuel in https://github.com/gregorio-project/gregorio/pull/1689
* Missing CHANGELOG entries by @rpspringuel in https://github.com/gregorio-project/gregorio/pull/1690
* Change spaceabovelines from a skip to a dimen by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1697
* checkSyllabation.py: Handle more tags; handle words with notes only at the end by @bhank in https://github.com/gregorio-project/gregorio/pull/1671
* Make bool.h compatible with C23 (used by default by GCC 15) by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1696
* Correct recording of files read and written in Lua by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1692
* Add/remove documentation - fixes #1704 by @eschwab in https://github.com/gregorio-project/gregorio/pull/1705
* Enhanced Visibility Controls by @lbssousa in https://github.com/gregorio-project/gregorio/pull/1683
* Add commands to documentation for macros with long arg tables by @rpspringuel in https://github.com/gregorio-project/gregorio/pull/1707
* Fix parser handling of empty GABC/NABC snippets (#1700) by @lbssousa in https://github.com/gregorio-project/gregorio/pull/1701
* feat: add configurable NABC horizontal alignment mode (#1702) by @lbssousa in https://github.com/gregorio-project/gregorio/pull/1703
* Fix conflict between develop and ctan branches after merging PRs #1701 and #1703 by @lbssousa in https://github.com/gregorio-project/gregorio/pull/1709
* Fix regressions introduced after ctan merge (#1708) by @lbssousa in https://github.com/gregorio-project/gregorio/pull/1711
* New feature: \gresetnabcskipalterations by @lbssousa in https://github.com/gregorio-project/gregorio/pull/1714
* Add shim for lfs.mkdirp for compatibility with LuaTeX < 1.18 by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1730
* Unset glyph height attributes right after glyph is emitted. Fixes #1717. by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1721
* Use signed char instead of char for a pitch or ambitus by @davidweichiang in https://github.com/gregorio-project/gregorio/pull/1731
* Fix segfault on empty GRE_ELEMENT when nabc_state wraps mid-syllable (#1726) by @lbssousa in https://github.com/gregorio-project/gregorio/pull/1727
* Handle option errors internally by @rpspringuel in https://github.com/gregorio-project/gregorio/pull/1739

## New Contributors
* @lbssousa made their first contribution in https://github.com/gregorio-project/gregorio/pull/1684
* @bhank made their first contribution in https://github.com/gregorio-project/gregorio/pull/1671

**Full Changelog**: https://github.com/gregorio-project/gregorio/blob/v6.2.0/CHANGELOG.md

✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝
Fr. Samuel, OSB
(R. Padraic Springuel)
St. Anselm’s Abbey
4501 South Dakota Ave, NE
Washington, DC, 20017
202-269-2300
(c) 202-853-7036

PAX ☧ ΧΡΙΣΤΟΣ