summaryrefslogtreecommitdiff
path: root/support/gregoriotex/doc/Gabc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'support/gregoriotex/doc/Gabc.tex')
-rw-r--r--support/gregoriotex/doc/Gabc.tex12
1 files changed, 8 insertions, 4 deletions
diff --git a/support/gregoriotex/doc/Gabc.tex b/support/gregoriotex/doc/Gabc.tex
index 3de2b36782..c76d7e4a78 100644
--- a/support/gregoriotex/doc/Gabc.tex
+++ b/support/gregoriotex/doc/Gabc.tex
@@ -1,7 +1,7 @@
% !TEX root = GregorioRef.tex
% !TEX program = LuaLaTeX+se
%
-% Copyright (C) 2006-2019 The Gregorio Project (see CONTRIBUTORS.md)
+% Copyright (C) 2006-2021 The Gregorio Project (see CONTRIBUTORS.md)
%
% This file is part of Gregorio.
%
@@ -91,7 +91,6 @@ Some headers have special meaning to Gregorio:
\end{lstlisting}
\item[author] The author of the piece, if known; of course, the author of most traditional chant is not known.
\item[language] The language of the lyrics.
-\item[oriscus-orientation] If \texttt{legacy}, the orientation of an unconnected oriscus must be set manually.
\item[mode] The mode of the piece. This should normally be an Arabic
number between 1 and 8, but may be any text required for unusual
cases. The mode number will be converted to roman numerals and
@@ -245,6 +244,11 @@ syllables. Spaces (end end-of-lines) in syllable text mark the end of words
and should be placed after the parenthesized notes section for the last
syllable of a given word.
+The special character \texttt{\$} is an ``escape'' character which causes the
+character which follows it to lose any special meaning. This can be used to
+insert parentheses in text (\ie, use \texttt{\$(}). In order to put a
+\texttt{\$} itself in text, escape it (\ie, use \texttt{\$\$}).
+
There are several markup-like codes that may be inserted into syllable text. We divide these into three categories: style tags, syllable controls, and other.
\paragraph{Style Tags}
@@ -491,7 +495,7 @@ Some examples:
g(g) g<sp>~~</sp>(g~) g<(g<) g>(g>) go(go) go<sp>~~</sp>(go~) gw(gw)
gv(gv) gV(gV) gs(gs) gs<(gs<) g=(g=)
( ) (z) ( )
- gr(gr) gR(gR) gr0(gr0) G(G) G0(G0) G1(G1) G~(G~) G>(G>) Gr(Gr) gx(gx)
+ gr(gr) gR(gR) gr0(gr0) G(G) G0(G0) G1(G1) G<sp>~~</sp>(G~) G>(G>) Gr(Gr) gx(gx)
g#(g#) gy(gy)
( )
}
@@ -1043,7 +1047,7 @@ code at the glyph level, or \texttt{[ev:}\textit{tex code}\texttt{]} to insert
Here, note, glyph, and element refer to how Gregorio understands the score.
-\subsubsection{Macros}
+\subsubsection{Macros}\label{usemacros}
Macros may be defined using the \texttt{def-m}\textit{n} headers, where
\textit{n} is 0--9, as described in the \nameref{headers} section above. Then