Just in time (or perhaps just a hair late) for the TeXLive 2017 pretest.
Download here:
https://github.com/gregorio-project/gregorio/releases/tag/v5.0.0
# UPGRADE
### Auto-compilation
The `autocompile` option is now the default option for the behavior of
`\gregorioscore`. If you want to go back to the old, manual behavior,
then you should pass the `nevercompile` option when loading `gregoriotex`.
### Additional fonts
With the addition of more cavum shapes, the number of font options which
come with Gregorio (the package) by default has been reduced in order to
control the download size. From now on only Greciliae (and its "-op"
Dominican variant) will be installed by default. The Gregorio and Grana
Padano fonts, as well as their "-op" Dominican variants, will now be
available as a separate download. If you were using these fonts, either
download `supp_fonts-5_0_0.zip` and install them or switch to Greciliae.
To install the new versions of Gregorio (the font) and Grana Padano,
unzip `supp_fonts-5_0_0.zip`, navigate to the uncompressed folder in
Terminal (or Command Prompt on Windows) and execute `texlua
install_supp_fonts.lua` after you have installed the main Gregorio
distribution. This script will look for the location of Greciliae and
copy the other fonts to that location. If you wish to control the
installation of the fonts manually, the script takes an optional
argument with one of the following values:
* `auto` (optional): the same folder as Greciliae
* `system`: the appropriate font folder in `$TEXMFLOCAL`
* `user`: the appropriate font folder in `$TEXMFHOME`
* `<dir>`: the name of an alternate texmf root directory you want to use
Additionally, if you are building the fonts yourself from a git clone,
`install-gtex.sh` and `install_supp_fonts.lua` will install all the
fonts you have built, not just the ones they are normally distributed with.
**Note:** All the above methods assume you only need to access the fonts
from within a TeX document (and thus are designed to put them into the
correct folder in a texmf tree). If you want to use the fonts in other
programs, then you will need to consult the documentation appropriate to
your platform and/or the program and manually move, copy, or link the
fonts to the necessary location.
### Ledger lines
As of version 5.0, ledger lines are extended through notes on either
side of a ledger line that crosses a stem, as long as the notes are
within the same element.
The algorithm for this is simple so it can be predictable, and it cannot
take into account spacing adjustments made it TeX. This means it may
not produce the exactly desired results. In order to get the results
you want, you can override the automatic behavior in gabc:
- `[oll:1]` will force an over-the-staff ledger line on a note.
- `[oll:0]` will suppress an over-the-staff ledger line on a note.
- `[ull:1]` will force an under-the-staff ledger line on a note.
- `[ull:0]` will suppress an under-the-staff ledger line on a note.
The other `oll` and `ull` forms take precendence over and will interfere
with the above settings, so if you are using them, you may need to
adjust them to get the output you want.
Note: You may need to use a construct such as `/!` to keep notes that
are separated in the same element. For example, `abcV` is two elements
(`ab` and `cV`), so the ledger line on `b` is not extended to `cV`. In
contrast, `ab/!cV` is one element, so the ledger line on `b` is extended
to `cV`.
### End-of-line hyphen protrusion factor
As of version 5.0, the `\gresethyphenprotrusion{percentage}` command is
deprecated. To set this protrusion factor, use
`\gresetprotrusionfactor{eolhyphen}{factor}` instead. Note that the
`factor` taken by the new command is a factor rather than the percentage
taken by the deprecated command, so for example, use
`\gresetprotrusionfactor{eolhyphen}{0.5}` instead of
`\gresethyphenprotrusion{50}`.
### Oriscus orientation at the unison
As of version 5.0, when the note after the oriscus is at the same pitch
as the oriscus, the oriscus will point towards the first non-unison note
after the oriscus or downwards if at the end of the score. Use the `0`
(for downwards) `1` (for upwards) modifiers to force a different
orientation.
### Elisions in vowel centering
As of version 5.0, elisions after a vowel centering prefix will not
cause the center to be placed on the vowel at the end of the prefix.
Since elisions are unvoiced vowels, this makes more sense than the
previous behavior. However, if this change does not produce your
desired output, you may surround the center manually with `{` and `}` in
gabc.
# CHANGELOG
## [5.0.0] - 2017-04-15
### Fixed
- The printing of the commentary box is no longer tied to the printing
of the inital. As a result it is now possible to have a score which has
a commentary but not an initial. See [this thread on the user
list](http://www.mail-archive.com/gregorio-users@gna.org/msg03911.html).
- Elisions after a vowel centering prefix will no longer cause the
center to be placed on the vowel in the prefix. Since prefixes are
unvoiced vowels, this makes more sense than the previous behavior. As
usual, you may use the manual centering features to force the centering
where you want if this does not produce what you want. See
[#1320](https://github.com/gregorio-project/gregorio/issues/1320).
- Dynmanic line spacing when a clef change occurs at the end of a line
is fixed so that the line after the clef change is spaced appropriately.
See [#1285](https://github.com/gregorio-project/gregorio/issues/1285).
- Spaces in the filename of a score no longer cause Gregoriotex to fail.
See [#1224](https://github.com/gregorio-project/gregorio/issues/1224).
- Glyphs for pes quadratum shapes with initio debilis are no longer
missing. Use `-fqg` to engrave them. See
[#1310](https://github.com/gregorio-project/gregorio/issues/1310).
- Horizontal episemata bridge spaces more correctly. As mentioned
earlier, you can prevent this by appending `2` to the `_` on the note
before the space you do not want bridged. See
[#1216](https://github.com/gregorio-project/gregorio/issues/1216).
- A rising note after an oriscus flexus will no longer generate a
porrectus (see
[#1220](https://github.com/gregorio-project/gregorio/issues/1220)).
- The Scribus external tool script now uses latexmk in order to handle
the multi-pass features of Gregorio (see
[#1236](https://github.com/gregorio-project/gregorio/issues/1236)).
- Translation text in a syllable with a trailing (forced) hyphen is no
longer truncated to its first character (see
[#1254](https://github.com/gregorio-project/gregorio/issues/1254)).
- A trailing (forced) hyphen in a syllable no longer generates a forced
hyphen in the previous syllable (see
[#1255](https://github.com/gregorio-project/gregorio/issues/1255)).
- A trailing space on a header line is now ignored (see
[#1269](https://github.com/gregorio-project/gregorio/issues/1269)).
- A pes whose second note is an oriscus now obeys the oriscus
orientation rules (see
[#1272](https://github.com/gregorio-project/gregorio/issues/1272))
### Changed
- The default behaviour of `\gregorioscore` has been changed to autocompile.
- When the note after an oriscus is at the same pitch, the oriscus
direction now depends on the first non-unison, non-oriscus note after
the oriscus (see
[#1179](https://github.com/gregorio-project/gregorio/issues/1179)).
- 6 new St. Gall neume glyphs have been added to the `gregall` font and
glyph for nabc `to!ciG` has been changed (see
[#1303](https://github.com/gregorio-project/gregorio/issues/1303),
[#1305](https://github.com/gregorio-project/gregorio/issues/1305),
[#1313](https://github.com/gregorio-project/gregorio/issues/1313),
[#1314](https://github.com/gregorio-project/gregorio/issues/1314),
[#1315](https://github.com/gregorio-project/gregorio/issues/1315)).
- Notes are now left-aligned as if all clefs had the same width as the
largest clef in the score. You can get previous behavior back with
`\grebolshiftcleftype{current}`, or temporary force alignment until the
end of a score with `\grelocalbolshiftcleftype`. See Documentation of
these functions and
[#1189](https://github.com/gregorio-project/gregorio/issues/1189).
- A clef change immediately before a line break `(z)` will now typeset
the new clef at the beginning of the next line. An explicit custos
`(z0)` immediately before such a clef change (or separated by only a
bar) will be suppressed. See
[#1190](https://github.com/gregorio-project/gregorio/issues/1190).
- Ledger lines are now extended through notes on either side of a ledger
line that crosses a stem, as long as the notes are within the same
"element." If the algorithm doesn't produce the result you want, you
can use `[oll:0]` to suppress an over-the-staff ledger line on a note,
`[ull:0]` to suppress an under-the-staff ledger line on a note,
`[oll:1]` to force an over-the-line ledger line on a note, or [ull:1] to
force an under-the-staff ledger line on a note. Please note that other
forms of `[oll:...]` and `[ull:...]` can interfere with these new
settings. See [UPGRADE.md](UPGRADE.md) and
[#1215](https://github.com/gregorio-project/gregorio/issues/1215) for
details.
- The left stem of Dominican plicae on lines has been shortened (see
[#1238](https://github.com/gregorio-project/gregorio/issues/1238)).
- Clefs on the top or bottom line adjust the spacing as if there were a
note above the top line or below the bottom line, respectively (see
[#1007](https://github.com/gregorio-project/gregorio/issues/1007)).
- Default spaces have been adjusted (see
[#1182](https://github.com/gregorio-project/gregorio/issues/1182)).
- `\grechangenextscorelinedim` can now take a comma-separated list of
line numbers as its first argument (see
[#1280](https://github.com/gregorio-project/gregorio/issues/1280)).
### Added
- More cavum shapes are now available. To use them, simply add `r` in
gabc to any note in a glyph. See
[#844](https://github.com/gregorio-project/gregorio/issues/844).
- Square brackets can be placed around notes by using `[[` and `]]` to
surround said notes in gabc (see
[#844](https://github.com/gregorio-project/gregorio/issues/844)).
- a font `grelaon` for Laon style adiastematic notation has been added
(see GregorioNabcRef.pdf for details). This is a preview, backward
incompatible change are possible in future releases.
- 9 new St. Gall neume glyphs have been added to the `gregall` font.
- 5 new St. Gall neume glyphs have been added to the `gresgmodern` font.
- install-gtex.sh now generates uninstall-gtex.sh, which can be used to
uninstall the TeX portion of the installation when GregorioTeX was
installed from source.
- A `<clear>` tag may be added to a syllable to indicate that its text
should not overlap any previous syllable (see
[#1029](https://github.com/gregorio-project/gregorio/issues/1029)).
- More general support for protrusions. The `<pr>` tag in gabc
indicates where a protrusion should begin. There is an optional
argument `<pr:.5>` that allows the protrusion factor to be specified (in
this example, `.5`). Additionally, the comma, semicolon, colon, and
period are automatically protruded, with configurable protrusion
factors. See GregorioRef and
[#931](https://github.com/gregorio-project/gregorio/issues/931) for more
information.
- `minimalinitialwidth` space, controlling the minimum amount of space
an initial should take require; ignored when `manualinitialwidth` is set
to something non-zero (see
[#1213](https://github.com/gregorio-project/gregorio/issues/1213)).
- new scripts in `contrib/` to check the syllabation of a gabc score
against hyphenation rules, such as those on
[hyphen-la](https://github.com/gregorio-project/hyphen-la)
- the visibility of a particular nabc voice can now be set by
`\gresetnabc{n}{(in)visible}`, where `n` is the number of the nabc voice
(see [#1257](https://github.com/gregorio-project/gregorio/issues/1257)).
- `[nocustos]` may be used in gabc to prevent a custos should the line
end at that point (see
[#1271](https://github.com/gregorio-project/gregorio/issues/1271)).
- Musica ficta signs: Add `r6`, `r7`, and `r8` to a note for a flat,
natural, or sharp (respectively) above the note (see
[#1278](https://github.com/gregorio-project/gregorio/issues/1278)).
- The spacing added for low notes in the staff is now adjustable by
setting dimension `noteadditionalspacelinestext`, with the number of
notes settable as count `noteadditionalspacelinestextthreshold`. See
GregorioRef and
[#1125](https://github.com/gregorio-project/gregorio/issues/1125) for
details.
- Some counts can now be adjusted for a particular line in a score. Use
`\grechangenextscorelinecount` prior to including the score to set the
desired values. The various spacing thresholds may be changed with this
command. See GregorioRef for details.
### Deprecated
- `\gresethyphenprotrusion{percentage}`, supplanted by
`\gresetprotrusionfactor{eolhyphen}{factor}`. Note that the value the
new command takes is a factor rather than a percentage.
### Removed
- `initial-style` gabc header, supplanted by the `\gresetinitiallines`
TeX command.
- `biginitial` style, consolidated into the `initial` style.
- `\grescorereference`
- The Gregorio and Grana Padano fonts are no longer distributed with the
Gregorio distribution archive. They will now be available for download
separately (along with their Dominican "-op" variants) in
`supp_fonts-5_0_0.zip` (the version number will change to match future
releases). See [UPGRADE.md](UPGRADE.md) and
[#844](https://github.com/gregorio-project/gregorio/issues/844) for details.
--
✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝
Br. Samuel, OSB
St. Anselm’s Abbey
Washington, DC
(R. Padraic Springuel)
PAX ☧ ΧΡΙΣΤΟΣ
_______________________________________________
Gregorio-users mailing list
Gregorio-users@gna.org
https://mail.gna.org/listinfo/gregorio-users
