Docs: NR Vocal music: Chants psalms and hymns

 - rework headings

 - first draft of References for chants and psalms

diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index 27f515a24f756f2ce23b87cf78e45772ad2f676a..3dc1dcedfb089d0162071f618b9c97bc954e3b42 100644 (file)
--- a/Documentation/notation/vocal.itely
+++ b/Documentation/notation/vocal.itely
@@ -26,7 +26,7 @@ that the lyrics will be aligned with the notes of their melody.
 * Songs::
 * Choral::
 * Opera and stage musicals::
-* Chants hymns and psalms::
+* Chants psalms and hymns::
 * Ancient vocal music::
 
 @end menu
@@ -1547,24 +1547,97 @@ note heads, as demonstrated in @ref{Special note heads}.
 TBC
 
 
-@node Chants hymns and psalms
-@subsection Chants hymns and psalms
+@node Chants psalms and hymns
+@subsection Chants psalms and hymns
+
+@cindex chants
+@cindex psalms
+@cindex hymns
+@cindex religious music
+
+The music and words for chants, psalms and hymns usually follow a
+well-established format in any particular church.  Although the
+formats may differ from church to church the type-setting problems
+which arise are broadly similar, and are covered in this section.
 
 @menu
-* References for chants hymns and psalms::
-* Partial measures::
-* Multiple syllables to a note::
-* Pointing::
+* References for chants and psalms::
+* Setting a chant::
+* Pointing a psalm::
+* Partial measures in hymn tunes::
 @end menu
 
-@node References for chants hymns and psalms
-@unnumberedsubsubsec References for chants hymns and psalms
+@node References for chants and psalms
+@unnumberedsubsubsec References for chants and psalms
+
+Typesetting Gregorian chant in various styles of ancient notation
+is described in @ref{Ancient notation}.
+
+Modern chant settings use modern notation with varying numbers of
+elements taken from ancient notation.  Some of the elements and
+methods to consider are these:
+
+@itemize
+
+@item
+Chants often use quarter notes without stems to indicate the pitch,
+with the rhythm being taken from the spoken rhythm of the words.  To
+remove the stem set the @code{transparent} property of the
+@code{Stem} grob to @code{#t}.  See
+@rlearning{Visibility and color of objects} and
+@ref{Visibility of objects}.  An alternative is set the
+@code{length} property to @code{0}.
+
+@item
+Chants usually omit the bar lines or use shortened or dotted bar
+lines to indicate pauses in the music.  To omit bar lines
+completely use @code{\cadenzaOn} or remove the @code{Bar_engraver}.
+See @ref{Unmetered music} and @ref{Modifying context plug-ins}.
+
+@item
+To use modified bar lines see the @emph{Bar lines} section in
+@ref{Bars}.  Alternatively, the correct Gregorian chant notation
+for pauses or rests in the music are described in @emph{Divisiones}
+in @ref{Typesetting Gregorian chant}.
+
+@item
+Chants usually omit the time signature and often omit the clef too.
+To omit these remove the @code{Time_signature_engraver} and
+@code{Clef_engraver} from the @code{Staff} context respectively.
+For details, see @ref{Modifying context plug-ins}.
+
+@end itemize
+
+@seealso
+Learning Manual:
+@rlearning{Visibility and color of objects}.
+
+Notation reference:
+@ref{Ancient notation},
+@ref{Visibility of objects},
+@ref{Bars},
+@ref{Unmetered music},
+@ref{Modifying context plug-ins},
+@ref{Typesetting Gregorian chant}.
+
+@node Setting a chant
+@unnumberedsubsubsec Setting a chant
+
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{chant-or-psalms-notation.ly}
+
+@c TODO add this snippet when available
+@c @l ilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@c {Ancient notation template -- modern transcription of gregorian music.ly}
+
+
+@node Pointing a psalm
+@unnumberedsubsubsec Pointing a psalm
 
-@c TODO Add text from lsr and -user
 TBC
 
-@node Partial measures
-@unnumberedsubsubsec Partial measures
+@node Partial measures in hymn tunes
+@unnumberedsubsubsec Partial measures in hymn tunes
 
 Hymn tunes frequently start and end every line of music with
 partial measures so that each line of music corresponds exactly
@@ -1576,16 +1649,6 @@ commands at the end of each line.
 {hymn-template.ly}
 
 
-@node Multiple syllables to a note
-@unnumberedsubsubsec Multiple syllables to a note
-
-TBC
-
-@node Pointing
-@unnumberedsubsubsec Pointing
-
-TBC
-
 @node Ancient vocal music
 @subsection Ancient vocal music