The goal of the 4.1 release is to prepare the version which will be
included in TeXLive 2016. We are thus targeting a March 1st release.
This is the first beta in that process. We strongly encourage you to
take the time out to test this version and report any bugs that you find
so that we can have something as robust as possible for the TeXLive release.
Further, if you have a feature which you'd like to see in 4.1 which is
not present in this beta, please submit the feature request soon. Once
we transition to the release candidates, no more features will be added
to 4.1. While we, the developers, cannot promise that all features
requests submitted prior to the first release candidate will make it
into 4.1, we can guarantee that if we don't know about the requested
feature, it won't even get considered for inclusion.
# UPGRADE:
## 4.1
### Initial handling
Initial handling has been simplified. This deprecates the
`initial-style` gabc header and the `biginitial` style.
Rather than using the `initial-style` gabc header, set the number of
lines the initial should use in Tex with the `\gresetinitiallines`
command. It currently accepts 0 (for no initial), 1 (for a one-line
initial), or 2 (for a two-line initial).
As for the `biginitial` style, the intent is that the `initial` style be
changed within the TeX document whenever the initial style should
change, regardless of how many lines the initial requires. For example,
before including a score that has a two-line initial, you would probably
want to redefine the `initial` style to use a larger font. Then, before
including a score which requires a one-line initial, you would then
redefine the `initial` style back to what it was before.
In order to allow a smoother transition to the new behavior, GregorioTeX
will behave differently depending on whether or not deprecated usage is
allowed (controlled by the `[allowdeprecated]` package option). If
deprecated usage is allowed, GregorioTeX will use the deprecated
`biginitial` style for big initials. If not, GregorioTeX will use the
`initial` style for big initials.
Since the `biginitial` style will disappear with Gregorio 5.0, please
consider disabling deprecated usage (set `[allowdeprecated=false]` when
using the `gregoriotex` package) and use the `initial` style as just
described.
### Spacing between notes
When the next syllable starts with an alteration, the minimal space
between notes of the current syllable and notes of the current syllable
is handled by the new spaces `intersyllablespacenotes@alteration` and
`interwordspacenotes@alteration`. Set them in your custom spacings file
if needed.
### Horizontal episemata on high and low notes
Prior to version 4.1, Gregorio reserved space between notes at the `c`
and `k` heights and their horizontal episemata for a "ledger line" that
might appear between them. However, if the ledger line did not appear,
the episema would appear to be too far from the note.
Starting with version 4.1, Gregorio attempts to reduce the space between
the note and its episema if it doesn't think there is a "ledger line"
there. However, due to the intricacies of distances and measurement in
TeX, Gregorio might guess wrong. In this case, you can override the
guess by using the `[hl:n]` (for a line above the staff) and `[ll:n]`
(for a line below the staff) notations in gabc. If you put a `0` for
`n`, Gregorio will assume there is no ledger line, and if you put a `1`
for `n`, Gregorio will assume there is a ledger line. This notation
will have to be placed after every note which should be thus modified.
Note: Using `[hl:n]` and `[ll:n]` **will not** add a ledger line if it
doesn't exist or remove one if it does. It simply affects whether
Gregorio will act as if one is there or not.
If you prefer the old behavior, you may switch this off by issuing
`\gresetledgerlineheuristic{disable}` in your TeX document. You may
switch it back on with `\gresetledgerlineheuristic{enable}`.
### Custos before EUOUAE blocks
In the past, Gregorio handled the notes of an `<eu>` block like any
other, which meant that a custos would appear before the `<eu>` block if
it happened to start on a new line. However, the '<eu>' block is not a
continuation of the melody, but rather a reminder of the ending to use
for the paired psalm tone. As a result, a custos immediately before an
EUOUAE block is now suppressed by default. If you desire the old
behaviour, use `\greseteolcustosbeforeeuouae{auto}` in your TeX
document. To once again suppress the custos, use
`\greseteolcustosbeforeeuouae{suppressed}`.
### Spacing around bars (divisio) with text underneath
The following spaces have been added:
- `spacearoundsmallbartext` - for the space around virgula and divisio
minima with text underneath
- `spacearoundminortext` - for the space around divisio minor with text
underneath
- `spacearoundmaiortext` - for the space around divisio maior with text
underneath
- `spacearoundfinalistext` - for the space around divisio finalis with
text underneath
- `spacebeforefinalfinalistext` - for the space before a divisio finalis
at the end of a score
By default, these are sized one half millimeter larger than their
"non-text" counterparts. This may cause minor spacing changes in your
existing scores. Adjust them as necessary to get the look you want.
### Oriscus orientation
The oriscus orientation (whether it points up or down) is now dependent
on the note the follows, even if the note is not directly connected to
the oriscus (as it would be in a salicus or a pressus). Appending a `<`
to an unconnected oriscus in gabc will force the oriscus to point
upwards and `>` will force the oriscus to point downwards.
Prior to version 4.1, Gregorio automatically oriented the oriscus when
it was within a neume, but left the orientation up the user otherwise.
If you prefer this behavior, set the `oriscus-orientation` header in
gabc to `legacy`. In legacy mode, the orientation of an unconnected
oriscus will (by default) point downwards and may be reversed by
appending `<` or `>` to the oriscus.
### Mode number
The style for the mode number has been bold and small capitals for a
long time, but the number was rendered as upper-case Roman numerals,
defeating the nuance of small capitals. As of version 4.1, Gregorio
will use lower-case Roman numerals (by default) that will then appear as
small capitals. This will change how the mode number appears above the
initial if you have been using the `mode` header to typeset them. If
you prefer the earlier appearance, use
`\gresetmodenumbersystem{roman-majuscule}` in your TeX file for
upper-case Roman numerals. The other options available are
`roman-minuscule` (the new default), for lower-case Roman numerals, and
`arabic`, for Arabic numerals.
### Score reference macros
If you were using `\scorereference`, `\GreScoreReference`, and/or
`\grescorereference`, stop using them. If you need to capture the
`manuscript-reference` header, use the new header capture feature (see
GregorioRef for details).
# CHANGELOG:
## [4.1.0-beta1] - 2016-01-23
### Fixed
- The alignment of the vertical episema under a punctum inclinatum
deminutus is now correct (see
[#742](https://github.com/gregorio-project/gregorio/issues/742)).
- `<eu>` and `<nlba>` may now be ended on the final divisio
maior/finalis (see
[#743](https://github.com/gregorio-project/gregorio/issues/743)).
- Sign positioning on the first note of quadratum figures is now correct
(see [#752](https://github.com/gregorio-project/gregorio/issues/752)).
- Interlinear spacing of annotations when font size was smaller than
normal. You should now see just the spacing specified by
`annotationseparation`.
- Spacing is now correct and ledger lines are now typeset for flats,
sharps, and naturals above and below the staff (see
[#790](https://github.com/gregorio-project/gregorio/issues/790)).
- Forced hyphens at the end of words are no longer suppressed (see
[#804](https://github.com/gregorio-project/gregorio/issues/804)).
### Changed
- Initial handling has been simplified. The initial style should now be
specified from TeX by using the `\gresetinitiallines` command, rather
than from a gabc header. Big initials and normal initials are now
governed by a single `initial` style, meant to be changed between scores
as appropriate. See [UPGRADE.md](UPGRADE.md) and GregorioRef for
details (for the change request, see
[#632](https://github.com/gregorio-project/gregorio/issues/632)).
Deprecations for this change are listed in the Deprecation section, below.
- `\gresethyphen` no longer manipulates `maximumspacewithoutdash`,
allowing for restoration of consistent behavior after this distance has
been modified. See
[#705](https://github.com/gregorio-project/gregorio/issues/705).
- The oriscus-based shapes in the greciliae font are more consistent.
The shape of a scandicus with a second ambitus of two is more consistent
across all score fonts.
- Minimal space between notes of different syllables (or words) has been
reduced when the second syllable starts with an alteration.
- The space between note and horizontal episema has been tightened for
notes at the `c` or `k` height when there is no ledger line. Due to the
intricacies of measurement, the system tries to make a best guess as to
the existence of the ledger line. If the guess is wrong, you may use
the `[hl:n]` and `[ll:n]` notations in gabc to override the guess. See
[UPGRADE.md](UPGRADE.md) for details (for the change request, see
[#716](https://github.com/gregorio-project/gregorio/issues/716)).
- The custos that might appear immediately before a `<eu>` block is now
suppressed by default. This behavior is controlled by the
`\greseteolcustosbeforeeuouae` command. See GregorioRef and
[UPGRADE.md](UPGRADE.md) for details (for the change request, see
[#761](https://github.com/gregorio-project/gregorio/issues/761)).
- Different glyphs will now be used for the liquescent stropha on a line
or between lines, if supported by the font. If you prefer the old
behavior, use `\grechangeglyph{StrophaAuctaLongtail}{*}{StrophaAucta}`
in your TeX file. See
[#773](https://github.com/gregorio-project/gregorio/issues/773).
- Made the oriscus orientation dependent on the note that follows.
Using `<` will force the ascending oriscus and `>` will force the
descending oriscus. The old behavior may be restored by setting the
`oriscus-orientation` gabc header to `legacy`. See UPGRADE.md for
details (for the change request, see
[#774](https://github.com/gregorio-project/gregorio/issues/774)).
- Headers not recognized by gregorio, rather than inducing an error, are
now simply accepted by gregorio. Most of the old "standard" headers,
like `book` and `manuscript-location`, are now handled in this way and
thus are no longer limited to one instance. See GregorioRef for details.
- `mode` will now be converted to Roman numerals in lower case so that
it shows up as small capitals using the default `modeline` style. See
[UPGRADE.md](UPGRADE.md) for details (for the change request, see
[#756](https://github.com/gregorio-project/gregorio/issues/756)).
- `\grecommentary` is now less restrictive about where it occurs and
need not occur directly before the score anymore.
- When a bar is preceeded by a punctum mora, gregorio now ignores the
punctum mora in the bar horizontal placement by default, and also adds a
custom space (defaulting to 0). You can change this behavior with
`\gresetbarshiftaftermora{}`, see GregorioRef for its arguments (for the
change request, see
[#795](https://github.com/gregorio-project/gregorio/issues/795)).
### Added
- Support for two-, three-, and five-line staves. Set the `staff-lines`
header to `2`, `3`, or `5`. For all values of `staff-lines`, the note
below the staff remains 'c'. The two new notes above the staff (for a
five-line staff) are `n` and `p`. See
[#429](https://github.com/gregorio-project/gregorio/issues/429).
- Salicus flexus glyphs (see
[#631](https://github.com/gregorio-project/gregorio/issues/631)).
- Neume fusion, activated in gabc by `@`. Use `@` before a clivis or a
porrectus to get an unstemmed figure. Use `@` between two notes to fuse
them explicitly. Enclose a set of notes within `@[` and `]` to
automatically guess their fusion. See GregorioRef for details (for the
channge requests, see
[#679](https://github.com/gregorio-project/gregorio/issues/679),
[#687](https://github.com/gregorio-project/gregorio/issues/687), and
[#692](https://github.com/gregorio-project/gregorio/issues/692)).
- Hollow version of the oriscus, called by adding the `r` modifier to an
oriscus, as in `gor` or `gor<` (See
[#724](https://github.com/gregorio-project/gregorio/issues/724)).
- Headers are now passed to TeX and may be captured in TeX by using the
`\gresetheadercapture` command. See GregorioRef for details.
- Support for half-spaces and ad-hoc spaces. Use `/0` in gabc for a
half-space between notes. Use `/[factor]` (substituting a positive or
negative real number for the scale factor) for an ad-hoc space whose
length is `interelementspace` scaled by the desired factor. See
[#736](https://github.com/gregorio-project/gregorio/issues/736).
- Support for custom length ledger lines. See GregorioRef for details
(for the change request, see
[#598](https://github.com/gregorio-project/gregorio/issues/598)).
- Support for a secondary clef. Use `@` to join two clefs together, as
in `c1@c4`. The first clef is considered the primary one and will be
used when computing an automatic custos before a clef change. See
[#755](https://github.com/gregorio-project/gregorio/issues/755).
- New headers for typesetting text after `mode` above the initial:
`mode` will be typeset first, using the `modeline` style, then
`mode-modifier`, using the `modemodifier` style, then
`mode-differentia`, using the `modedifferentia` style. See GregorioRef
for details (for the change request, see
[#756](https://github.com/gregorio-project/gregorio/issues/756)).
- Automatic line breaks before a `<eu>` block may be made ragged by
using `\gresetbreakbeforeeuouae{ragged}`. See GregorioRef for details
(for the change request, see
[#764](https://github.com/gregorio-project/gregorio/issues/764)).
- Tunable spaces for bars with text underneath:
`spacearoundsmallbartext`, `spacearoundminortext`,
`spacearoundmaiortext`, `spacearoundfinalistext`,
`spacebeforefinalfinalistext`. These are sized slightly larger than
their "non-text" counterparts. See GregorioRef and
[UPGRADE.md](UPGRADE.md) for details (for the change request, see
[#766](https://github.com/gregorio-project/gregorio/issues/766)).
- The ability to typeset simple slurs. See GregorioRef for details (for
the change request, see
[#776](https://github.com/gregorio-project/gregorio/issues/776)).
- More control over the alignment of the annotation. You can now set
either the first line or the last line of the annotation as the
controling line with `\gresetannotationby{firstline}` and
`\gresetannotationby{lastline}` respectively. Additionaly, within the
line you can specify the top, baseline, or bottom of the line as the
alignment point with `\gresetannotationvalign{top}`,
`\gresetannotation{baseline}`, and `\gresetannotationvalgin{bottom}`
respectively. Default behavior is baseline of the top line (as it was
before). These alignment controls are applied before `annotationraise`
is taken into account. See
[#768](https://github.com/gregorio-project/gregorio/issues/768) for details.
- More control over the placement of the commentary. You can now set
the amount of space between the lines of a multi-line commentary with
`commentaryseparation` and the distance from the top line of the staff
to the baseline of the bottom line of the commentary with
`commentaryraise`. See
[#662](https://github.com/gregorio-project/gregorio/issues/662) for
original request.
- Styles for the annotation and the commentary. `annotation` has no
default styling. `commentary` defaults to footnote sized italics.
- `\grecommentary` now takes an optional argument which will add extra
space between the commentary and the score for just the next score.
- The custos can now be selectively enabled/disabled at forced line
breaks by appending `+` (to enable) or `-` (to disable) after the `z` or
`Z` (see [#800](https://github.com/gregorio-project/gregorio/issues/800)).
- With thanks to an anonymous contributor, the shape of the
MetaPost-drawn curly brace has been improved (see
[#797](https://github.com/gregorio-project/gregorio/issues/797)).
### Deprecated
- `initial-style` gabc header, supplanted by the `\gresetinitiallines`
TeX command.
- `biginitial` style, consolidated into the `initial` style.
- `\grescorereference`
### Removed
- `\GreSetStaffLinesFormat`, supplanted by
`\grechangeformat{normalstafflines}...`
- `\greinitialformat`, if you were redefining this command, use
`\grechangeformat{initial}...` instead
- `\grebiginitialformat`, if you were redefining this command, use
`\grechangeformat{biginitial}...` instead
- `\gretranslationformat`, if you were redefining this command, use
`\grechangeformat{translation}...` instead
- `\greabovelinestextstyle`, if you were redefining this command, use
`\grechangeformat{abovelinestext}...` instead
- `\grelowchoralsignstyle`, if you were redefining this command, use
`\grechangeformat{lowchoralsign}...` instead
- `\grehighchoralsignstyle`, if you were redefining this command, use
`\grechangeformat{highchoralsign}...` instead
- `\setaboveinitialseparation`, supplanted by
`\grechangedim{annotationseparation}...`
- `\scorereference`
- `\GreScoreReference`
- `\commentary`, supplanted by `\grecommentary`
- `\setgretranslationcenteringscheme`, supplanted by
`\gresettranslationcentering`
- `\englishcentering`, supplanted by `\gresetlyriccentering{syllable}`
- `\defaultcentering`, supplanted by `\gresetlyriccentering{vowel}`
- `\setgrefactor`, supplanted by `\grechangestaffsize`
- `\forcecompilegabc`, supplanted by `\gresetcompilegabc{force}`
- `\autocompilegabc`, supplanted by `\gresetcompilegabc{auto}`
- `\nevercompilegabc`, supplanted by `\gresetcompilegabc{never}`
- `\includescore`, supplanted by `\gregorioscore`
- `\grenoscaledim`, supplanted by `\grescaledim{...}{no}`
- `\gresetdim`, supplanted by `\grecreatedim`
- `\setstafflinethickness`, supplanted by `\grechangestafflinethickness`
- `\grecoloredlines`, supplanted by `\gresetlinecolor`
- `\greredlines` and `\redlines`, supplanted by
`\gresetlinecolor{gregoriocolor}`
- `\grenormallines` and `\normallines`, supplanted by
`\gresetlinecolor{black}`
- `\greremovelines`, supplanted by `\gresetlines{invisible}`
- `\gredonotremovelines`, supplanted by `\gresetlines{visible}`
- `\GreHidePCLines`, supplanted by
`\gresetlinesbehindpunctumcavum{invisible}`
- `\GreDontHidePCLines`, supplanted by
`\gresetlinesbehindpunctumcavum{visible}`
- `\GreHideAltLines`, supplanted by
`\gresetlinesbehindalteration{invisible}`
- `\GreDontHideAltLines`, supplanted by
`\gresetlinesbehindalteration{visible}`
- `\gresetnlbintranslation`, supplanted by `\gresetbreakintranslation`
- `\greblockcustos`, supplanted by `\greseteolcustos{manual}`
- `\greenableeolshifts`, supplanted by `\greseteolshifts{enable}`
- `\gredisableeolshifts`, supplanted by `\greseteolshifts{disable}`
- `\GreUseNoramalHyphen`, supplanted by `\greseteolhyphen{normal}`
- `\GreUseZeroHyphen`, supplanted by `\greseteolhyphen{zero}`
- `\greremoveclef`, supplanted by `\gresetclef{invisible}`
- `\grenormalclef`, supplanted by `\gresetclef{visible}`
- `\AddHEpisemusBridges`, supplanted by `\gresethepisema{bridge}`
- `\RemoveHEpisemusBridges`, supplanted by `\gresethepisema{break}`
- `\UseAlternatePunctumCavum`, supplanted by
`\gresetpunctumcavum{alternate}`
- `\UseNormalPunctumCavum`, supplanted by `\gresetpunctumcavum{normal}`
- `\clivisalignmentalways`, supplanted by `\gresetclivisalignment{always}`
- `\clivisalignmentnever`, supplanted by `\gresetclivisalignment{never}`
- `\clivisalignmentspecial`, supplanted by `\gresetclivisalignment{special}`
- `\greusedefaultstyle`, supplanted by `\gresetglyphsytle{default}`
- `\greusemedicaeastyle`, supplanted by `\gresetglyphsytle{medicaea}`
- `\greusehufnagelstyle`, supplanted by `\gresetglyphsytle{hufnagel}`
- `\greusemensuralstyle`, supplanted by `\gresetglyphsytle{mensural}`
- `\setspaceafterinitial`, supplanted by
`\grechangedim{afterinitialshift}...`
- `\setspacebeforeinitial`, supplanted by
`\grechangedim{beforeinitialshift}...`
- `\setinitialspacing`, supplanted by
`\grechangedim{beforeinitialshift}...`,
`\grechangedim{manualinitialwidth}...`, and
`\grechangedime{afterinitialshift}...`
- `centering-scheme` gabc header, supplanted by `\grelyriccentering` in
TeX. See GregorioRef for syntax.
- `gregoriotex-font` gabc header, supplanted by `\gresetgregoriofont` in
TeX. See GregorioRef for syntax.
- The meaningless `gabc-version` header in gabc (see
[#664](https://github.com/gregorio-project/gregorio/issues/664)).
--
✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝
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
