From c97a11c1355fd2caaf261bf82254e9beb59f5628 Mon Sep 17 00:00:00 2001
From: Graham Percival <graham@percival-music.ca>
Date: Wed, 28 May 2003 14:06:15 +0000
Subject: [PATCH] *.ly:  Added a newline at the end of the texinfo doc string
 (produces better output in HTML version). c*.ly:  Added texinfo index and
 added comments to aid in future changes to input/test/ files.

---
 ChangeLog                               |  9 ++++++++-
 input/test/absolute-volume.ly           |  3 ++-
 input/test/add-staccato.ly              |  3 ++-
 input/test/add-text-script.ly           |  3 ++-
 input/test/ancient-accidentals.ly       |  3 ++-
 input/test/ancient-font.ly              |  5 ++++-
 input/test/ancient-time.ly              |  7 +++++--
 input/test/auto-beam-4-8.ly             |  3 ++-
 input/test/auto-beam.ly                 |  3 ++-
 input/test/bagpipe.ly                   |  3 ++-
 input/test/bar-lines-lyric-only.ly      |  3 ++-
 input/test/bar-lines.ly                 |  5 ++---
 input/test/bar-number-every-fifth.ly    |  5 ++---
 input/test/bar-number-show-all.ly       |  4 ++--
 input/test/beam-control.ly              |  4 ++--
 input/test/beam-count.ly                |  4 ++--
 input/test/beam-damp.ly                 |  4 ++--
 input/test/beam-isknee.ly               |  4 ++--
 input/test/beam-neutral-direction.ly    |  4 ++--
 input/test/beam-rest.ly                 |  4 ++--
 input/test/beam-stem-test.ly            |  4 ++--
 input/test/blank-notes.ly               |  4 ++--
 input/test/blank.ly                     |  4 ++--
 input/test/boxed-molecule.ly            |  6 +++---
 input/test/broken-spanner-adjustment.ly |  4 +---
 input/test/broken-thread-line.ly        |  4 ++--
 input/test/broken.ly                    |  2 +-
 input/test/caps.ly                      |  6 +++---
 input/test/cautionaries.ly              | 17 +++++++++--------
 input/test/chord-markup.ly              |  5 +++--
 input/test/chord-names-dpnj.ly          |  1 +
 input/test/chord-names-german.ly        | 10 ++++------
 input/test/chord-names-jazz.ly          |  1 +
 input/test/chords.ly                    |  2 +-
 input/test/clef-8-syntax.ly             | 11 +++++------
 input/test/clef-end-of-line.ly          |  7 +++----
 input/test/coda-kludge.ly               |  9 +++++----
 input/test/coriolan-margin.ly           |  6 ++++--
 input/test/count-systems.ly             | 10 +++++-----
 input/test/crescendi.ly                 |  5 ++++-
 input/test/crescendo-text.ly            |  2 +-
 input/test/cue-notes.ly                 | 10 ++++++----
 42 files changed, 119 insertions(+), 94 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f754503e66..54c6a7716f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,4 +1,11 @@
