summaryrefslogtreecommitdiff
path: root/Build/source/texk/gregorio/gregorio-src/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/texk/gregorio/gregorio-src/doc')
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/Command_Index_User.tex111
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/Command_Index_gregorio.tex18
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/Command_Index_internal.tex22
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/Gabc.tex104
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/GregorioNabcRef-4_1_0-rc1.pdf (renamed from Build/source/texk/gregorio/gregorio-src/doc/GregorioNabcRef-4_1_0-beta3.pdf)bin279412 -> 279417 bytes
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/GregorioRef-4_1_0-beta3.pdfbin625731 -> 0 bytes
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/GregorioRef-4_1_0-rc1.pdfbin0 -> 636550 bytes
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/GregorioRef.tex4
-rw-r--r--Build/source/texk/gregorio/gregorio-src/doc/Makefile.am8
9 files changed, 227 insertions, 40 deletions
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_User.tex b/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_User.tex
index 2a08b030f62..c8f9983dce0 100644
--- a/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_User.tex
+++ b/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_User.tex
@@ -926,10 +926,10 @@ Macro to change the behaviour for separation between notes of two syllables when
& \texttt{never} & punctum mora are never ignored\\
\end{argtable}
-When a punctum mora is ignored, the bar will also be shifted by \texttt{barmoraadjustment} (zero by default), see its description in the \textbf{Distances} section.
+When a punctum mora is ignored, the bar will also be shifted by \texttt{moraadjustmentbar} (zero by default), see its description in the \nameref{distances} section.
\macroname{\textbackslash gresetbarspacing}{\{\#1\}}{gregoriotex-syllable.tex}
-Macro to activate the new bar spacing algorithm. The new algorithm attempts to place the bar line exactly midway between its surrounding notes. Any text associated with the bar is placed midway between its surrounding text. Since this might result in the bar line and the text being widely separated, there is also a limit to the distance between their centers: \texttt{maxbaroffset}.
+Macro to activate the new bar spacing algorithm. The new algorithm attempts to place the bar line exactly midway between its surrounding notes. Any text associated with the bar is placed midway between its surrounding text. Since this might result in the bar line and the text being widely separated, there are also a limits to the distance between their respective centers: \texttt{maxbaroffsettextleft} and \texttt{maxbaroffsettextright} (when text center is respectively on the left or on the right of bar center).
\begin{argtable}
\#1 & \texttt{new} & Activates the new spacing algorithm\\
@@ -1021,11 +1021,11 @@ a different value be desired.
\subsubsection{Headers}
\macroname{\textbackslash gresetheadercapture}{\{\#1\}\{\#2\}\{\#3\}}{gregoriotex-main.tex}
-Macro to tell Gregorio\TeX{} to capture a given header by calling a specified
-macro. Passing an empty \#2 will cancel capture of the given header.
+Macro to tell Gregorio\TeX{} to capture a given header of the gabc file, passing it to a
+specified \TeX{} macro. Passing an empty \#2 will cancel capture of the given header.
\begin{argtable}
- \#1 & string & The name of the header\\
+ \#1 & string & The name of the gabc header\\
\#2 & string & The name of the macro to use (without the leading backslash)
or empty to stop capturing the given header\\
\#3 & string & a comma-separated list of options\\
@@ -1038,15 +1038,15 @@ The options are:
\texttt{string} & The header value should be passed to the macro as a string\\
\end{tabular}
-If the \texttt{name} option is not supplied, the macro supplied must take one
+If the \texttt{name} option is not supplied, the macro is called with one
argument: the value of the header.
-If the \texttt{name} option is supplied, the macro supplied must take two
+If the \texttt{name} option is supplied, the macro is called with two
arguments: the name and the value of the header (in that order).
-If the \texttt{string} option is supplied, the value will be passed with all
-non-space characters as \TeX{} catcode 12 (and all spaces as catcode 10).
-If not, the value will be evaluated as \TeX{}.
+If the \texttt{string} option is supplied, the value will be passed with
+catcode 12 associated with all non-space characters (and catcode 10 for all spaces).
+If not, the value will be evaluated as regular \TeX{} input.
Other than the headers that define macros, which are not passed to \TeX{},
the headers will be processed in the order they were presented in the gabc
@@ -1055,12 +1055,16 @@ file. Headers will be processed in the \TeX{} state at the point of the
capturing macro produce something, it will be typeset within the same
paragraph as the \verb=\gregorioscore= call.
-Gregorio will call whatever is passed to \verb=\grebeforeheaders= before
-processing a given set of headers and to \verb=\greafterheaders= after
-processing them.
+As an example, you can use
+
+\verb=\gresetheadercapture{commentary}{grecommentary}{string}=
+
+\noindent to capture the
+\texttt{commentary} header of gabc files and feed it to \verb=\grecommentary=,
+thus automatically printing the content of the header above the score.
\macroname{\textbackslash grebeforeheaders}{\{\#1\}}{gregoriotex-main.tex}
-Specifies something to be done before a set of headers is processed.
+Specifies \TeX{} code processed before the processing of the headers of a score.
Defaults to nothing. If this is called multiple times, the most recent call
will define the behavior at the next set of headers.
@@ -1069,7 +1073,7 @@ will define the behavior at the next set of headers.
\end{argtable}
\macroname{\textbackslash greafterheaders}{\{\#1\}}{gregoriotex-main.tex}
-Specifies something to be done after a set of headers is processed.
+Specifies \TeX{} code processed after the processing of the headers of a score.
Defaults to nothing. If this is called multiple times, the most recent call
will define the behavior at the next set of headers.
@@ -1079,7 +1083,7 @@ will define the behavior at the next set of headers.
\subsubsection{Ancient Notation}
-For a full description of how to make use of the ancient notation capabilities of gregorio and Gregorio\TeX, look at the GregorioNabcRef documentation. The commands listed here allow the manipulation of settings related to that notation.
+For a full description of how to make use of the ancient notation capabilities of Gregorio and Gregorio\TeX, look at the GregorioNabcRef documentation. The commands listed here allow the manipulation of settings related to that notation.
\macroname{\textbackslash gresetnabcfont}{\{\#1\}\{\#2\}}{gregoriotex-nabc.tex}
Macro to set the font to be used for the ancient notation.
@@ -1176,6 +1180,11 @@ Space after a clef at the beginning of a line.
Minimum space between notes of different syllables.
\end{gdimension}
+\begin{gdimension}{intersyllablespacestretchhyphen}
+Stretching added in the case where the text of two syllables of the same word are
+separated with an automatic hyphen.
+\end{gdimension}
+
\begin{gdimension}{interwordspacenotes}
Minimum space between notes of syllables from different words.
\end{gdimension}
@@ -1184,6 +1193,10 @@ Minimum space between notes of syllables from different words.
Minimum space between texts of different words. Please keep the same \texttt{plus} and \texttt{minus} as \texttt{interwordspacenotes}.
\end{gdimension}
+\begin{gdimension}{interwordspacetext@bars}
+Minimum space between texts of different words when one of the syllable contains only a bar.
+\end{gdimension}
+
\begin{gdimension}{interwordspacenotes@alteration}
Same as \texttt{interwordspacenotes} for the case where the second syllable starts with an alteration.
\end{gdimension}
@@ -1200,6 +1213,10 @@ Same as \texttt{interwordspacenotes} for \texttt{euouae} blocks.
Same as \texttt{interwordspacetext} for \texttt{euouae} blocks.
\end{gdimension}
+\begin{gdimension}{interwordspacetext@bars@euouae}
+Same as \texttt{interwordspacetext@bars} for \texttt{euouae} blocks.
+\end{gdimension}
+
\begin{gdimension}{bitrivirspace}
Space between notes of a bivirga or trivirga.
\end{gdimension}
@@ -1329,7 +1346,7 @@ Additional space that will appear around bars that are preceded by a custos and
\end{gdimension}
\begin{gdimension}{textbartextspace}
-Space between the text and the text of the bar.
+Space between the text of previous syllable and the text associated with the bar (old bar spacing algorithm only).
\end{gdimension}
\begin{gdimension}{notebarspace}
@@ -1467,8 +1484,64 @@ Distance an over-the-notes slur will be raised above the baseline of a note at t
Distance an under-the-notes slur will be raised above the baseline of a note at the same height.
\end{gdimension}
-\begin{gdimension}{maxbaroffset}
-When the new bar spacing algorithm is active, this is the maximum distance by which a bar and its associated text can be separated.
+\begin{gdimension}{maxbaroffsettextleft}
+Maximum distance by which the center of a bar and the center of its associated text can be separated, when the center of the text goes left of the center of the bar (new bar spacing algorithm only).
+\end{gdimension}
+
+\begin{gdimension}{maxbaroffsettextright}
+Same as \texttt{maxbaroffsettextleft} but when the center of the text goes right of the center of the bar.
+\end{gdimension}
+
+\begin{gdimension}{overhepisemalowshift}
+Distance to place a a horizontal episema over a note in a low position in the space.
+\end{gdimension}
+
+\begin{gdimension}{overhepisemahighshift}
+Distance to place a horizontal episema over a note in a high position in the space.
+\end{gdimension}
+
+\begin{gdimension}{underhepisemalowshift}
+Distance to place a horizontal episema under a note in a low position in the space.
+\end{gdimension}
+
+\begin{gdimension}{underhepisemahighshift}
+Distance to place a horizontal episema under a note in a high position in the space.
+\end{gdimension}
+
+\begin{gdimension}{hepisemamiddleshift}
+Distance to place a horizontal episema in the middle of a space.
+\end{gdimension}
+
+\begin{gdimension}{vepisemalowshift}
+Distance to place a vertical episema in a low position in the space.
+\end{gdimension}
+
+\begin{gdimension}{vepisemahighshift}
+Distance to place a vertical episema in a high position in the space.
+\end{gdimension}
+
+\begin{gdimension}{linepunctummorashift}
+Vertical distance to place a punctum mora for a note on a line.
+\end{gdimension}
+
+\begin{gdimension}{spacepunctummorashift}
+Vertical distance to place a punctum mora for a note in a space.
+\end{gdimension}
+
+\begin{gdimension}{spaceamonepespunctummorashift}
+Vertical distance to place a punctum mora for the second note (in a space) of a pes with ambitus one.
+\end{gdimension}
+
+\begin{gdimension}{lineporrectuspunctummorashift}
+Vertical distance to place a punctum mora for the second note in a porrectus (or similar figure), on a line
+\end{gdimension}
+
+\begin{gdimension}{spaceporrectuspunctummorashift}
+Vertical distance to place a punctum mora for the second note in a porrectus (or similar figure), in a space
+\end{gdimension}
+
+\begin{gdimension}{raresignshift}
+Distance to place a ``rare'' sign above the top space in a score.
\end{gdimension}
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_gregorio.tex b/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_gregorio.tex
index 9798b70d8f5..97da3bf208e 100644
--- a/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_gregorio.tex
+++ b/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_gregorio.tex
@@ -454,7 +454,7 @@ Macro used to pass headers to TeX.
\#2 & string & The header value.\\
\end{argtable}
-\macroname{\textbackslash GreHEpisema}{\#1\#2\#3\#4\#5\#6\#7}{gregoriotex-signs.tex}
+\macroname{\textbackslash GreHEpisema}{\#1\#2\#3\#4\#5\#6\#7\#8\#9}{gregoriotex-signs.tex}
Macro to typeset an horizontal episema.
\begin{argtable}
@@ -473,9 +473,16 @@ Macro to typeset an horizontal episema.
& \texttt{r} & a small episema aligned right\\
\#6 & integer & Replacement for \#1 if a bridge causes a height substitution.\\
\#7 & \TeX\ code & code that sets heuristics\\
+ \#8 & string & a positive or negative "nudge" (dimension) for the vertical position of the horizontal episema\\
+ \#9 & \texttt{0} & for horizontal episema cases, use automatic positioning within the space\\
+ & \texttt{1} & for horizontal episema cases, position in the middle of the space\\
+ & \texttt{2} & for horizontal episema cases, position low within the space as if the episema is over the note\\
+ & \texttt{3} & for horizontal episema cases, position high within the space as if the episema is under the note\\
+ & \texttt{4} & for horizontal episema cases, position low within the space as if the episema is over the note\\
+ & \texttt{5} & for horizontal episema cases, position high within the space as if the episema is under the note\\
\end{argtable}
-\macroname{\textbackslash GreHEpisemaBridge}{\#1\#2\#3\#4}{gregoriotex-signs.tex}
+\macroname{\textbackslash GreHEpisemaBridge}{\#1\#2\#3\#4\#5\#6}{gregoriotex-signs.tex}
Macro to typeset a bridge episema for the last note of a glyph
(element, syllable) if the next episema is at the same height.
@@ -496,6 +503,13 @@ Macro to typeset a bridge episema for the last note of a glyph
& \texttt{10} & Space between puncta inclinata (also debilis for now), larger ambitus (range=3rd).\\
& \texttt{11} & Space between puncta inclinata (also debilis for now), larger ambitus (range=4th or more).\\
\#4 & \TeX\ code & code that sets heuristics\\
+ \#5 & string & a positive or negative "nudge" (dimension) for the vertical position of the horizontal episema\\
+ \#6 & \texttt{0} & for horizontal episema cases, use automatic positioning within the space\\
+ & \texttt{1} & for horizontal episema cases, position in the middle of the space\\
+ & \texttt{2} & for horizontal episema cases, position low within the space as if the episema is over the note\\
+ & \texttt{3} & for horizontal episema cases, position high within the space as if the episema is under the note\\
+ & \texttt{4} & for horizontal episema cases, position low within the space as if the episema is over the note\\
+ & \texttt{5} & for horizontal episema cases, position high within the space as if the episema is under the note\\
\end{argtable}
\macroname{\textbackslash GreHighChoralSign}{\#1\#2\#3}{gregoriotex-signs.tex}
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_internal.tex b/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_internal.tex
index cb2f6b1470d..8577c6c1975 100644
--- a/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_internal.tex
+++ b/Build/source/texk/gregorio/gregorio-src/doc/Command_Index_internal.tex
@@ -116,7 +116,7 @@ Calculates the baseline correction for the glyphs. Dependent on \texttt{gre@fac
\macroname{\textbackslash gre@computespaces}{}{gregoriotex-spaces.tex}
Aggregates all of the global distance calculations and calls them in the order needed to respect dependencies.
-\macroname{\textbackslash gre@calculate@glyphraisevalue}{\#1\#2}{gregoriotex-spaces.tex}
+\macroname{\textbackslash gre@calculate@glyphraisevalue}{\#1\#2\#3}{gregoriotex-spaces.tex}
Calculates the raise value for a glyph (glyphraisevalue) based on where it is to be placed and what kind of a glyph it is. This is a time of use calculation.
\begin{argtable}
@@ -137,6 +137,12 @@ Calculates the raise value for a glyph (glyphraisevalue) based on where it is to
& \texttt{14} & case of the punctum mora in a space with a note on the line below it\\
& \texttt{15} & case of the over-the-notes slur\\
& \texttt{16} & case of the under-the-notes slur\\
+ \#3 & \texttt{0} & for horizontal episema cases, use automatic positioning within the space\\
+ & \texttt{1} & for horizontal episema cases, position in the middle of the space\\
+ & \texttt{2} & for horizontal episema cases, position low within the space as if the episema is over the note\\
+ & \texttt{3} & for horizontal episema cases, position high within the space as if the episema is under the note\\
+ & \texttt{4} & for horizontal episema cases, position low within the space as if the episema is over the note\\
+ & \texttt{5} & for horizontal episema cases, position high within the space as if the episema is under the note\\
\end{argtable}
\macroname{\textbackslash gre@stafflinefactor}{}{gregoriotex-spaces.tex}
@@ -603,7 +609,7 @@ Macro for aligning clivis syllables according to the flag \verb=\gre@clivisalign
& \texttt{1} & this is for the next syllable\\
\end{argtable}
-\macroname{\textbackslash gre@hepisorline}{\#1\#2\#3\#4\#5}{gregoriotex-signs.tex}
+\macroname{\textbackslash gre@hepisorline}{\#1\#2\#3\#4\#5\#6\#7}{gregoriotex-signs.tex}
Macro to typeset a horizontal line (either an additional staff line or an episema).
\begin{argtable}
@@ -622,6 +628,13 @@ Macro to typeset a horizontal line (either an additional staff line or an episem
& \texttt{l} & a small episema aligned left\\
& \texttt{c} & a small episema aligned center\\
& \texttt{r} & for a small episema aligned right\\
+ \#6 & string & a positive or negative "nudge" (dimension) for the vertical position of the horizontal episema\\
+ \#7 & \texttt{0} & for horizontal episema cases, use automatic positioning within the space\\
+ & \texttt{1} & for horizontal episema cases, position in the middle of the space\\
+ & \texttt{2} & for horizontal episema cases, position low within the space as if the episema is over the note\\
+ & \texttt{3} & for horizontal episema cases, position high within the space as if the episema is under the note\\
+ & \texttt{4} & for horizontal episema cases, position low within the space as if the episema is over the note\\
+ & \texttt{5} & for horizontal episema cases, position high within the space as if the episema is under the note\\
\end{argtable}
\macroname{\textbackslash gre@hepisorlineaux}{\#1\#2\#3\#4}{gregoriotex-signs.tex}
@@ -1843,8 +1856,9 @@ rather than have multiple definitions.
\texttt{8} & flexus with an ambitus of one\\
\texttt{9} & flexus deminutus\\
\texttt{10} & virgula\\
- \texttt{11} & divisio minima, minor and maior\\
- \texttt{12} & divisio finalis
+ \texttt{11} & divisio minima, minor, maior or dominican bar\\
+ \texttt{12} & divisio finalis\\
+ \texttt{13} & no note
\end{tabulary}
\subsection{Episema Special}\label{EpisemaSpecial}
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/Gabc.tex b/Build/source/texk/gregorio/gregorio-src/doc/Gabc.tex
index b770c35b457..27ef298188b 100644
--- a/Build/source/texk/gregorio/gregorio-src/doc/Gabc.tex
+++ b/Build/source/texk/gregorio/gregorio-src/doc/Gabc.tex
@@ -220,9 +220,8 @@ line (\textit{d}). Most of the time they will take a short form:
But when a ledger line is drawn below these notes, they should take a long
form. The problem is that many cases are ambiguous: for instance if a note
is close to a ledger line, one may want to make it long, others may not.
-To solve this problem, you can add \texttt{[ll:0]} to any note of a glyph to
-force the stem of the glyph to get its short form, or \texttt{[ll:1]} to force
-its long form.
+To solve this problem, you can add \texttt{[ll:0]} to the note carrying the stem
+to get its short form, or \texttt{[ll:1]} to force its long form.
% This snippet makes LuaTeX segfault!
%\gabcsnippet{
@@ -283,22 +282,107 @@ the same meaning as before, but applies to both ends of the slur.
Use \texttt{uslur} instead of \texttt{oslur} (with either form) to create an
under-the-staff slur.
+\subsection{Horizontal episema placement for very high and low notes}
+
+Gregorio places horizontal episema under c and above k (or the not above upper line when
+staff does not have exactly 4 lines) closer to the notes when no ledger line is present.
+The heuristics used by Gregorio are not perfect so it may be necessary to make
+the presence or absence of ledger line explicit for horizontal episema placement.
+This is done in the exact same way as for stem length: place \texttt{[ll:0]} or
+\texttt{[ll:1]} on the note carrying the episema, to force gregorio to consider the
+absence or presence of a ledger line in episema placement.
+
+\subsection{Horizontal Episema Tuning}
+
+The horizontal episema position within the space can be adjusted should the
+defaults not be satisfactory.
+
+There are five tunable dimensions:
+
+\begin{tabularx}{\textwidth}{l|X}
+ Dimension & Description \\
+ \hline
+ \texttt{overhepisemalowshift} & The shift for positioning a horizontal episema that is over a note in a low position in the space\\
+ \texttt{overhepisemahighhift} & The shift for positioning a horizontal episema that is over a note in a high position in the space\\
+ \texttt{underhepisemalowshift} & The shift for positioning a horizontal episema that is under a note in a low position in the space\\
+ \texttt{underhepisemahighhift} & The shift for positioning a horizontal episema that is under a note in a high position in the space\\
+ \texttt{hepisemamiddleshift} & The shift for centering the horizontal episema in the middle of a space\\
+\end{tabularx}
+
+In addition, gabc allows you to adjust the positioning of a given episema by
+appending \texttt{[oh:\textit{p}]} (for the episema over the note) or
+\texttt{[uh:\textit{p}]} (for the episema under the note). Here,
+\texttt{\textit{p}} is an optional position specifier followed by an optional
+nudge. However at least one or the other must be specified.
+
+The position specifier allows you to select which of the five tunable
+dimensions will be used for the base position:
+
+\begin{tabularx}{\textwidth}{l|X}
+ Specifier & Base shift \\
+ \hline
+ \textit{omitted} & Use the default shift based on the position of the episema relative to the note\\
+ \texttt{m} & Use \texttt{hepisemamiddleshift}.\\
+ \texttt{l} & Use \texttt{overhepisemalowshift} or \texttt{underhepisemalowshift} depending on whether the episema is over or under the note.\\
+ \texttt{h} & Use \texttt{overhepisemahighshift} or \texttt{underhepisemahighshift} depending on whether the episema is over or under the note.\\
+ \texttt{ol} & Use \texttt{overhepisemalowshift}.\\
+ \texttt{oh} & Use \texttt{overhepisemahighshift}.\\
+ \texttt{ul} & Use \texttt{underhepisemalowshift}.\\
+ \texttt{uh} & Use \texttt{underhepisemahighshift}.\\
+\end{tabularx}
+
+The nudge is a \TeX{} dimension specification (number and units) that starts
+with \texttt{+} for a nudge upwards or \texttt{-} for a nudge downwards from
+base position selected by the position speciifer. If omitted, the episema will
+be drawn at the base position.
+
+In addition, gabc also allows you to specify that a block of notes---possibly
+separated with spaces and in different syllables--should be considered a single
+unit when it comes to positioning the horizontal episema. To do this, put
+\texttt{[oh:\textit{p}\{]} (for the episema over the note) or
+\texttt{[uh:\textit{p}\{]} (for the episema under the note) before the first
+note of the block and the corresponding \texttt{[oh\}]} or \texttt{[uh\}]}
+after the last note of the block. When using this syntax, \texttt{\textit{p}}
+is the position specifier as before, but is entirely optional, and when
+completely omitted, allows the \texttt{:} to also be omitted.
+
\subsection{Lyric Centering}
Gregorio centers the text of each syllable around the first note of each
-syllable. There are three basic modes: \verb:syllable:, \verb:vowel:, and \verb:firstletter:, which are selected with the command \verb=\gresetlyriccentering{<mode>}=. In \texttt{syllable} mode, the
-entire syllable is centered around the first note. This is common in
-modern music. In \texttt{vowel} mode, the vowel sound of the syllable is
-centered around the first note. This is common in most Gregorian chant
-books with text in Latin. In \texttt{firstletter} mode, the first letter of the syllable is centered around the first note. While not a common choice, this was explicitly requested by a user and we try to be responsive to our user base.
+syllable. There are three basic modes, selected with the command \verb=\gresetlyriccentering{<mode>}=:
+
+\begin{description}
+\item[syllable] the entire syllable is centered around the first note
+\item[firstletter] the first letter of the syllable is centered around the first note
+\item[vowel] the vowel sound of the syllable is centered around the first note
+\end{description}
+
+The default is \texttt{vowel}, being common in most Gregorian chant
+books with text in Latin.
+
+All modes allow you to force the centering with curly brackets,
+for example \verb=a{b}c= will center the notes around \texttt{b}.
+
+\subsubsection{Vowel detection}
The default rules built into Gregorio for \texttt{vowel} mode are for
Ecclesiatical Latin and work fairly well (though not perfectly) for
other languages (especially Romance languages). However, Gregorio
provides a gabc \texttt{language} header which allows the language of
-the lyrics to be set. Gregorio will look for a file named
+the lyrics to be set. The default is Latin.
+
+Special characters (input with \texttt{<sp>}) or verbatim text (\texttt{<v>})
+count as consonants, so you have to force centering around them, for example
+\verb=gr{<sp>'ae</sp>}=. If an elision (input with \texttt{<e>}) is present in
+the syllable, Gregorio will consider it as consonant too.
+
+If no vowel is found, the notes are centered around the whole syllable.
+
+\subsubsection{Vowel file}
+
+When run, Gregorio will look for a file named
\texttt{gregorio-vowels.dat} in your working directory or amongst the
-GregorioTeX files. If it finds the requested language (matched in a
+GregorioTeX files. If it finds the language requested by the header (matched in a
\emph{case-sensitive} fashion) in one of these files (henceforth called
vowel files), Gregorio will use the rules contained within for vowel
centering. If it cannot find the requested language in any of the vowel
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/GregorioNabcRef-4_1_0-beta3.pdf b/Build/source/texk/gregorio/gregorio-src/doc/GregorioNabcRef-4_1_0-rc1.pdf
index 51564c9754e..4bd86d99db4 100644
--- a/Build/source/texk/gregorio/gregorio-src/doc/GregorioNabcRef-4_1_0-beta3.pdf
+++ b/Build/source/texk/gregorio/gregorio-src/doc/GregorioNabcRef-4_1_0-rc1.pdf
Binary files differ
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef-4_1_0-beta3.pdf b/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef-4_1_0-beta3.pdf
deleted file mode 100644
index ae826264761..00000000000
--- a/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef-4_1_0-beta3.pdf
+++ /dev/null
Binary files differ
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef-4_1_0-rc1.pdf b/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef-4_1_0-rc1.pdf
new file mode 100644
index 00000000000..e6807bd2cf4
--- /dev/null
+++ b/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef-4_1_0-rc1.pdf
Binary files differ
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef.tex b/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef.tex
index ff6df09c4dd..0125d118a2b 100644
--- a/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef.tex
+++ b/Build/source/texk/gregorio/gregorio-src/doc/GregorioRef.tex
@@ -122,7 +122,7 @@
{\endtabularx\bigskip}
\makeatletter%
-\NewDocumentEnvironment{gdimension}{m}{\macroname{#1}{}{gp-default.tex}}{%
+\NewDocumentEnvironment{gdimension}{m}{\macroname{#1}{}{gsp-default.tex}}{%
\gre@rubberpermit{#1}%
\ifgre@rubber%
@@ -152,7 +152,7 @@
\vspace{1cm}
- \large Version \textbf{4.1.0-beta3}, 9 February 2016 %% PARSE_VERSION_DATE
+ \large Version \textbf{4.1.0-rc1}, 18 February 2016 %% PARSE_VERSION_DATE
\vspace{1.5cm}
\end{center}
diff --git a/Build/source/texk/gregorio/gregorio-src/doc/Makefile.am b/Build/source/texk/gregorio/gregorio-src/doc/Makefile.am
index 0c971c18a05..b6b9a8018c1 100644
--- a/Build/source/texk/gregorio/gregorio-src/doc/Makefile.am
+++ b/Build/source/texk/gregorio/gregorio-src/doc/Makefile.am
@@ -49,10 +49,12 @@ pdf-local: doc
distclean-local:
latexmk -quiet -c -f -jobname=GregorioRef-@FILENAME_VERSION@ GregorioRef.tex
latexmk -quiet -c -f -jobname=GregorioNabcRef-@FILENAME_VERSION@ GregorioNabcRef.tex
- rm -rf _minted* factus.gtex veni.gtex
+ rm -rf _minted* *.gtex *.aux *.gaux
EXTRA_DIST = $(SRCFILES) $(NABCSRCFILES) \
GregorioRef-@FILENAME_VERSION@.pdf \
GregorioNabcRef-@FILENAME_VERSION@.pdf
-MAINTAINERCLEANFILES = GregorioRef-@FILENAME_VERSION@.pdf \
- GregorioNabcRef-@FILENAME_VERSION@.pdf
+
+maintainer-clean-local:
+ rm -rf GregorioRef*.pdf
+ rm -rf GregorioRef-* GregorioNabcRef-*