more comments in files.

diff --git a/input/test/add-staccato.ly b/input/test/add-staccato.ly
index 1170be9ef4f4d6a0af712e9ae124c2bb295bbf1c..0763a324c57fcefa5f3f2483b1e0baa3af44c78c 100644 (file)
--- a/input/test/add-staccato.ly
+++ b/input/test/add-staccato.ly
@@ -1,12 +1,12 @@
 \version "1.7.18"  %% or actually: 1.7.1 ...
-% TODO: doesn't work with 1.7.19.  Check with more recent version.
+% FIXME: doesn't work with 1.7.19.  Check with more recent version.
 \header {
 
 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."
-
+one would not use scm constructs.  See separate-staccato.ly first.
+"
 } 
 
 #(define (make-script x)

diff --git a/input/test/bar-number-every-five-reset.ly b/input/test/bar-number-every-five-reset.ly
index 2a68dd0c71c28708419995561d1a4cca3bb3249e..28d7f57131c32302bce14ae3e1172f1db3c2609a 100644 (file)
--- a/input/test/bar-number-every-five-reset.ly
+++ b/input/test/bar-number-every-five-reset.ly
@@ -1,6 +1,4 @@
 \version "1.7.18"
-% renamed file to bar-number-every-five-reset.ly from bar-number-every-5-reset.ly
-% so that bar-number-every-fifth.ly will appear before this file.
 
 \header {
     texidoc = "@cindex Bar Number Every Fifth Reset

diff --git a/input/test/bar-number-show-all.ly b/input/test/bar-number-show-all.ly
index ecc4184d6b99c3cb7b91c15b1bdd66e9bbc6a182..f88fec286f6c3ba8fa6861d6a072aa04134cba26 100644 (file)
--- a/input/test/bar-number-show-all.ly
+++ b/input/test/bar-number-show-all.ly
@@ -1,6 +1,4 @@
 \version "1.7.18"
-% renamed file to bar-number-show-all.ly from bar-script-visibility.ly
-% for greater clarity
 \header{
     texidoc="@cindex Bar Number Show All
 Second line has bar numbers on start of every measure.

diff --git a/input/test/beam-control.ly b/input/test/beam-control.ly
index 47d5a5afeaf50e294a1b6ffd3ad47f2e39dc9bae..3247dc4cee578196cd787a24baff37a63e311434 100644 (file)
--- a/input/test/beam-control.ly
+++ b/input/test/beam-control.ly
@@ -1,6 +1,7 @@
 \version "1.7.18"
+% similiar to beam-position, but keep this one.
 \header{
-    texidoc="@cindex Beam Control
+    texidoc="@cindex Beam Position Control
 Controlling beam positions.
 " }
 \score { 

diff --git a/input/test/beam-damp.ly b/input/test/beam-damp.ly
index d6dbc7729e8be166c76b3abc6b22ffeea3c70463..96f012af9530cdff117ab6adec5b536142cc7191 100644 (file)
--- a/input/test/beam-damp.ly
+++ b/input/test/beam-damp.ly
@@ -1,5 +1,10 @@
 \header {
-% this example doesn't look very useful.  delete it?
+% this example doesn't look very useful.  Perhaps remove it in
+% the future, although it _does_ demonstrate a neat feature of
+% lilypond.  Maybe regression?  Or a "neat features" page
+% (one of the intro pages, maybe?)
+% OTOH, this is probably a basic lesson for engraving music,
+% so it might not be worth advertising it.  :)
 texidoc = "@cindex Beam Damp
 Beams are less steep than the notes they encompass.
 " }

diff --git a/input/test/beam-neutral-direction.ly b/input/test/beam-neutral-direction.ly
index 522c2a2da954f353f4d5981badb1da414f39d8c1..e1bfdc5012034577e23c214d5bb1f54cf8e26235 100644 (file)
--- a/input/test/beam-neutral-direction.ly
+++ b/input/test/beam-neutral-direction.ly
@@ -1,6 +1,6 @@
 \version "1.7.18"
 \header{
-       texinfo="@cindex Beam Neutral Direction
+       texidoc="@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.

diff --git a/input/test/beam-stem-test.ly b/input/test/beam-stem-test.ly
index ba861f2701657a32f7adf44e5d550f7233f2d50a..b6c96bf54295c2747fc363b07fabda87ebe037d9 100644 (file)
--- a/input/test/beam-stem-test.ly
+++ b/input/test/beam-stem-test.ly
@@ -1,4 +1,6 @@
 \version "1.7.18"
+%  I'm not certain this is useful.  Candidate for
+%  future remove-ing.
 \header {
   texidoc="@cindex Beam Stem Test
 Beam-stem attachment test.  Helper file for ps/dvips problems.

diff --git a/input/test/beamed-slur-endings.ly b/input/test/beamed-slur-endings.ly
index 34f969ffd580108cf31846bcbe58a3d8d2b567b7..db391d0ab4e392c2c8376cc703f80a15836f09bb 100644 (file)
--- a/input/test/beamed-slur-endings.ly
+++ b/input/test/beamed-slur-endings.ly
@@ -1,6 +1,8 @@
 \version "1.7.18"
 % this looks like an example of slurs, not beaming.  But we
-% already have lots of examples of slurs.  delete it?
+% already have lots of examples of slurs.  candidate for
+% future remove-ing.
+% rename to slur-something.
 \score{
        \notes \relative c''{
                \slurUp c8-(-( c-)-( c4-)-)

diff --git a/input/test/boxed-molecule.ly b/input/test/boxed-molecule.ly
index 8717929d9b256cfee6bdcfe8011d445369c1c9c1..283cd653c7b8232c061b5dcbf09f97bc04b30658 100644 (file)
--- a/input/test/boxed-molecule.ly
+++ b/input/test/boxed-molecule.ly
@@ -1,5 +1,5 @@
 \version "1.7.18"
-% TODO: check that this file actually works.
+% FIXME: check that this file actually works.
 \header {
 texidoc = "@cindex Boxed Molecule
 You can override the molecule callback to draw a box around

diff --git a/input/test/broken.ly b/input/test/broken.ly
index 97e1c624f4d279313cff82494ef4adec9a6ee09d..4ad766eba3708492e487c5e1c57ff0e2ef92571e 100644 (file)
--- a/input/test/broken.ly
+++ b/input/test/broken.ly
@@ -1,5 +1,5 @@
 \version "1.7.18"
-% TODO: move to regression or delete?
+% TODO: move to regression or remove?
 \header{
 enteredby =     "jcn"
 copyright =     "PD"

diff --git a/input/test/cautionaries.ly b/input/test/cautionaries.ly
index a164079dc26e98921871babb0f4d82daa1be8112..4a481080d9fe0c7c26580a40c0fefeee04a932d9 100644 (file)
--- a/input/test/cautionaries.ly
+++ b/input/test/cautionaries.ly
@@ -1,6 +1,6 @@
 \version "1.7.18"
 \header{
-       texinfo="@cindex Cautionary Accidentals
+       texidoc="@cindex Cautionary Accidentals
 Lilypond can display cautionary accidentals in different ways.
 " }
 \score { \notes \context Staff \transpose c c'' {

diff --git a/input/test/clef-8-syntax.ly b/input/test/clef-8-syntax.ly
index 861b70e57f0e4c6e2352f39d91efaa3c7b4e849e..b5f3e7c3cd9787ac141c2f258ad166b40c2f8379 100644 (file)
--- a/input/test/clef-8-syntax.ly
+++ b/input/test/clef-8-syntax.ly
@@ -8,7 +8,8 @@ name needs to be in quotes (such as \"treble^8\").
 
 \score { 
   \context Voice \notes\relative c {
-  \clef "bass_8" c4
+  \clef "bass_8" c4 c c c |
+  \clef "treble^8" c'''4 c''' c''' c''' |
   }
   \paper {
     raggedright = ##t

diff --git a/input/test/coda-kludge.ly b/input/test/coda-kludge.ly
index 36378c6b25b9ecf9f5e78a5b79c2e7b0c841e950..1cc1627b3a151d4db57634a3a81a34d2bbe152b7 100644 (file)
--- a/input/test/coda-kludge.ly
+++ b/input/test/coda-kludge.ly
@@ -1,8 +1,8 @@
 \version "1.7.18"
-% TODO: rethink name and whole file -- possible deletion or major
+% TODO: rethink name and whole file -- possible remove or major
 % changes.
 \header{
-       texinfo="@cindex Coda Kludge"
+       texidoc="@cindex Coda Kludge"
 }
 %{
 Hi,

diff --git a/input/test/crescendi.ly b/input/test/crescendi.ly
index 35a224794ca8fbae07658e25247048a3e8458945..4ec8f16c9368c26917740f71f893577b47f33335 100644 (file)
--- a/input/test/crescendi.ly
+++ b/input/test/crescendi.ly
@@ -1,6 +1,6 @@
 \version "1.7.18"
 \header{
-       texinfo="@cindex Crescendi
+       texidoc="@cindex Crescendi
 Lilypond can print crescendi in a number of different ways.
 " }
 \score{

diff --git a/input/test/cue-notes.ly b/input/test/cue-notes.ly
index 439bd12a2b367b5f8f87c9cf00e77f99b28b2fae..0f46cb31f99094e25608cc4fd102b2499ff85226 100644 (file)
--- a/input/test/cue-notes.ly
+++ b/input/test/cue-notes.ly
@@ -32,8 +32,10 @@ usually not restored explicitly.
           #(lambda (beam mult) (* 0.8 (Beam::space_function beam mult)))
 
        r8^"Bsn." c'8  f'8-[ f'8]
-       \property Staff.fontSize\unset
-       \property Staff . Clef = \turnOff
+% FIXME: check to see if clef should be cancelled from the cue.  IIRC
+% it should be, but I could be wrong.
+%       \property Staff.fontSize\unset
+%       \property Staff . Clef = \turnOff
        \clef treble
      } >
    c'8^"Horn" cis'