-2003-05-28  Graham Percival <gperlist@shaw.ca>
+2003-05-28  Graham Percival  <gperlist@shaw.ca>
+	* input/sondag-morgen/*: removed due to copyright concerns.
+	* input/[a,b]*.ly: added a newline at the end of the texinfo
+	doc string (produces better output in HTML version).
+	* input/c*.ly: added texinfo index and added comments to
+	aid in future changes to input/test/ files.
+
+2003-05-28  Graham Percival  <gperlist@shaw.ca>
    * Documentation/user/refman.itely: fixed build problem (missing
    file) caused by previous renaming.
 
diff --git a/input/test/absolute-volume.ly b/input/test/absolute-volume.ly
index 890fa0cd5e..258ef3fe75 100644
--- a/input/test/absolute-volume.ly
+++ b/input/test/absolute-volume.ly
@@ -1,6 +1,7 @@
 \header {
     texidoc = "@cindex Absolute dynamics
-Absolute dynamics have effect in MIDI files."
+Absolute dynamics have effect in MIDI files.
+"
 }
 
 \version "1.7.18"
diff --git a/input/test/add-staccato.ly b/input/test/add-staccato.ly
index 993d32fb5d..1170be9ef4 100644
--- a/input/test/add-staccato.ly
+++ b/input/test/add-staccato.ly
@@ -2,7 +2,8 @@
 % TODO: doesn't work with 1.7.19.  Check with more recent version.
 \header {
 
-texidoc= "Using make-music, you can add various stuff to notes. Here
+texidoc= "@cindex Add Stacato
+Using make-music, you can add various stuff to notes. Here
 is an example how to add staccato dots.  Note: for this simple case
 one would not use scm constructs.  See separate-staccato.ly first."
 
diff --git a/input/test/add-text-script.ly b/input/test/add-text-script.ly
index 04d890f1cc..a9c6639c78 100644
--- a/input/test/add-text-script.ly
+++ b/input/test/add-text-script.ly
@@ -5,7 +5,8 @@ You can add various stuff to notes using make-music.
 Here is an example of how to add an extra fingering. 
 
 In general, first do a display of the music you want to
-create, then write a function that will build the structure for you."
+create, then write a function that will build the structure for you.
+"
 } 
 
 #(define (make-text-script x) 
diff --git a/input/test/ancient-accidentals.ly b/input/test/ancient-accidentals.ly
index 3561c99d1b..9f1456469b 100644
--- a/input/test/ancient-accidentals.ly
+++ b/input/test/ancient-accidentals.ly
@@ -1,7 +1,8 @@
 \header {
 texidoc = "@cindex Ancient Accidentals
 Accidentals are available in different ancient styles. This
-file lists all of them."
+file lists all of them.
+"
 }
 
 \version "1.7.18"
diff --git a/input/test/ancient-font.ly b/input/test/ancient-font.ly
index 88e9516904..d197f1fe57 100644
--- a/input/test/ancient-font.ly
+++ b/input/test/ancient-font.ly
@@ -1,10 +1,13 @@
 \version "1.7.19"
+% TODO: split ancient-font into seperate files; possibly in
+% different locations.
 \header {
     title	= "ancient font test"
     date	= "2002"
 texidoc = "@cindex Ancient Font
 Here is a display of many (all?) symbols that are
-included in Lilypond's support of ancient notation."
+included in Lilypond's support of ancient notation.
+"
 }
 
 \include "paper26.ly"
diff --git a/input/test/ancient-time.ly b/input/test/ancient-time.ly
index d5bcfcc5fd..f239973c01 100644
--- a/input/test/ancient-time.ly
+++ b/input/test/ancient-time.ly
@@ -1,7 +1,10 @@
 \version "1.7.18"
-% TODO: merge with ancient font?
+% TODO: move stuff from ancient-font into here?  See comment
+% for ancient-font.ly
 \header {
-texidoc="Should use old style."
+texidoc="@cindex Ancient Time Signatures
+Should use old style.
+"
 }
 
 \score {
diff --git a/input/test/auto-beam-4-8.ly b/input/test/auto-beam-4-8.ly
index 37af342cf5..fa1248e2ad 100644
--- a/input/test/auto-beam-4-8.ly
+++ b/input/test/auto-beam-4-8.ly
@@ -1,7 +1,8 @@
 \version "1.7.18"
 \header {
 	texidoc = "@cindex Auto Beaming 4/8
-You can override Lilypond's automatic beaming."
+You can override Lilypond's automatic beaming.
+"
 }
 
 \score{
diff --git a/input/test/auto-beam.ly b/input/test/auto-beam.ly
index d37c9ebcdc..afdcf83cdf 100644
--- a/input/test/auto-beam.ly
+++ b/input/test/auto-beam.ly
@@ -1,7 +1,8 @@
 \version "1.7.18"
 \header{
 	texidoc = "@cindex Beaming Presets
-The auto-beam engraver has presets for common time signatures."
+The auto-beam engraver has presets for common time signatures.
+"
 }
 \score{
     \notes \relative c''{
diff --git a/input/test/bagpipe.ly b/input/test/bagpipe.ly
index d8d7c1bf06..063d3fb387 100644
--- a/input/test/bagpipe.ly
+++ b/input/test/bagpipe.ly
@@ -3,7 +3,8 @@
 \header {
  title="Flower of Scotland"
  texidoc = "@cindex Bagpipe Music
-bagpipe music"
+Here's an example of bagpipe music.
+"
 }
 
 #(add-to-grace-init "Voice" 'Stem 'length 6)
diff --git a/input/test/bar-lines-lyric-only.ly b/input/test/bar-lines-lyric-only.ly
index 5a9c34f566..a501547564 100644
--- a/input/test/bar-lines-lyric-only.ly
+++ b/input/test/bar-lines-lyric-only.ly
@@ -3,7 +3,8 @@
 
 texidoc = "@cindex Bar Line Lyric Only
 You can move around Bar_engraver and
-Span_bar_engraver if you want bar lines on lyrics."  }
+Span_bar_engraver if you want bar lines on lyrics.
+"  }
 
 
 \score {
diff --git a/input/test/bar-lines.ly b/input/test/bar-lines.ly
index bc917bdb21..c917ef06a5 100644
--- a/input/test/bar-lines.ly
+++ b/input/test/bar-lines.ly
@@ -1,9 +1,8 @@
 \version "1.7.18"
 \header {
     texidoc = "@cindex Bar Lines
-Different types of bar lines demonstrated."
-}
-
+Different types of bar lines demonstrated.
+" }
 
 \score
 {
diff --git a/input/test/bar-number-every-fifth.ly b/input/test/bar-number-every-fifth.ly
index 7ffec5e1aa..45349de57b 100644
--- a/input/test/bar-number-every-fifth.ly
+++ b/input/test/bar-number-every-fifth.ly
@@ -1,8 +1,7 @@
 \header {
     texidoc = "@cindex Bar Number Every Fifth
-Bar numbers can also be printed at regular intervals."
-
-}
+Bar numbers can also be printed at regular intervals.
+" }
 \version "1.7.18"
 
 \score {
diff --git a/input/test/bar-number-show-all.ly b/input/test/bar-number-show-all.ly
index d0f0176ac1..ecc4184d6b 100644
--- a/input/test/bar-number-show-all.ly
+++ b/input/test/bar-number-show-all.ly
@@ -3,8 +3,8 @@
 % for greater clarity
 \header{
     texidoc="@cindex Bar Number Show All
-Second line has bar numbers on start of every measure."
-}
+Second line has bar numbers on start of every measure.
+" }
 
 \score{
     \notes\relative c'{
diff --git a/input/test/beam-control.ly b/input/test/beam-control.ly
index 82d73ebdf7..47d5a5afea 100644
--- a/input/test/beam-control.ly
+++ b/input/test/beam-control.ly
@@ -1,8 +1,8 @@
 \version "1.7.18"
 \header{
     texidoc="@cindex Beam Control
-Controlling beam positions."
-}
+Controlling beam positions.
+" }
 \score { 
     \context Voice \notes\relative c {
 	%% from upper staffline (position 4) to centre (position 0)
diff --git a/input/test/beam-count.ly b/input/test/beam-count.ly
index e3d227c199..b6348d54e4 100644
--- a/input/test/beam-count.ly
+++ b/input/test/beam-count.ly
@@ -2,8 +2,8 @@
 \header{
 	texidoc="@cindex Beam Count
 You can alter the number of stems in a beam.  Here we see
-two sets of four 32nds joined as if they were 8th notes."
-}
+two sets of four 32nds joined as if they were 8th notes.
+" }
 
 fragment = \notes {
   f'32 g a b b a g f
diff --git a/input/test/beam-damp.ly b/input/test/beam-damp.ly
index a66afd6057..d6dbc7729e 100644
--- a/input/test/beam-damp.ly
+++ b/input/test/beam-damp.ly
@@ -1,8 +1,8 @@
 \header {
 % this example doesn't look very useful.  delete it?
 texidoc = "@cindex Beam Damp
-Beams are less steep than the notes they encompass. "
-}
+Beams are less steep than the notes they encompass.
+" }
 
 \version "1.7.18"
 \score{
diff --git a/input/test/beam-isknee.ly b/input/test/beam-isknee.ly
index ab5294f816..1af618998b 100644
--- a/input/test/beam-isknee.ly
+++ b/input/test/beam-isknee.ly
@@ -1,8 +1,8 @@
 \version "1.7.18"
 \header{
 	texidoc="@cindex Beam Isknee
-Lilypond can beam across a Piano Staff."
-}
+Lilypond can beam across a Piano Staff.
+" }
 \score{
 	\context PianoStaff <
 	\context Staff=one \notes\relative c'{
diff --git a/input/test/beam-neutral-direction.ly b/input/test/beam-neutral-direction.ly
index 37b2ee2392..522c2a2da9 100644
--- a/input/test/beam-neutral-direction.ly
+++ b/input/test/beam-neutral-direction.ly
@@ -3,8 +3,8 @@
 	texinfo="@cindex Beam Neutral Direction
 When a beam falls in the middle of the staff, Lilypond normally
 prints the beam pointing down.  However, this behaviour can be
-altered if desired."
-}
+altered if desired.
+" }
 
 fragment = \notes {
    b''8-[ b]
diff --git a/input/test/beam-rest.ly b/input/test/beam-rest.ly
index d2628a0fda..d5fcc0bb55 100644
--- a/input/test/beam-rest.ly
+++ b/input/test/beam-rest.ly
@@ -2,8 +2,8 @@
 
 \header{
 texidoc="@cindex Beam Over Rests
-Beams over rests."
-}
+Beams over rests.
+" }
 
 \score{
         \context Staff=one \notes\relative c''{
diff --git a/input/test/beam-stem-test.ly b/input/test/beam-stem-test.ly
index 41754ef59d..ba861f2701 100644
--- a/input/test/beam-stem-test.ly
+++ b/input/test/beam-stem-test.ly
@@ -1,8 +1,8 @@
 \version "1.7.18"
 \header {
   texidoc="@cindex Beam Stem Test
-Beam-stem attachment test.  Helper file for ps/dvips problems."
-}
+Beam-stem attachment test.  Helper file for ps/dvips problems.
+" }
 	
 \score {
   \context RhythmicStaff \notes {
diff --git a/input/test/blank-notes.ly b/input/test/blank-notes.ly
index 4e48d15623..0136905cb6 100644
--- a/input/test/blank-notes.ly
+++ b/input/test/blank-notes.ly
@@ -9,8 +9,8 @@
 You can suppress printing of Lilypond output.  This example shows you how to
 print invisible (or blank) notes.  This can be very useful when you want to
 do wierd tricks with Lilypond (especially with slurs, since you can't attach
-a slur to a rest or spacer rest)."
-}
+a slur to a rest or spacer rest).
+" }
 
 blanknotes = { \property Voice.NoteHead
 	       \override #'transparent  = ##t
diff --git a/input/test/blank.ly b/input/test/blank.ly
index 984ecae582..4320b3d001 100644
--- a/input/test/blank.ly
+++ b/input/test/blank.ly
@@ -1,8 +1,8 @@
 \version "1.7.18"
 \header {
   texidoc="@cindex Blank Paper
-Blank music paper with clefs"
-}
+Blank music paper with clefs.
+" }
 \score {
   \notes {
     % \clef violin
diff --git a/input/test/boxed-molecule.ly b/input/test/boxed-molecule.ly
index 74f9490b06..8717929d9b 100644
--- a/input/test/boxed-molecule.ly
+++ b/input/test/boxed-molecule.ly
@@ -1,12 +1,12 @@
 \version "1.7.18"
+% TODO: check that this file actually works.
 \header {
 texidoc = "@cindex Boxed Molecule
 You can override the molecule callback to draw a box around
 arbitrary grobs.
 
-TODO:  circled molecules."
-% TODO: check that this one actually works.
-}
+TODO:  circled molecules.
+" }
 
 
  \score { \notes \relative c''  {
diff --git a/input/test/broken-spanner-adjustment.ly b/input/test/broken-spanner-adjustment.ly
index 1d49279663..b059e3d1e9 100644
--- a/input/test/broken-spanner-adjustment.ly
+++ b/input/test/broken-spanner-adjustment.ly
@@ -4,9 +4,7 @@
 	 texidoc = "@cindex Broken Spanner Adjustment
 Broken spanners can be adjusted individually, but
 this requires complicated scheme code.
-  "
-
-}
+" }
 
 #(define (my-callback grob)
   (let* (
diff --git a/input/test/broken-thread-line.ly b/input/test/broken-thread-line.ly
index c0bb3e4f27..f952ac31c4 100644
--- a/input/test/broken-thread-line.ly
+++ b/input/test/broken-thread-line.ly
@@ -3,8 +3,8 @@
 % followvoice examples in input/test
 \header{
 	texidoc = "@cindex Piano followVoice
-followVoice: connect note heads with line when thread switches staff."
-}
+followVoice: connect note heads with line when thread switches staff.
+" }
 \score{
     \context PianoStaff <
         \context Staff=one \notes\relative c''{
diff --git a/input/test/broken.ly b/input/test/broken.ly
index b828638f8c..97e1c624f4 100644
--- a/input/test/broken.ly
+++ b/input/test/broken.ly
@@ -1,5 +1,5 @@
 \version "1.7.18"
-% TODO: move to regression?
+% TODO: move to regression or delete?
 \header{
 enteredby = 	 "jcn"
 copyright = 	 "PD"
diff --git a/input/test/caps.ly b/input/test/caps.ly
index 7f3eb62bc0..e2d6703cfe 100644
--- a/input/test/caps.ly
+++ b/input/test/caps.ly
@@ -1,8 +1,8 @@
 \version "1.7.18"
 \header {
-texidoc =  " Small caps is available as font-shape caps.
-
-	" }
+texidoc =  "@cindex Capital Letters
+You can set the font to use small caps.
+" }
 shapeSC   = \property Lyrics.LyricText \override #'font-shape = #'caps
  shapeNorm = \property Lyrics.LyricText \revert   #'font-shape
 
diff --git a/input/test/cautionaries.ly b/input/test/cautionaries.ly
index 216502774c..a164079dc2 100644
--- a/input/test/cautionaries.ly
+++ b/input/test/cautionaries.ly
@@ -1,16 +1,17 @@
 \version "1.7.18"
-
-%% FIXME
-
+\header{
+	texinfo="@cindex Cautionary Accidentals
+Lilypond can display cautionary accidentals in different ways.
+" }
 \score { \notes \context Staff \transpose c c'' {
   \key d \major
 %  \property Staff.autoReminders = #'cautionary
   \property Staff.Accidental \override #'font-relative-size = #0
-  <<dis c>>1 cis2 d
-%  \property Staff.Accidental \override #'cautionary-size = #-1
-  <<dis c>>1 cis2 d
-%  \property Staff.Accidental \override #'paren-cautionaries = ##f
-  <<dis c>>1 cis2 d
+  <<dis c>>1 cis?2 d?
+  \property Staff.Accidental \override #'cautionary-style = #'smaller
+  <<dis c>>1 cis?2 d?
+  \property Staff.Accidental \override #'cautionary-style = #'parentheses
+  <<dis c>>1 cis?2 d?
 
 }
 }
diff --git a/input/test/chord-markup.ly b/input/test/chord-markup.ly
index be26f9df91..2bd43dc42d 100644
--- a/input/test/chord-markup.ly
+++ b/input/test/chord-markup.ly
@@ -1,7 +1,8 @@
 \version "1.7.18"
 \header{
-    texidoc = "chord/markup test"
-}
+    texidoc = "@cindex Chord Markup
+chord/markup test.
+" }
 
 \paper{ raggedright = ##t }
 
diff --git a/input/test/chord-names-dpnj.ly b/input/test/chord-names-dpnj.ly
index d1d8e55d50..3d85dd7371 100644
--- a/input/test/chord-names-dpnj.ly
+++ b/input/test/chord-names-dpnj.ly
@@ -1,3 +1,4 @@
+% FIXME: currently doesn't do anything useful.  fix or delete.
 \header {
     texidoc = "Chord name scheme test -- double-plus-new-chord-name jazz"
 }
diff --git a/input/test/chord-names-german.ly b/input/test/chord-names-german.ly
index 0255925439..d14fa52493 100644
--- a/input/test/chord-names-german.ly
+++ b/input/test/chord-names-german.ly
@@ -1,11 +1,9 @@
-
 \version "1.7.18"
 \header  {
-
-    texidoc = "By setting @code{ChordNames.chordRootNamer}, the root
-of the chord may be named with a different function."
-
-}
+    texidoc = "@cindex Chord Names German
+By setting @code{ChordNames.chordRootNamer}, the root
+of the chord may be named with a different function.
+" }
 
 scm = \chords { c4/c cis/cis cisis/cisis ces/ces ceses/ceses b/b bis/bis bes/bes beses/beses } 
 \score {
diff --git a/input/test/chord-names-jazz.ly b/input/test/chord-names-jazz.ly
index a0966e5b20..97f4cea53a 100644
--- a/input/test/chord-names-jazz.ly
+++ b/input/test/chord-names-jazz.ly
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% FIXME: doesn't display anything useful.
 \header {
 texidoc = "Jazz notation for chord names.
 
diff --git a/input/test/chords.ly b/input/test/chords.ly
index 486a2035bd..0f725f6fb4 100644
--- a/input/test/chords.ly
+++ b/input/test/chords.ly
@@ -1,4 +1,4 @@
-
+% FIXME: doesn't display anything useful.
 \version "1.7.18"
 \score { \notes { c4^"fixme"}}
 
diff --git a/input/test/clef-8-syntax.ly b/input/test/clef-8-syntax.ly
index d2cb2abdd5..861b70e57f 100644
--- a/input/test/clef-8-syntax.ly
+++ b/input/test/clef-8-syntax.ly
@@ -1,11 +1,10 @@
 \version "1.7.18"
 \header {
-
-    texidoc = "Appending @code{_8} or @code{^8} to a clef name, will
-    add an octavation sign to the clef."
-
-}
-
+    texidoc = "@cindex Chord Octavation
+Appending @code{_8} or @code{^8} to a clef name will
+add an octavation sign to the clef, although the clef
+name needs to be in quotes (such as \"treble^8\").
+" }
 
 \score { 
   \context Voice \notes\relative c {
diff --git a/input/test/clef-end-of-line.ly b/input/test/clef-end-of-line.ly
index 1642b97da2..41a4d5e4e6 100644
--- a/input/test/clef-end-of-line.ly
+++ b/input/test/clef-end-of-line.ly
@@ -1,10 +1,9 @@
-
 \version "1.7.18"
 \header {
 
-    texidoc = "Scales, but with clef and key signature at the end of the line."
-
-}
+    texidoc = "@cindex Clef End of Line
+Scales, but with clef and key signature at the end of the line.
+" }
 
 \score {
     \notes \transpose c c' {
diff --git a/input/test/coda-kludge.ly b/input/test/coda-kludge.ly
index 3336e52a4d..36378c6b25 100644
--- a/input/test/coda-kludge.ly
+++ b/input/test/coda-kludge.ly
@@ -1,8 +1,9 @@
 \version "1.7.18"
-% The volta texts should read: 1-4  and  5
-% Not 1 and 2
-% (see 1.2.17)
-
+% TODO: rethink name and whole file -- possible deletion or major
+% changes.
+\header{
+	texinfo="@cindex Coda Kludge"
+}
 %{
 Hi,
 	I want to write some music that has the structure:
diff --git a/input/test/coriolan-margin.ly b/input/test/coriolan-margin.ly
index 0b15c0045c..1d4f8605eb 100644
--- a/input/test/coriolan-margin.ly
+++ b/input/test/coriolan-margin.ly
@@ -12,8 +12,10 @@
   enteredby = 	 "JCN"
 
 
-texidoc = "Demonstration of how to set up an orchestral score."  
-}
+texidoc = "@cindex Orchestra Score
+@cindex Coriolan Score
+Demonstration of how to set up an orchestral score (Bethoven's Coriolan overture).
+" }
 
 raisedFlat = \markup { \raise #0.4 \smaller \smaller \musicglyph #"accidentals--1"  }
 
diff --git a/input/test/count-systems.ly b/input/test/count-systems.ly
index e7b3d51bcf..16f08a31a7 100644
--- a/input/test/count-systems.ly
+++ b/input/test/count-systems.ly
@@ -1,11 +1,11 @@
 \version "1.7.18"
 \header{
     
-    texidoc="Display the number of systems, or the system number of a
-    Grob.  This can be most useful to assertain that a piece uses a
-    specified number of lines."
-    
-}
+    texidoc="@cindex Count Systems
+Display the number of systems, or the system number of a
+Grob.  This can be most useful to assertain that a piece uses a
+specified number of lines.
+" }
 
 #(define (display-systemno smob)
   (let* ((this-system (ly:get-system smob))
diff --git a/input/test/crescendi.ly b/input/test/crescendi.ly
index a224ef53e9..35a224794c 100644
--- a/input/test/crescendi.ly
+++ b/input/test/crescendi.ly
@@ -1,5 +1,8 @@
 \version "1.7.18"
-
+\header{
+	texinfo="@cindex Crescendi
+Lilypond can print crescendi in a number of different ways.
+" }
 \score{
 \notes\relative c''{
 a1\fff\> \!a-\pp
diff --git a/input/test/crescendo-text.ly b/input/test/crescendo-text.ly
index e08a684354..bea085fc8e 100644
--- a/input/test/crescendo-text.ly
+++ b/input/test/crescendo-text.ly
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% delete; covered by cresendi.ly
 
 fragment = \notes {
   \context Voice {
diff --git a/input/test/cue-notes.ly b/input/test/cue-notes.ly
index ed8634c3aa..439bd12a2b 100644
--- a/input/test/cue-notes.ly
+++ b/input/test/cue-notes.ly
@@ -1,10 +1,12 @@
 \version "1.7.18"
+% TODO: check to see if this example can be simplified using \small
+% or \tiny.
 \header {
 
-    texidoc = "Cue notes should be set in smaller type. Cue clefs are
-usually not restored explicitly."
-
-}
+    texidoc = "@cindex Cue Notes
+Cue notes should be set in smaller type.  Cue clefs are
+usually not restored explicitly.
+"  }
 
 
 \score {
-- 
2.39.5