First half of Kurt's update.

diff --git a/Documentation/user/ancient.itely b/Documentation/user/ancient.itely
index b314edef96e9b0833b99f06a12959e15d9d81504..db88828dad23fdffc5ed6d374d280ba913efaad0 100644 (file)
--- 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 ...