We're starting the process of an enhancement release in the hopes that
we might be able to sneak it into TeXLive 2016 as that goes through its
PreRelease testing cycle. Of course, there have been some other feature
requests which have been filled since 4.1 was released, so we're
releasing a beta which should allow you to test those. We have not,
however, started to test against the 2016 prerelease. Changes required
by TeXLive 2016 will come later.
Download here:
https://github.com/gregorio-project/gregorio/releases/tag/v4.2.0-beta1
# UPGRADE.md
## 4.2
### Stemmed oriscus flexus orientation
As of version 4.2, the orientation of the stemmed oriscus flexus `(gOe)`
is consistent with the unstemmed oriscus flexus `(goe)` in that the
oriscus points downward (since the note which follows is of lower
pitch). If you prefer the oriscus to point upward, you will need to use
the `1` modifier (as in `(gO1e)`), which will force an upward
orientation of the oriscus.
### Podatus followed by a virga
As of version 4.2, a podatus followed by a virga of the same or higher
pitch as the second note in the podatus (e.g., `(eghv)`) will be kept
together, disallowing a line break between the two shapes. If you would
like to allow a line break between the two shapes, use a `/` or some
other breakable space between them (e.g., `(eg/hv)`).
### Penalties
As of version 4.2, the penalties should be changed by using
`\grechangecount` rather than the old way of redefining macros. The
following tunable values are available (they have the same name as their
old macro counterparts, minus the `gre`):
- `brokenpenalty`
- `clubpenalty`
- `endafterbaraltpenalty`
- `endafterbarpenalty`
- `endofelementpenalty`
- `endofsyllablepenalty`
- `endofwordpenalty`
- `finalpenalty`
- `hyphenpenalty`
- `looseness`
- `newlinepenalty`
- `nobreakpenalty`
- `pretolerance`
- `tolerance`
- `widowpenalty`
See GregorioRef for descriptions.
Additionally, if you were redefining `\greemergencystretch`, you should
now be changing the `emergencystretch` dimension using the
`\grechangedim` command.
### Custos with alteration
If the note following a custos has an alteration (flat, natural, or
sharp), the custos will now also have that alteration typeset before it.
If you prefer the old behavior, use
`\gresetcustosalteration{invisible}`. This setting may be switched to
`visible` and `invisible` between scores.
### Parmesan font renamed to Grana Padano
To avoid conflicts with the LilyPond Parmesan font, the Gregorio
Parmesan font is now called Grana Padano. If you were using
`\gresetgregoriofont{parmesan}`, you should now use
`\gresetgregoriofont{granapadano}`.
### Changes to texmf tree
To better comply with the TeXLive directory structure, the location of
`gregoriotex.sty` and `gregoriosyms.sty` have changed.
*Linux and other users installing from source:* You will need to
manually remove the old versions of these files to avoid version
conflicts. `install-gtex.sh` will be modified in a future beta to do
this for you.
*Mac users installing via pkg:* Please run Uninstall-Gregorio.pkg before
installing 4.2.
*Windows users:* Your installer already should remove old versions of
GregorioTeX before installing the new ones. Please file a bug report if
you have a problem with this process.
# CHANGELOG.md
## [4.2.0-beta1] - 2016-04-27
### Fixed
- A manual custos at the end of the score will now be spaced like
regular end of line custos
[#1034](https://github.com/gregorio-project/gregorio/issues/1034).
- Custos glyphs heights are now counted when adjusting line heights (see
[#961](https://github.com/gregorio-project/gregorio/issues/961)).
### Added
- It is now possible to invert the oriscus orientation on pes quassus
and oriscus flexus shapes. Use `o0` or `o1` to force the oriscus into
the orientation you desire. It is also possible to fuse the oriscus
from either direction in either orientation. See
[#898](https://github.com/gregorio-project/gregorio/issues/898) and
[#972](https://github.com/gregorio-project/gregorio/issues/972).
- Formerly missing torculus figures starting with an oriscus are now
rendered using neume fusion (see
[#1013](https://github.com/gregorio-project/gregorio/issues/1013)).
- Gregorio will keep together (prevent line breaks between) a
user-configurable number of notes (by default, 4) at the start and end
of the syllable. Further, Gregorio will prevent line breaks in a
syllable with fewer than a user-configurable number of notes (by
default, 10). These values may be changed by using the
`\gresetunbreakablesyllablenotes` command. See GregorioRef for details
(for the change request, see
[#1044](https://github.com/gregorio-project/gregorio/issues/1044)).
- The visibility of notes and lyrics can now be toggled on an off using
`\gresetlyrics` and `\gresetnotes`. See
[#1039](https://github.com/gregorio-project/gregorio/issues/1039).
- An alteration (flat, natural, or sharp) will now appear on a custos if
the next note is so altered. Use `\gresetcustosalteration{invisible}`
if you prefer the old behavior. See
[#1049](https://github.com/gregorio-project/gregorio/issues/1049).
- `gregoriosyms.sty` and `gregoriotex.tex` now contain definitions for
`gregoriocolor` and `grebackgroundcolor` and the appropriate score
commands dealing with color now work under PlainTeX
### Changed
- The stemmed oriscus flexus `(gOe)` is now consistent with the
unstemmed oriscus flexus `(goe)` in that the oriscus points downward at
the note that follows. If you prefer to have the oriscus point upward,
use `(gO1e)` for force upward orientation.
- Space before a custos appearing in the middle of a line is now set by
`spacebeforeinlinecustos`.
- The space between two puncta inclinata at the unison may be tuned by
changing `punctuminclinatumunisonshift` (see
[#1042](https://github.com/gregorio-project/gregorio/issues/1042)).
- A podatus followed by a virga `(eghv)` will now be kept together (no
line break between the shapes), If you would like to allow a line break
there, use `(eg/hv)` instead (see UPGRADE.md and
[#1045](https://github.com/gregorio-project/gregorio/issues/1045)).
- Penalties must now be changed using the `\grechangecount` command.
See GregorioRef and [UPGRADE.md](UPGRADE.md) for details (for the change
request, see
[#1021](https://github.com/gregorio-project/gregorio/issues/1021)).
- `\greemergencystretch` must now be set by changing `emergencystretch`
using `\grechangedim` instead of redefining the macro.
- An isolated stropha will now be considered part of the previous neume
group and line breaks will be prevented at that point. In order to
force a line break there, use a breaking space such as `/` before the
stropha in gabc. See
[#1056](https://github.com/gregorio-project/gregorio/issues/1056).
- `interwordspacetext` and it's related distances have been redefined to
be smaller and dependent on a font based distance (`ex`). They are also
no longer scale with the staff size by default. See
[#1036](https://github.com/gregorio-project/gregorio/issues/1036) &
[gregoriot-test#208](https://github.com/gregorio-project/gregorio-test/pull/208).
- `\grecreatedim` and `\grechangedim` can now be used to link two
distances. To do this the second argument should be the name of the
master distance and the third argument should be `inherited`. See
[#962](https://github.com/gregorio-project/gregorio/issues/962).
- The parmesan font is now called granapadano. If you were using
`\gresetgregoriofont{parmesan}`, you should now use
`\gresetgregoriofont{granapadano}`. See
[#1075](https://github.com/gregorio-project/gregorio/issues/1075).
### Removed
- `\grescorereference`
- `\grenewlinepenalty`
- `\grenobreakpenalty`
- `\greendofwordpenalty`
- `\greendofsyllablepenalty`
- `\greendafterbarpenalty`
- `\greendafterbaraltpenalty`
- `\grefinalpenalty`
- `\greendofelementpenalty`
- `\grehyphenpenalty`
- `\grebrokenpenalty`
- `\grewidowpenalty`
- `\greclubpenalty`
- `\grelooseness`
- `\gretolerance`
- `\grepretolerance`
- `\greemergencystretch`
--
✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝
Br. Samuel, OSB
St. Anselm’s Abbey
Washington, DC
(R. Padraic Springuel)
PAX ☧ ΧΡΙΣΤΟΣ
_______________________________________________
Gregorio-users mailing list
[email protected]
https://mail.gna.org/listinfo/gregorio-users
