From 8e487aa49dde9141b7081c8fb9d0571a58c2f760 Mon Sep 17 00:00:00 2001 From: Graham Percival Date: Thu, 12 Jun 2008 21:23:47 -0700 Subject: [PATCH] First half of Kurt's update. --- Documentation/user/ancient.itely | 199 ++++++++++++++++++------------- 1 file changed, 113 insertions(+), 86 deletions(-) diff --git a/Documentation/user/ancient.itely b/Documentation/user/ancient.itely index b314edef96..db88828dad 100644 --- a/Documentation/user/ancient.itely +++ b/Documentation/user/ancient.itely @@ -18,105 +18,91 @@ @cindex mensural @menu -* Introduction to ancient notation:: -* Alternative note signs:: -* Additional note signs:: -* Pre-defined contexts:: -* Transcribing ancient music:: -* Editorial markings:: +* Introduction to ancient notation:: +* Alternative note signs:: +* Additional note signs:: +* Pre-defined contexts:: +* Transcribing ancient music:: +* Editorial markings:: @end menu + @node Introduction to ancient notation @subsection Introduction to ancient notation @menu -* Ancient notation supported:: +* Ancient notation supported:: @end menu + @node Ancient notation supported @subsubsection Ancient notation supported -Support for ancient notation includes features for mensural notation -and Gregorian Chant notation. There is also limited support for -figured bass notation, see @ref{Figured bass}. +Support for ancient notation includes features for mensural notation and +Gregorian chant notation, as well as limited support for figured bass notation. Many graphical objects provide a @code{style} property, see + @itemize -@item -@ref{Ancient note heads}, -@item -@ref{Ancient accidentals}, -@item -@ref{Ancient rests}, -@item -@ref{Ancient clefs}, -@item -@ref{Ancient flags}, -@item -@ref{Ancient time signatures}. +@item @ref{Ancient note heads}, +@item @ref{Ancient accidentals}, +@item @ref{Ancient rests}, +@item @ref{Ancient clefs}, +@item @ref{Ancient flags}, +@item @ref{Ancient time signatures}. @end itemize -By manipulating such a grob property, the typographical appearance of -the affected graphical objects can be accommodated for a specific -notation flavor without the need for introducing any new notational -concept. +By manipulating these grob properties, the typographical appearance of a +specific type of notation can be accommodated without needing to introduce any +new notational concepts. In addition to the standard articulation signs described in -section @ref{Articulations and ornamentations}, specific -articulation signs for ancient notation are provided. +@ref{Articulations and ornamentations}, specific articulation signs for +Gregorian chant are provided. @itemize -@item -@ref{Ancient articulations} +@item @ref{Ancient articulations} @end itemize -Other aspects of ancient notation can not that easily be expressed -in terms of just changing a style property of a graphical object or -adding articulation signs. Some notational concepts are introduced -specifically for ancient notation, +Other aspects of ancient notation cannot be easily expressed by changing a +style property of a graphical object or by adding articulation signs. Some +notational concepts are introduced specifically for ancient notation, @itemize -@item -@ref{Custodes}, -@item -@ref{Divisiones}, -@item -@ref{Ligatures}. +@item @ref{Custodes}, +@item @ref{Divisiones}, +@item @ref{Ligatures}. @end itemize -If this all is too much of documentation for you, and you just want to -dive into typesetting without worrying too much about the details on -how to customize a context, you may have a look at the predefined -contexts. Use them to set up predefined style-specific voice and -staff contexts, and directly go ahead with the note entry, +To start typesetting without worrying too much about the details on how to +customize a context, there are predefined contexts for Gregorian chant and +mensural notation. They set up predefined style-specific voice and staff +contexts, and allow one to proceed directly with note entry: @itemize -@item -@ref{Gregorian Chant contexts}, -@item -@ref{Mensural contexts}. +@item @ref{Gregorian chant contexts}, +@item @ref{Mensural contexts}. @end itemize -There is limited support for figured bass notation which came -up during the baroque period. +There is limited support for figured bass notation from the Baroque period: @itemize -@item -@ref{Figured bass} +@item @ref{Figured bass} @end itemize @c Here are all subtopics at a glance: + @node Alternative note signs @subsection Alternative note signs @menu -* Ancient note heads:: -* Ancient accidentals:: -* Ancient rests:: -* Ancient clefs:: -* Ancient flags:: -* Ancient time signatures:: +* Ancient note heads:: +* Ancient accidentals:: +* Ancient rests:: +* Ancient clefs:: +* Ancient flags:: +* Ancient time signatures:: @end menu @node Ancient note heads @@ -234,7 +220,6 @@ Internals Reference: @rinternals{KeySignature}. @cindex rests, ancient - Use the @code{style} property of grob @rinternals{Rest} to select ancient rests. Supported styles are @code{classical}, @code{neomensural}, and @code{mensural}. @code{classical} differs @@ -256,7 +241,7 @@ There are no 32th and 64th rests specifically for the mensural or neo-mensural style. Instead, the rests from the default style will be taken. See @c @lsr{pitches,rests} for a chart of all rests. -There are no rests in Gregorian Chant notation; instead, it uses +There are no rests in Gregorian chant notation; instead, it uses @ref{Divisiones}. @seealso @@ -270,7 +255,6 @@ rests. @cindex clefs - LilyPond supports a variety of clefs, many of them ancient. The following table shows all ancient clefs that are supported via the @@ -503,13 +487,11 @@ Notation Reference: see @ref{Clef}. The mensural g clef is mapped to the Petrucci g clef. - @node Ancient flags @subsubsection Ancient flags @cindex flags - Use the @code{flag-style} property of grob @rinternals{Stem} to select ancient flags. Besides the @code{default} flag style, only the @code{mensural} style is supported @@ -529,7 +511,11 @@ vertically aligned with a staff line. There is no particular flag style for neo-mensural notation. Hence, when typesetting the incipit of a transcribed piece of mensural music, the default flag style should be used. There are no flags in -Gregorian Chant notation. +Gregorian chant notation. + +@seealso + +TODO: nothing here yet ... @knownissues @@ -660,12 +646,12 @@ addressable with @code{\time}. Use a @code{\markup} instead @subsection Additional note signs @menu -* Ancient articulations:: -* Custodes:: -* Divisiones:: -* Ligatures:: -* White mensural ligatures:: -* Gregorian square neumes ligatures:: +* Ancient articulations:: +* Custodes:: +* Divisiones:: +* Ligatures:: +* White mensural ligatures:: +* Gregorian square neumes ligatures:: @end menu @@ -695,6 +681,10 @@ designed for use with notation in Editio Vaticana style. } @end lilypond +@seealso + +TODO: nothing here yet ... + @knownissues Some articulations are vertically placed too closely to the @@ -703,6 +693,7 @@ corresponding note heads. The episem line is not displayed in many cases. If it is displayed, the right end of the episem line is often too far to the right. + @node Custodes @subsubsection Custodes @@ -799,7 +790,6 @@ 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@/-init@/.ly}. It contains definitions that you can apply by just inserting @code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima}, @@ -865,7 +855,9 @@ has to be added to the @rinternals{Voice} context, as explained in the following subsections. Only white mensural ligatures are supported with certain limitations. +@seealso +TODO: nothing here yet ... @knownissues @@ -892,6 +884,7 @@ with the same effect and is believed to be stable. * Gregorian square neumes ligatures:: @end menu + @node White mensural ligatures @subsubsection White mensural ligatures @@ -977,10 +970,15 @@ to the following } @end lilypond +@seealso + +TODO: nothing here yet ... + @knownissues Horizontal spacing is poor. + @node Gregorian square neumes ligatures @subsubsection Gregorian square neumes ligatures @@ -1515,7 +1513,6 @@ Deminutae} @end multitable - Unlike most other neumes notation systems, the input language for neumes does not reflect the typographical appearance, but is designed to focus on musical meaning. For example, @code{\[ a \pes b @@ -1922,6 +1919,10 @@ respectively. @funindex \augmentum Use the unary music function @code{\augmentum} to add augmentum dots. +@seealso + +TODO: nothing here yet ... + @knownissues When an @code{\augmentum} dot appears at the end of the last staff @@ -1938,20 +1939,20 @@ with head prefixes in arbitrary order. @subsection Pre-defined contexts @menu -* Gregorian Chant contexts:: -* Mensural contexts:: +* Gregorian chant contexts:: +* Mensural contexts:: @end menu -@node Gregorian Chant contexts -@subsubsection Gregorian Chant contexts +@node Gregorian chant contexts +@subsubsection Gregorian chant contexts @cindex VaticanaVoiceContext @cindex VaticanaStaffContext The predefined @code{VaticanaVoiceContext} and @code{VaticanaStaffContext} can be used to engrave a piece of -Gregorian Chant in the style of the Editio Vaticana. These contexts +Gregorian chant in the style of the Editio Vaticana. These contexts initialize all relevant context properties and grob properties to proper values, so you can immediately go ahead entering the chant, as the following excerpt demonstrates @@ -1976,6 +1977,9 @@ the following excerpt demonstrates } @end lilypond +@seealso + +TODO: nothing here yet ... @node Mensural contexts @subsubsection Mensural contexts @@ -2010,14 +2014,19 @@ demonstrates } @end lilypond +@seealso + +TODO: nothing here yet ... + + @node Transcribing ancient music @subsection Transcribing ancient music @menu -* Ancient and modern from one source:: -* Incipits:: -* Mensurstriche layout:: -* Transcribing Gregorian chant:: +* Ancient and modern from one source:: +* Incipits:: +* Mensurstriche layout:: +* Transcribing Gregorian chant:: @end menu @@ -2028,6 +2037,10 @@ demonstrates @c Here among others the snippets about reducing note length TBC +@seealso + +@c ... and reference to other sections ... + @node Incipits @subsubsection Incipits @@ -2035,9 +2048,11 @@ TBC @c TODO Add text @c clefs, mensuration signs etc from lsr and -user @c use snippet Transcription-of-ancient-music-with-incipit - TBC +@seealso + +@c ... and reference to other sections ... @node Mensurstriche layout @subsubsection Mensurstriche layout @@ -2046,6 +2061,10 @@ TBC @c from lsr and -user TBC +@seealso + +@c ... and reference to other sections ... + @node Transcribing Gregorian chant @subsubsection Transcribing Gregorian chant @@ -2054,13 +2073,17 @@ TBC @c extract from 1.6.1.1 TBC +@seealso + +@c ... and reference to other sections ... + @node Editorial markings @subsection Editorial markings @menu -* Annotational accidentals:: -* Baroque rhythmic notation:: +* Annotational accidentals:: +* Baroque rhythmic notation:: @end menu @@ -2069,7 +2092,7 @@ TBC In European music from before about 1600, singers were often expected to chromatically alter notes at their own initiative. -This is called @q{Musica Ficta}. In modern transcriptions, these +This is called @notation{musica ficta}. In modern transcriptions, these accidentals are usually printed over the note. @cindex Accidental, musica ficta @@ -2121,3 +2144,7 @@ the @rinternals{AccidentalSuggestion} object. TBC + +@seealso + +@c ... and reference to other sections ... -- 2.39.2