summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-05-06 21:28:23 +0000
committerKarl Berry <karl@freefriends.org>2019-05-06 21:28:23 +0000
commit926e35dfc63afa701f76cdefd4d6a3aad4883df7 (patch)
tree72f7273ab0b8f05b68ccb15bf040445b97c8f0fd /Master/texmf-dist/doc
parent3bd097ea099d3f2d30db3718e6582650e9e6b389 (diff)
gregoriotex
git-svn-id: svn://tug.org/texlive/trunk@51029 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/luatex/gregoriotex/Command_Index_User.tex6
-rw-r--r--Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex10
-rw-r--r--Master/texmf-dist/doc/luatex/gregoriotex/GregorioNabcRef.pdfbin487574 -> 484381 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.pdfbin808380 -> 807105 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.tex2
5 files changed, 12 insertions, 6 deletions
diff --git a/Master/texmf-dist/doc/luatex/gregoriotex/Command_Index_User.tex b/Master/texmf-dist/doc/luatex/gregoriotex/Command_Index_User.tex
index e14eb66559b..99c985f9ec3 100644
--- a/Master/texmf-dist/doc/luatex/gregoriotex/Command_Index_User.tex
+++ b/Master/texmf-dist/doc/luatex/gregoriotex/Command_Index_User.tex
@@ -938,9 +938,9 @@ Macro to set how the text of the lyrics aligns with the alignment point of its r
& \texttt{firstletter} & The center of the first letter/character of the syllable will align with the alignment point of the neumes\\
\end{argtable}
-\textbf{Nota Bene:} What constitutes the ``vowel'' of the syllable is determined by the language the lyric text is written in, as specified by the use of the \texttt{language} header in the gabc file. Out of the box, Gregorio\TeX\ explicitly supports only Latin and English, but the rules for Latin have a high degree of overlap with many Romance languages, allowing them to fall back on the Latin rules with acceptable results.
+\textbf{Nota Bene:} What constitutes the ``vowel'' of the syllable is determined by the language the lyric text is written in, as specified by the use of the \texttt{language} header in the gabc file. Out of the box, Gregorio\TeX\ explicitly supports Latin, English, Church Slavonic and Hungarian. Polish, Czech, and Slovak are supported as aliases for Church Slavonic. Furthermore the rules for Latin have a high degree of overlap with many Romance languages, allowing them to fall back on the Latin rules with acceptable results.
-You can also define your own languages in \texttt{gregorio-vowels.dat}. If you do define a language, please consider sharing your work by submitting it to the project (see CONTRIBUTING.md for instructions).
+You can also define your own languages in \texttt{gregorio-vowels.dat} (see \nameref{customvowels} for details). If you do define a language, please consider sharing your work by submitting it to the project (see CONTRIBUTING.md for instructions).
Finally, in cases where you want some sort of exceptional alignment, you can force Gregorio to consider a particular part of the syllable to be the ``vowel'' by enclosing it in curly braces (``\{'' and ``\}'') in your gabc file. Curly braces only affect alignment when using vowel centering. Syllable centering will always use the entire syllable, and firstletter centering will always use the first character of the syllable --- regardless of curly braces in the gabc file.
@@ -1366,7 +1366,7 @@ For a full description of how to make use of the ancient notation capabilities o
Macro to set the font to be used for the ancient notation.
\begin{argtable}
- \#1 & string & the name of the font\\
+ \#1 & string & the name of the font, either \texttt{gregall}, \texttt{grelaon}, or \texttt{gresgmodern}\\
\#2 & integer & point size at which the font should be loaded\\
\end{argtable}
diff --git a/Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex b/Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex
index 2e70a2701d6..3de2b367821 100644
--- a/Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex
+++ b/Master/texmf-dist/doc/luatex/gregoriotex/Gabc.tex
@@ -388,6 +388,8 @@ If no vowel is found, the notes are centered around the whole syllable.
If you are using a language for which built-in language rules do not exist and the fallbacks are insufficient, then you may wish to provide your own set of vowel detection rules. This can be done with a special file:\verb=gregorio-vowels.dat=. See \nameref{customvowels} for information about how to create and use this file.
+Languages which are currently supported are Latin, English, Church Slavonic and Hungarian. Polish, Czech, and Slovak are supported as aliases for Church Slavonic. All of these languages can be specified by name (in which case both titlecase and lowercase names are recognized) and by using their ISO 639 (-1 two-letter, -2/T three-letter, or -2/B three-letter) standard abbreviations.
+
\subsection{Notation --- Note Syntax}\label{notesyntax}
@@ -1101,6 +1103,8 @@ for the specified language. It must be followed by the language name,
enclosed in square brackets, and a semicolon. The language specified
applies until the next language statement.
+When choosing the name for your language, it is preferable that you use the ISO 639-1 standard (two-letter) code. All other names should be listed as aliases (see above). If you plan to submit your vowel detection rules for inclusion in the Gregorio source, then this will be required.
+
\item[vowel]
The \texttt{vowel} keyword indicates that the characters which follow,
@@ -1138,9 +1142,11 @@ the syllabic consonants \emph{l} and \emph{r} in Czech.
By way of example, here is a vowel file that works for English:
\begin{lstlisting}[autogobble]
-alias [english] to [English];
+alias [english] to [en];
+alias [English] to [en];
+alias [eng] to [en];
-language [English];
+language [en];
vowel aàáAÀÁ;
vowel eèéëEÈÉË;
diff --git a/Master/texmf-dist/doc/luatex/gregoriotex/GregorioNabcRef.pdf b/Master/texmf-dist/doc/luatex/gregoriotex/GregorioNabcRef.pdf
index 77e8c05ebca..08d750889ee 100644
--- a/Master/texmf-dist/doc/luatex/gregoriotex/GregorioNabcRef.pdf
+++ b/Master/texmf-dist/doc/luatex/gregoriotex/GregorioNabcRef.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.pdf b/Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.pdf
index d77f77ce8c8..3628fc10529 100644
--- a/Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.pdf
+++ b/Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.tex b/Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.tex
index 6473ceaa733..dc897c77032 100644
--- a/Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.tex
+++ b/Master/texmf-dist/doc/luatex/gregoriotex/GregorioRef.tex
@@ -183,7 +183,7 @@
\vspace{1cm}
- \large Version \textbf{5.2.0}, 10 March 2019 %% PARSE_VERSION_DATE
+ \large Version \textbf{5.2.1}, 6 April 2019 %% PARSE_VERSION_DATE
\vspace{1.5cm}
\end{center}