From fb2c8b7371998c06e0126b056a92c36ebe7b13cc Mon Sep 17 00:00:00 2001
From: gpercival <gpercival>
Date: Tue, 3 Jun 2003 15:41:11 +0000
Subject: [PATCH] more comments in files.

---
 input/test/add-staccato.ly                | 6 +++---
 input/test/bar-number-every-five-reset.ly | 2 --
 input/test/bar-number-show-all.ly         | 2 --
 input/test/beam-control.ly                | 3 ++-
 input/test/beam-damp.ly                   | 7 ++++++-
 input/test/beam-neutral-direction.ly      | 2 +-
 input/test/beam-stem-test.ly              | 2 ++
 input/test/beamed-slur-endings.ly         | 4 +++-
 input/test/boxed-molecule.ly              | 2 +-
 input/test/broken.ly                      | 2 +-
 input/test/cautionaries.ly                | 2 +-
 input/test/clef-8-syntax.ly               | 3 ++-
 input/test/coda-kludge.ly                 | 4 ++--
 input/test/crescendi.ly                   | 2 +-
 input/test/cue-notes.ly                   | 6 ++++--
 15 files changed, 29 insertions(+), 20 deletions(-)

diff --git a/input/test/add-staccato.ly b/input/test/add-staccato.ly
index 1170be9ef4..0763a324c5 100644
--- 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 2a68dd0c71..28d7f57131 100644
--- 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 ecc4184d6b..f88fec286f 100644
--- 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 47d5a5afea..3247dc4cee 100644
--- 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 d6dbc7729e..96f012af95 100644
--- 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 522c2a2da9..e1bfdc5012 100644
--- 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 ba861f2701..b6c96bf542 100644
--- 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 34f969ffd5..db391d0ab4 100644
--- 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 8717929d9b..283cd653c7 100644
--- 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 97e1c624f4..4ad766eba3 100644
--- 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 a164079dc2..4a481080d9 100644
--- 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 861b70e57f..b5f3e7c3cd 100644
--- 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 36378c6b25..1cc1627b3a 100644
--- 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 35a224794c..4ec8f16c93 100644
--- 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 439bd12a2b..0f46cb31f9 100644
--- 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'
-- 
2.39.2