]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/notation/ancient.itely
Doc: cleanup @file{}, take 2: remove all @/ escaping sequences.
[lilypond.git] / Documentation / notation / ancient.itely
index adec460f29e650f651a884b4f99a20c3ddc1a124..6aedd34bc1ad73aea8b1e0f2c0aabad8c00283b3 100644 (file)
@@ -8,7 +8,8 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.13.36"
+
 
 @node Ancient notation
 @section Ancient notation
@@ -61,7 +62,7 @@ notation,
 @item @ref{Ligatures}.
 @end itemize
 
-@c {{{1 Overview of the supported styles
+
 @node Overview of the supported styles
 @subsection Overview of the supported styles
 
@@ -139,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.
 
-@c {{{1 Ancient notation, general
+
 @node Ancient notation---common features
 @subsection Ancient notation---common features
 
@@ -150,7 +151,7 @@ wishes.
 * Figured bass support::
 @end menu
 
-@c {{{2 Pre-defined contexts
+
 @node Pre-defined contexts
 @unnumberedsubsubsec Pre-defined contexts
 
@@ -169,7 +170,6 @@ and @code{MensuralStaff}.  See further
 @end itemize
 
 
-@c {{{2 Ligatures
 @node Ligatures
 @unnumberedsubsubsec Ligatures
 
@@ -227,7 +227,7 @@ The syntax still uses the deprecated infix style @code{\[ music expr
 postfix style @code{note\[ ... note\]}.
 
 @c Alternatively, the file
-@c @file{gregorian@/-init@/.ly} can be included; it provides a scheme
+@c @file{gregorian-init.ly} can be included; it provides a scheme
 @c function
 @c @example
 @c \ligature @var{music expr}
@@ -238,8 +238,6 @@ postfix style @code{note\[ ... note\]}.
 @c -- eo
 
 
-
-@c {{{2 Custodes
 @node Custodes
 @unnumberedsubsubsec Custodes
 
@@ -314,7 +312,6 @@ Snippets:
 @rlsr{Ancient notation}.
 
 
-@c {{{2 Figured bass support
 @node Figured bass support
 @unnumberedsubsubsec Figured bass support
 
@@ -322,7 +319,6 @@ There is limited support for figured bass notation from the
 Baroque period; see @ref{Figured bass}.
 
 
-@c {{{1 Typesetting mensural music
 @node Typesetting mensural music
 @subsection Typesetting mensural music
 
@@ -339,8 +335,6 @@ Baroque period; see @ref{Figured bass}.
 @end menu
 
 
-
-@c {{{2Mensural contexts
 @node Mensural contexts
 @unnumberedsubsubsec Mensural contexts
 
@@ -378,7 +372,6 @@ entering the chant, as the following excerpt demonstrates:
 @c TODO: nothing here yet ...
 
 
-@c {{{2 Mensural clefs
 @node Mensural clefs
 @unnumberedsubsubsec Mensural clefs
 
@@ -497,7 +490,6 @@ Notation Reference:
 The mensural g clef is mapped to the Petrucci g clef.
 
 
-@c {{{2Mensural time signatures
 @node Mensural time signatures
 @unnumberedsubsubsec Mensural time signatures
 
@@ -612,7 +604,6 @@ The @code{mensural68alt} and @code{neomensural68alt} symbols
 Use @code{\markup @{\musicglyph #"timesig.mensural68alt" @}} instead.
 
 
-@c {{{2Mensural note heads
 @node Mensural note heads
 @unnumberedsubsubsec Mensural note heads
 
@@ -658,7 +649,6 @@ Notation Reference:
 @ref{Note head styles}, gives an overview of all available note head styles.
 
 
-@c {{{2Mensural flags
 @node Mensural flags
 @unnumberedsubsubsec Mensural flags
 
@@ -702,14 +692,14 @@ 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).
 
-@c {{{2Mensural rests
+
 @node Mensural rests
 @unnumberedsubsubsec Mensural rests
 
 @cindex rests, ancient
 
 Use the @code{style} property of grob @code{Rest} to select
-ancient rests.   Supported styles are @code{classical},
+ancient rests.  Supported styles are @code{classical},
 @code{neomensural}, and @code{mensural}.  @code{classical} differs
 from the @code{default} style only in that the quarter rest looks
 like a horizontally mirrored 8th rest.  The @code{mensural} and
@@ -741,7 +731,6 @@ Notation Reference:
 rests.
 
 
-@c {{{2Mensural accidentals and key signatures
 @node Mensural accidentals and key signatures
 @unnumberedsubsubsec Mensural accidentals and key signatures
 
@@ -753,27 +742,11 @@ different from the default style.  If called for, the natural sign
 will be taken from the @code{vaticana} style.
 
 @lilypond[quote,ragged-right,staffsize=26]
-\score {
-{
-  \textLengthOn
-  s^\markup {
-    \column {
-      "mensural"
-      \line { " " \musicglyph #"accidentals.mensural-1"
-        " " \musicglyph #"accidentals.mensural1" }
-    }
-  }
-}
-\layout {
-  interscoreline = 1
-  \context { \Score \remove "Bar_number_engraver" }
-  \context { \Staff
-      \remove "Clef_engraver"
-      \remove "Key_engraver"
-      \remove "Time_signature_engraver"
-      \remove "Staff_symbol_engraver"
-      \override VerticalAxisGroup #'minimum-Y-extent = ##f
-    }
+\markup {
+  \column {
+    "mensural"
+    \line { " " \musicglyph #"accidentals.mensural-1"
+      " " \musicglyph #"accidentals.mensural1" }
   }
 }
 @end lilypond
@@ -796,7 +769,6 @@ Internals Reference:
 @rinternals{KeySignature}.
 
 
-@c {{{2 Annotational accidentals (musica ficta)
 @node Annotational accidentals (musica ficta)
 @unnumberedsubsubsec Annotational accidentals (@emph{musica ficta})
 
@@ -843,7 +815,6 @@ Internals Reference:
 @rinternals{AccidentalSuggestion}.
 
 
-@c {{{2White mensural ligatures
 @node White mensural ligatures
 @unnumberedsubsubsec White mensural ligatures
 
@@ -939,7 +910,6 @@ to the following
 Horizontal spacing of ligatures is poor.
 
 
-@c {{{1 Typesetting Gregorian chant
 @node Typesetting Gregorian chant
 @subsection Typesetting Gregorian chant
 
@@ -949,7 +919,7 @@ Horizontal spacing of ligatures is poor.
 * Gregorian accidentals and key signatures::
 * Divisiones::
 * Gregorian articulation signs::
-* Augmentum dots (@emph{morae})::
+* Augmentum dots (morae)::
 * Gregorian square neume ligatures::
 @end menu
 
@@ -963,7 +933,6 @@ mensural ligatures.  See @ref{Ligatures}, for how ligature
 engravers work.
 
 
-@c {{{2Gregorian chant contexts
 @node Gregorian chant contexts
 @unnumberedsubsubsec Gregorian chant contexts
 
@@ -1002,7 +971,6 @@ the following excerpt demonstrates:
 @c TODO: nothing here yet ...
 
 
-@c {{{2 Gregorian clefs
 @node Gregorian clefs
 @unnumberedsubsubsec Gregorian clefs
 
@@ -1140,7 +1108,6 @@ Notation Reference:
 @ref{Clef}.
 
 
-@c {{{2 Gregorian accidentals and key signatures
 @node Gregorian accidentals and key signatures
 @unnumberedsubsubsec Gregorian accidentals and key signatures
 
@@ -1150,35 +1117,19 @@ Notation Reference:
 Accidentals for the three different Gregorian styles are available:
 
 @lilypond[quote,ragged-right,staffsize=26]
-\score {
-{
-  \textLengthOn
-  s^\markup {
-    \column {
-      "vaticana"
-      \line { " " \musicglyph #"accidentals.vaticana-1"
-        " " \musicglyph #"accidentals.vaticana0" }
-    }
-    \column {
-      "medicaea"
-      \line { " " \musicglyph #"accidentals.medicaea-1" }
-    }
-    \column {
-      "hufnagel"
-      \line { " " \musicglyph #"accidentals.hufnagel-1" }
-    }
+\markup {
+  \column {
+    "vaticana"
+    \line { " " \musicglyph #"accidentals.vaticana-1"
+      " " \musicglyph #"accidentals.vaticana0" }
   }
-}
-\layout {
-  interscoreline = 1
-  \context { \Score \remove "Bar_number_engraver" }
-  \context { \Staff
-      \remove "Clef_engraver"
-      \remove "Key_engraver"
-      \remove "Time_signature_engraver"
-      \remove "Staff_symbol_engraver"
-      \override VerticalAxisGroup #'minimum-Y-extent = ##f
-    }
+  \column {
+    "medicaea"
+    \line { " " \musicglyph #"accidentals.medicaea-1" }
+  }
+  \column {
+    "hufnagel"
+    \line { " " \musicglyph #"accidentals.hufnagel-1" }
   }
 }
 @end lilypond
@@ -1208,7 +1159,6 @@ Internals Reference:
 @rinternals{KeySignature}.
 
 
-@c {{{2Divisiones
 @node Divisiones
 @unnumberedsubsubsec Divisiones
 
@@ -1228,12 +1178,12 @@ the breathmarks from @ref{Breath marks}.  The @emph{finalis} sign not
 only marks the end of a chant, but is also frequently used within a
 single antiphonal/responsorial chant to mark the end of each section.
 
-To use divisiones, include the file @file{gregorian@/.ly}.  It
+To use divisiones, include the file @file{gregorian.ly}.  It
 contains definitions that you can apply by just inserting
 @code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima},
 and @code{\finalis} at proper places in the input.  Some editions use
 @emph{virgula} or @emph{caesura} instead of divisio minima.
-Therefore, @file{gregorian@/.ly} also defines @code{\virgula} and
+Therefore, @file{gregorian.ly} also defines @code{\virgula} and
 @code{\caesura}
 
 @lilypond[quote,ragged-right]
@@ -1284,7 +1234,6 @@ Therefore, @file{gregorian@/.ly} also defines @code{\virgula} and
 @endpredefined
 
 
-@c {{{2Gregorian articulations
 @node Gregorian articulation signs
 @unnumberedsubsubsec Gregorian articulation signs
 
@@ -1302,18 +1251,26 @@ Vaticana} style are provided.
     \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
 
 
-@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
@@ -1321,12 +1278,8 @@ Vaticana} style are provided.
 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
@@ -1360,7 +1313,6 @@ Snippets:
 @rlsr{Ancient notation}.
 
 
-@c {{{2Gregorian square neumes ligatures
 @node Gregorian square neume ligatures
 @unnumberedsubsubsec Gregorian square neume ligatures
 
@@ -1374,7 +1326,7 @@ still lacking, such as (among others) horizontal alignment of multiple
 ligatures, lyrics alignment, and proper handling of accidentals.
 
 The support for Gregorian neumes is enabled by @code{\include}ing
-"gregorian.ly" at the beginning of the file.  This makes available
+@file{gregorian.ly} at the beginning of the file.  This makes available
 a number of extra commands to produce the neume symbols used in
 plainchant notation.
 
@@ -1504,7 +1456,7 @@ ligature, and usually falls on a half-tone step, but it is
 perfectly possible, although incorrect, to make a single-note
 quilisma.
 
-In addition to the note signs, gregorian.ly also defines the
+In addition to the note signs, @file{gregorian.ly} also defines the
 commands @code{\versus}, @code{\responsum}, @code{\ij},
 @code{\iij}, @code{\IJ}, and @code{\IIJ}, that will produce the
 corresponding characters, e.g., for use in lyrics, as section
@@ -2317,8 +2269,6 @@ unary music function, such that @code{\augmentum} can be intermixed
 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
 
@@ -2347,7 +2297,7 @@ used for modern transcriptions of polyphonic music;
 same source.
 @end itemize
 
-@c {{{2Incipits
+
 @node Incipits
 @unnumberedsubsubsec Incipits
 
@@ -2361,7 +2311,6 @@ TBC
 @c ... and reference to other sections ...
 
 
-@c {{{2Mensurstriche layout
 @node Mensurstriche layout
 @unnumberedsubsubsec Mensurstriche layout
 
@@ -2387,7 +2336,6 @@ orientation aids that bar lines give.
 @c ... and reference to other sections ...
 
 
-@c {{{2Transcribing Gregorian chant
 @node Transcribing Gregorian chant
 @unnumberedsubsubsec Transcribing Gregorian chant
 
@@ -2563,7 +2511,7 @@ spirLyr = \lyricmode {
 @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
 
@@ -2574,11 +2522,11 @@ TBC
 @c @seealso
 @c ... and reference to other sections ...
 
-@c {{{2Editorial markings
+
 @node Editorial markings
 @unnumberedsubsubsec Editorial markings
 
-@c {{{2Baroque rhythmic notation
+
 @c @node Baroque rhythmic notation
 @c @unnumberedsubsubsec Baroque rhythmic notation