Doc: NR 1.8.1 addded @knownissue for Text Spanner

[lilypond.git] / Documentation / notation / ancient.itely

diff --git a/Documentation/notation/ancient.itely b/Documentation/notation/ancient.itely
index cd01c94a40f8564af2a21f2769720180666b6573..c2a4c072c59ee41a656235f398c2362a4d61894e 100644 (file)
--- a/Documentation/notation/ancient.itely
+++ b/Documentation/notation/ancient.itely
@@ -4,11 +4,13 @@
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the

-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..

 @end ignore
 
 @c \version "2.12.0"
 
 @end ignore
 
 @c \version "2.12.0"
 

+

 @node Ancient notation
 @section Ancient notation
 
 @node Ancient notation
 @section Ancient notation
 


@@ -60,7 +62,7 @@ notation,
 @item @ref{Ligatures}.
 @end itemize
 
 @item @ref{Ligatures}.
 @end itemize
 

-@c {{{1 Overview of the supported styles
+

 @node Overview of the supported styles
 @subsection Overview of the supported styles
 
 @node Overview of the supported styles
 @subsection Overview of the supported styles
 


@@ -138,7 +140,7 @@ others, so that one can use mensural flags, petrucci noteheads,
 classical rests and vaticana clefs in the same piece, if one
 wishes.
 
 classical rests and vaticana clefs in the same piece, if one
 wishes.
 

-@c {{{1 Ancient notation, general
+

 @node Ancient notation---common features
 @subsection Ancient notation---common features
 
 @node Ancient notation---common features
 @subsection Ancient notation---common features
 


@@ -149,7 +151,7 @@ wishes.
 * Figured bass support::
 @end menu
 
 * Figured bass support::
 @end menu
 

-@c {{{2 Pre-defined contexts
+

 @node Pre-defined contexts
 @unnumberedsubsubsec Pre-defined contexts
 
 @node Pre-defined contexts
 @unnumberedsubsubsec Pre-defined contexts
 


@@ -168,7 +170,6 @@ and @code{MensuralStaff}.  See further
 @end itemize
 
 
 @end itemize
 
 

-@c {{{2 Ligatures

 @node Ligatures
 @unnumberedsubsubsec Ligatures
 
 @node Ligatures
 @unnumberedsubsubsec Ligatures
 


@@ -237,8 +238,6 @@ postfix style @code{note\[ ... note\]}.
 @c -- eo
 
 
 @c -- eo
 
 

-
-@c {{{2 Custodes

 @node Custodes
 @unnumberedsubsubsec Custodes
 
 @node Custodes
 @unnumberedsubsubsec Custodes
 


@@ -313,7 +312,6 @@ Snippets:
 @rlsr{Ancient notation}.
 
 
 @rlsr{Ancient notation}.
 
 

-@c {{{2 Figured bass support

 @node Figured bass support
 @unnumberedsubsubsec Figured bass support
 
 @node Figured bass support
 @unnumberedsubsubsec Figured bass support
 


@@ -321,7 +319,6 @@ There is limited support for figured bass notation from the
 Baroque period; see @ref{Figured bass}.
 
 
 Baroque period; see @ref{Figured bass}.
 
 

-@c {{{1 Typesetting mensural music

 @node Typesetting mensural music
 @subsection Typesetting mensural music
 
 @node Typesetting mensural music
 @subsection Typesetting mensural music
 


@@ -338,8 +335,6 @@ Baroque period; see @ref{Figured bass}.
 @end menu
 
 
 @end menu
 
 

-
-@c {{{2Mensural contexts

 @node Mensural contexts
 @unnumberedsubsubsec Mensural contexts
 
 @node Mensural contexts
 @unnumberedsubsubsec Mensural contexts
 


@@ -377,7 +372,6 @@ entering the chant, as the following excerpt demonstrates:
 @c TODO: nothing here yet ...
 
 
 @c TODO: nothing here yet ...
 
 

-@c {{{2 Mensural clefs

 @node Mensural clefs
 @unnumberedsubsubsec Mensural clefs
 
 @node Mensural clefs
 @unnumberedsubsubsec Mensural clefs
 


@@ -496,7 +490,6 @@ Notation Reference:
 The mensural g clef is mapped to the Petrucci g clef.
 
 
 The mensural g clef is mapped to the Petrucci g clef.
 
 

-@c {{{2Mensural time signatures

 @node Mensural time signatures
 @unnumberedsubsubsec Mensural time signatures
 
 @node Mensural time signatures
 @unnumberedsubsubsec Mensural time signatures
 


@@ -611,7 +604,6 @@ The @code{mensural68alt} and @code{neomensural68alt} symbols
 Use @code{\markup @{\musicglyph #"timesig.mensural68alt" @}} instead.
 
 
 Use @code{\markup @{\musicglyph #"timesig.mensural68alt" @}} instead.
 
 

-@c {{{2Mensural note heads

 @node Mensural note heads
 @unnumberedsubsubsec Mensural note heads
 
 @node Mensural note heads
 @unnumberedsubsubsec Mensural note heads
 


@@ -657,7 +649,6 @@ Notation Reference:
 @ref{Note head styles}, gives an overview of all available note head styles.
 
 
 @ref{Note head styles}, gives an overview of all available note head styles.
 
 

-@c {{{2Mensural flags

 @node Mensural flags
 @unnumberedsubsubsec Mensural flags
 
 @node Mensural flags
 @unnumberedsubsubsec Mensural flags
 


@@ -701,7 +692,7 @@ staff lines.  This may not always be true when using advanced layout
 features of classical notation (which however are typically out of
 scope for mensural notation).
 
 features of classical notation (which however are typically out of
 scope for mensural notation).
 

-@c {{{2Mensural rests
+

 @node Mensural rests
 @unnumberedsubsubsec Mensural rests
 
 @node Mensural rests
 @unnumberedsubsubsec Mensural rests
 


@@ -740,7 +731,6 @@ Notation Reference:
 rests.
 
 
 rests.
 
 

-@c {{{2Mensural accidentals and key signatures

 @node Mensural accidentals and key signatures
 @unnumberedsubsubsec Mensural accidentals and key signatures
 
 @node Mensural accidentals and key signatures
 @unnumberedsubsubsec Mensural accidentals and key signatures
 


@@ -795,7 +785,6 @@ Internals Reference:
 @rinternals{KeySignature}.
 
 
 @rinternals{KeySignature}.
 
 

-@c {{{2 Annotational accidentals (musica ficta)

 @node Annotational accidentals (musica ficta)
 @unnumberedsubsubsec Annotational accidentals (@emph{musica ficta})
 
 @node Annotational accidentals (musica ficta)
 @unnumberedsubsubsec Annotational accidentals (@emph{musica ficta})
 


@@ -842,7 +831,6 @@ Internals Reference:
 @rinternals{AccidentalSuggestion}.
 
 
 @rinternals{AccidentalSuggestion}.
 
 

-@c {{{2White mensural ligatures

 @node White mensural ligatures
 @unnumberedsubsubsec White mensural ligatures
 
 @node White mensural ligatures
 @unnumberedsubsubsec White mensural ligatures
 


@@ -938,7 +926,6 @@ to the following
 Horizontal spacing of ligatures is poor.
 
 
 Horizontal spacing of ligatures is poor.
 
 

-@c {{{1 Typesetting Gregorian chant

 @node Typesetting Gregorian chant
 @subsection Typesetting Gregorian chant
 
 @node Typesetting Gregorian chant
 @subsection Typesetting Gregorian chant
 


@@ -948,7 +935,7 @@ Horizontal spacing of ligatures is poor.
 * Gregorian accidentals and key signatures::
 * Divisiones::
 * Gregorian articulation signs::
 * Gregorian accidentals and key signatures::
 * Divisiones::
 * Gregorian articulation signs::

-* Augmentum dots (@emph{morae})::
+* Augmentum dots (morae)::

 * Gregorian square neume ligatures::
 @end menu
 
 * Gregorian square neume ligatures::
 @end menu
 


@@ -962,7 +949,6 @@ mensural ligatures.  See @ref{Ligatures}, for how ligature
 engravers work.
 
 
 engravers work.
 
 

-@c {{{2Gregorian chant contexts

 @node Gregorian chant contexts
 @unnumberedsubsubsec Gregorian chant contexts
 
 @node Gregorian chant contexts
 @unnumberedsubsubsec Gregorian chant contexts
 


@@ -1001,7 +987,6 @@ the following excerpt demonstrates:
 @c TODO: nothing here yet ...
 
 
 @c TODO: nothing here yet ...
 
 

-@c {{{2 Gregorian clefs

 @node Gregorian clefs
 @unnumberedsubsubsec Gregorian clefs
 
 @node Gregorian clefs
 @unnumberedsubsubsec Gregorian clefs
 


@@ -1139,7 +1124,6 @@ Notation Reference:
 @ref{Clef}.
 
 
 @ref{Clef}.
 
 

-@c {{{2 Gregorian accidentals and key signatures

 @node Gregorian accidentals and key signatures
 @unnumberedsubsubsec Gregorian accidentals and key signatures
 
 @node Gregorian accidentals and key signatures
 @unnumberedsubsubsec Gregorian accidentals and key signatures
 


@@ -1207,7 +1191,6 @@ Internals Reference:
 @rinternals{KeySignature}.
 
 
 @rinternals{KeySignature}.
 
 

-@c {{{2Divisiones

 @node Divisiones
 @unnumberedsubsubsec Divisiones
 
 @node Divisiones
 @unnumberedsubsubsec Divisiones
 


@@ -1235,7 +1218,36 @@ and @code{\finalis} at proper places in the input.  Some editions use
 Therefore, @file{gregorian@/.ly} also defines @code{\virgula} and
 @code{\caesura}
 
 Therefore, @file{gregorian@/.ly} also defines @code{\virgula} and
 @code{\caesura}
 

-@lilypondfile[quote,ragged-right]{divisiones.ly}
+@lilypond[quote,ragged-right]
+\include "gregorian.ly"
+\score {
+  <<
+    \context VaticanaVoice {
+      \override TextScript  #'padding = #3
+      g a g
+      s^\markup { "divisio minima" }
+      \divisioMinima
+      g a g
+      s^\markup { "divisio maior" }
+      \divisioMaior
+      g a g
+      s^\markup { "divisio maxima" }
+      \divisioMaxima
+      \break
+      g a g
+      s^\markup { "finalis" }
+      \finalis
+      g a g
+      s^\markup { "virgula" }
+      \virgula
+      g a g
+      s^\markup { "caesura" }
+      \caesura
+      g a g
+    }
+  >>
+}
+@end lilypond

 
 
 @predefined
 
 
 @predefined


@@ -1254,7 +1266,6 @@ Therefore, @file{gregorian@/.ly} also defines @code{\virgula} and
 @endpredefined
 
 
 @endpredefined
 
 

-@c {{{2Gregorian articulations

 @node Gregorian articulation signs
 @unnumberedsubsubsec Gregorian articulation signs
 
 @node Gregorian articulation signs
 @unnumberedsubsubsec Gregorian articulation signs
 


@@ -1272,18 +1283,26 @@ Vaticana} style are provided.
     \override TextScript #'font-family = #'typewriter
     \override TextScript #'font-shape = #'upright
     \override Script #'padding = #-0.1
     \override TextScript #'font-family = #'typewriter
     \override TextScript #'font-shape = #'upright
     \override Script #'padding = #-0.1

-    a\ictus_"ictus " \break
-    a\circulus_"circulus " \break
-    a\semicirculus_"semicirculus " \break
-    a\accentus_"accentus " \break
+    a\ictus_"ictus " \bar "" \break
+    a\circulus_"circulus " \bar "" \break
+    a\semicirculus_"semicirculus " \bar "" \break
+    a\accentus_"accentus " \bar "" \break

     \[ a_"episema" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
   }
 }
 @end lilypond
 
 
     \[ a_"episema" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
   }
 }
 @end lilypond
 
 

-@c @seealso
-@c TODO: nothing here yet ...
+Snippets:
+@rlsr{Ancient notation}.
+
+Internals Reference:
+@rinternals{Episema},
+@rinternals{EpisemaEvent},
+@rinternals{Episema_engraver},
+@rinternals{Script},
+@rinternals{ScriptEvent},
+@rinternals{Script_engraver}.

 
 
 @knownissues
 
 
 @knownissues


@@ -1291,12 +1310,8 @@ Vaticana} style are provided.
 Some articulations are vertically placed too closely to the
 corresponding note heads.
 
 Some articulations are vertically placed too closely to the
 corresponding note heads.
 

-The episema line is not displayed in many cases.  If it is displayed,
-the right end of the episema line is often too far to the right.

 
 

-
-@c {{{2Augmentum dots (@emph{morae})
-@node Augmentum dots (@emph{morae})
+@node Augmentum dots (morae)

 @unnumberedsubsubsec Augmentum dots (@emph{morae})
 
 Augmentum dots, also called @emph{morae}, are added with the music
 @unnumberedsubsubsec Augmentum dots (@emph{morae})
 
 Augmentum dots, also called @emph{morae}, are added with the music


@@ -1330,7 +1345,6 @@ Snippets:
 @rlsr{Ancient notation}.
 
 
 @rlsr{Ancient notation}.
 
 

-@c {{{2Gregorian square neumes ligatures

 @node Gregorian square neume ligatures
 @unnumberedsubsubsec Gregorian square neume ligatures
 
 @node Gregorian square neume ligatures
 @unnumberedsubsubsec Gregorian square neume ligatures
 


@@ -2287,8 +2301,6 @@ unary music function, such that @code{\augmentum} can be intermixed
 with head prefixes in arbitrary order.
 
 
 with head prefixes in arbitrary order.
 
 

-
-@c Working with ancient music: scenarios and solutions::  {{{1

 @node Working with ancient music---scenarios and solutions
 @subsection Working with ancient music---scenarios and solutions
 
 @node Working with ancient music---scenarios and solutions
 @subsection Working with ancient music---scenarios and solutions
 


@@ -2317,7 +2329,7 @@ used for modern transcriptions of polyphonic music;
 same source.
 @end itemize
 
 same source.
 @end itemize
 

-@c {{{2Incipits
+

 @node Incipits
 @unnumberedsubsubsec Incipits
 
 @node Incipits
 @unnumberedsubsubsec Incipits
 


@@ -2331,7 +2343,6 @@ TBC
 @c ... and reference to other sections ...
 
 
 @c ... and reference to other sections ...
 
 

-@c {{{2Mensurstriche layout

 @node Mensurstriche layout
 @unnumberedsubsubsec Mensurstriche layout
 
 @node Mensurstriche layout
 @unnumberedsubsubsec Mensurstriche layout
 


@@ -2357,7 +2368,6 @@ orientation aids that bar lines give.
 @c ... and reference to other sections ...
 
 
 @c ... and reference to other sections ...
 
 

-@c {{{2Transcribing Gregorian chant

 @node Transcribing Gregorian chant
 @unnumberedsubsubsec Transcribing Gregorian chant
 
 @node Transcribing Gregorian chant
 @unnumberedsubsubsec Transcribing Gregorian chant
 


@@ -2533,7 +2543,7 @@ spirLyr = \lyricmode {
 @c @seealso
 @c ... and reference to other sections ...
 
 @c @seealso
 @c ... and reference to other sections ...
 

-@c {{{2Ancient and modern from one source
+

 @node Ancient and modern from one source
 @unnumberedsubsubsec Ancient and modern from one source
 
 @node Ancient and modern from one source
 @unnumberedsubsubsec Ancient and modern from one source
 


@@ -2544,11 +2554,11 @@ TBC
 @c @seealso
 @c ... and reference to other sections ...
 
 @c @seealso
 @c ... and reference to other sections ...
 

-@c {{{2Editorial markings
+

 @node Editorial markings
 @unnumberedsubsubsec Editorial markings
 
 @node Editorial markings
 @unnumberedsubsubsec Editorial markings
 

-@c {{{2Baroque rhythmic notation
+

 @c @node Baroque rhythmic notation
 @c @unnumberedsubsubsec Baroque rhythmic notation
 
 @c @node Baroque rhythmic notation
 @c @unnumberedsubsubsec Baroque rhythmic notation