X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fnotation%2Fancient.itely;h=381621ffd82235654965c0b05ba43a3aca1e92b1;hb=e49f1106712fdabe8e0cee8f7b3cb75c48886a52;hp=e4ded2fa4f88b7a93582d05e085085e49e6b43d0;hpb=dc7cc1e2d4f48c4051de6394a3975b835552cc5d;p=lilypond.git

diff --git a/Documentation/notation/ancient.itely b/Documentation/notation/ancient.itely
index e4ded2fa4f..381621ffd8 100644
--- a/Documentation/notation/ancient.itely
+++ b/Documentation/notation/ancient.itely
@@ -536,7 +536,8 @@ The mensural g clef is mapped to the Petrucci g clef.
 @unnumberedsubsubsec Mensural time signatures
 
 @cindex mensuration sign
-@cindex time signatures
+@cindex time signature, mensural
+@cindex time signature style
 
 There is limited support for mensuration signs (which are similar to,
 but not exactly the same as time signatures).  The glyphs are hard-wired
@@ -2646,11 +2647,43 @@ same source.
 
 @node Incipits
 @unnumberedsubsubsec Incipits
+@funindex \incipit
+@funindex incipit
+@cindex incipits, adding
+
+It is customary when transcribing mensural music into modern notation to place
+an indication of how the initial rests and note or notes of the original version
+appeared - including the original clefs.  This is called an @emph{incipit}.  The
+@code{\incipit} command uses the @code{indent} of the main staff to set the
+width occupied by the incipit, and @code{incipit-width} to set the width of the
+incipit staff.
+
+@lilypond[verbatim,quote,ragged-right]
+\score {
+  \new Staff <<
+    \new Voice = Tenor {
+      \set Staff.instrumentName = #"Tenor"
+      \override Staff.InstrumentName.self-alignment-X = #RIGHT
+      \incipit { \clef "mensural-c4" \key f \major r\breve r1 c'1 }
+      \clef "treble_8"
+      \key f \major
+      R1 r2 c'2 |
+      a4. c'8
+    }
+    \new Lyrics \lyricsto Tenor { Cyn -- thia your }
+  >>
+  \layout
+  {
+    indent = 5\cm
+    incipit-width = 3\cm
+  }
+}
+@end lilypond
 
-@c TODO Add text
-@c clefs, mensuration signs etc from lsr and -user
-@c use snippet Transcription-of-ancient-music-with-incipit
-TBC
+@knownissues
+Note that instrumentName must be set in the music for the incipit to be
+produced.  If no instrument name is required then use
+@code{\set Staff.instrumentName = #""}.
 
 @c @seealso
 @c ... and reference to other sections ...