Added texidoc index and comments.

diff --git a/ChangeLog b/ChangeLog
index 861f073cab70dd32e4bba757b271814e02ec1739..d0d318b5c796348caeb6c860fbe06082f747f0fc 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -10,7 +10,7 @@
        stem-extend was deleted (it was duplicate example, and not as
        good).
 
-       * input/test/s*.ly: add texidoc index.
+       * input/test/[s-z]*.ly: add texidoc index.
 
 2003-06-20  Han-Wen Nienhuys  <hanwen@cs.uu.nl>
 

diff --git a/input/test/tablature-hammer.ly b/input/test/tablature-hammer.ly
index 5f3a513a80505fef50860d5c3e8747a560febd46..0c0807a334fde5e7fcd2b414bfd150fd35ca557e 100644 (file)
--- a/input/test/tablature-hammer.ly
+++ b/input/test/tablature-hammer.ly
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% delete.  -gp
 \header {
 texidoc = "" 
 }

diff --git a/input/test/tablature.ly b/input/test/tablature.ly
index e509d5a0cbd6afa3cb82e74b1fbf240c9a61f059..2a89af2501dab7b1018d189431a805751b429d97 100644 (file)
--- a/input/test/tablature.ly
+++ b/input/test/tablature.ly
@@ -1,14 +1,12 @@
 \version "1.7.18"
 
-%{
-
+\header{ texidoc = "@cindex Tabulature
 A sample tablature, with both normal staff and tab.
 
 Tablature is done by overriding the note-head formatting function, and
 putting it on a 6-line staff. A special engraver takes care of going
-from string-number + pitch to number.
-
-%}
+from string-number + pitch to number. "
+}
 
 partition = \notes {
     \key e \major

diff --git a/input/test/text-spanner.ly b/input/test/text-spanner.ly
index 74a7dd5889f773852078583eb81a864ebf1941af..4cb88635517a2d8530940d26e9e1aac611883e5d 100644 (file)
--- a/input/test/text-spanner.ly
+++ b/input/test/text-spanner.ly
@@ -1,7 +1,8 @@
 \version "1.7.18"
+% TODO: check about other ottava functions.
 
-\header {
-texidoc = "ottava spanners."
+\header { texidoc = "@cindex Ottava Spanner
+You can make Lilypond print ottava spanners. "
 }
 
 \score{
@@ -32,7 +33,8 @@ texidoc = "ottava spanners."
         a #(ly:export (make-span-event 'TextSpanEvent START))
        b c 
         a #(ly:export (make-span-event 'TextSpanEvent STOP))
-        \property Staff.centralCPosition = #-6
+        \property Staff.centralCPosition = #-6 
     }
+       \paper{ raggedright = ##t}
 }
 %% new-chords-done %%

diff --git a/input/test/textscript.ly b/input/test/textscript.ly
index 2096557ede075c335a14d01986f69b5591cc336e..1b7472ab7f7388c47a93f88d39ad6ed866072bd9 100644 (file)
--- a/input/test/textscript.ly
+++ b/input/test/textscript.ly
@@ -1,6 +1,7 @@
 \version "1.7.18"
-\header {
-texidoc = "Test font selection and scm text markup"
+
+\header { texidoc = "@cindex Textscript
+Test font selection and scm text markup. "
 }
 
 \score{
@@ -12,5 +13,6 @@ texidoc = "Test font selection and scm text markup"
     c^\markup { \bold "Dal" " " \raise #0.8 \musicglyph #"scripts-segno" }
     c^\markup \huge "ABCD"
   }
+       \paper{ }
 }
 %% new-chords-done %%

diff --git a/input/test/thumb.ly b/input/test/thumb.ly
index f9397de3f91494e20fd17ab9ca8edd0814397b64..106bb470d85562cb48ea628891d5b49089029b6b 100644 (file)
--- a/input/test/thumb.ly
+++ b/input/test/thumb.ly
@@ -1,7 +1,9 @@
 \version "1.7.18"
+% delete; covered in refman.  Trust me, I'm a cellist, and I found
+% this stuff easily in the refman.  :)   -gp
 
-\header{
-texidoc ="the thumb-script is used in cello music to indicate a note that should
+\header{ texidoc = "
+the thumb-script is used in cello music to indicate a note that should
  be played with your thumb."
 
 %% TODO: merge with fingering ?

diff --git a/input/test/tie-broken.ly b/input/test/tie-broken.ly
index 97282c902ccf59286dba86be6266c23f7d9cf368..20e1f46e66a085aa79d2e0af77ea52799989e3d6 100644 (file)
--- a/input/test/tie-broken.ly
+++ b/input/test/tie-broken.ly
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% regression stuff.  -gp
 
 \score{
        \notes \relative c''{

diff --git a/input/test/tie-sparse.ly b/input/test/tie-sparse.ly
index 233463bc300b10cc6cb5cf353fc357d2dc0f3693..6ad2d6be801370e59f686ddf15b1bf097689dcba 100644 (file)
--- a/input/test/tie-sparse.ly
+++ b/input/test/tie-sparse.ly
@@ -1,20 +1,15 @@
 \version "1.7.18"
-\header {
-
-texidoc = "setting sparseTies causes only one tie to be
-generated per chord pair."
 
+\header { texidoc = "@cindex Tie Sparse
+setting sparseTies causes only one tie to be
+generated per chord pair. "
 }
-
        
 \score { 
   \context Voice \notes\relative c {
        \property Voice.sparseTies = ##t
        c''  <<c e g>> ~ <<c e g>> 
   }
-  \paper {
-    raggedright = ##t
-  }  
-  \midi { }
+  \paper { raggedright = ##t }  
 }
 %% new-chords-done %%

diff --git a/input/test/time-signature-double.ly b/input/test/time-signature-double.ly
index 736e3f35937d85669aade86d240457f0640f4bf0..890b6853456f7650fdb841033c2d49368398e3a6 100644 (file)
--- a/input/test/time-signature-double.ly
+++ b/input/test/time-signature-double.ly
@@ -1,12 +1,9 @@
+\version "1.7.18"
 
-\header {
-
-
-texidoc= "Double time signatures are not supported
+\header { texidoc= "@cindex Time Signature Double
+Double time signatures are not supported
 explicitly, but can be faked by overriding formatting routines. "
-
 }
-\version "1.7.18"
 
 
 #(define (brew-double-time-sig grob)
@@ -49,7 +46,6 @@ explicitly, but can be faked by overriding formatting routines. "
           \time 3/2
           c2 c c 
           
-          }
-
-         }
-         
+   }
+       \paper{ raggedright = ##t}
+}        

diff --git a/input/test/time.ly b/input/test/time.ly
index 13d114f259d6b0a85441930f12ff64a999a8ebc6..f736cc7cf2451fc4c2472bada114ba1eb3c30916 100644 (file)
--- a/input/test/time.ly
+++ b/input/test/time.ly
@@ -1,7 +1,7 @@
 \version "1.7.18"
-\header
-{
-    texidoc =  "
+% TODO: This file could be old.  Ask about it later.  -gp
+
+\header { texidoc =  "@cindex Time
 IMPORTANT NOTE: The current selection scheme for time signature
 symbols is not flexible enough for future extensions such as various
 flavours of early mensural notation or complex signatures as in

diff --git a/input/test/timing.ly b/input/test/timing.ly
index 300130718ecfdab8e2434828d65c97e40a6e6481..3771e838aa1f631c6a28c0be99d7d57bc7cf9c67 100644 (file)
--- a/input/test/timing.ly
+++ b/input/test/timing.ly
@@ -1,4 +1,9 @@
 \version "1.7.18"
+% possible rename to bar-something.
+
+\header{ texidoc = "@cindex Bar Length
+You can alter the length of bars in a number of ways. "
+}
 
 \score { 
   \context Voice \notes\relative c {
@@ -20,7 +25,6 @@
        c4 c1
        
   }
-  \paper { }  
-  \midi { }
+  \paper { raggedright= ##t}  
 }
 %% new-chords-done %%

diff --git a/input/test/title.ly b/input/test/title.ly
index 1458b2d544922bf807784ddc9405ea6152affe42..8309c4c700d0f903acc267f73d847121baaa80a2 100644 (file)
--- a/input/test/title.ly
+++ b/input/test/title.ly
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% MERGE with ly2dvi-
 \header {
   filename =  "title.ly"
   dedication = "dedication"

diff --git a/input/test/to-xml.ly b/input/test/to-xml.ly
index 38e537e7444ac4e73c440f8da597d7fefe10c259..62b7919fd16052fdc54df4a86ae0d85e22ee2343 100644 (file)
--- a/input/test/to-xml.ly
+++ b/input/test/to-xml.ly
@@ -8,9 +8,8 @@ fooBar = \notes { < c''4 \\ g'4 > }
 #(music-to-xml fooBar (current-output-port))
 
 \header {
-    texidoc =
-
-    #(string-append
+    texidoc = "@cindex To XML"
+       texidoc = #(string-append
       "The input representation is very generic. It
       should not be hard to convert it to XML or a similar format:\n\n"
 

diff --git a/input/test/transposing.ly b/input/test/transposing.ly
index bc0ea6a4d19c495bf370dec3b58e0f58cc76b2b3..4d4069866d26705f18b227740957c49db3dffc9e 100644 (file)
--- a/input/test/transposing.ly
+++ b/input/test/transposing.ly
@@ -1,8 +1,9 @@
-\header {
-texidoc = " the transposing property leaves output invariant, but has effect on MIDI."
+\version "1.7.18"
+% possible rename to midi-something.
 
+\header { texidoc = "@cindex Transposing
+The transposing property leaves output invariant, but has effect on MIDI. "
 }
-\version "1.7.18"
 
 \score { 
   \context Voice \notes\relative c {
@@ -18,7 +19,7 @@ texidoc = " the transposing property leaves output invariant, but has effect on
        \property Staff.transposing = #12 c
        
   }
-  \paper { }  
+  \paper { raggedright = ##t } 
   \midi { }
 }
 %% new-chords-done %%

diff --git a/input/test/transposition.ly b/input/test/transposition.ly
index 7a14b5c0bf7d93d902a6d9d349c333cc77f512ad..22a7aa59cd9159df4bb733a95eb01479a20913a6 100644 (file)
--- a/input/test/transposition.ly
+++ b/input/test/transposition.ly
@@ -1,4 +1,10 @@
 \version "1.7.18"
+
+\header{ texidoc = "@cindex Transposition
+Transposition Test file"
+}
+
+
 %{
 Hi all,
 
@@ -22,11 +28,6 @@ Eric
 %}
 
 
-\header{
-texidoc =       "Transposition Test file"
-}
-
-
 
 
 vOne =  \notes \relative c''{
@@ -65,7 +66,7 @@ vFour =  \notes \transpose c d \vThree
          \context Staff=vThree \vThree
          \context Staff=vFour \vFour
   >
-        \paper { linewidth= 130.\mm }
+        \paper { linewidth= 130.\mm raggedright = ##t }
 }
 
 

diff --git a/input/test/trill.ly b/input/test/trill.ly
index afdd4c4f9ddd0b8e2ac8573a383b094e32a98e8c..a7551eb015c004c7fd9d0ae0a5a97091b3f92f1b 100644 (file)
--- a/input/test/trill.ly
+++ b/input/test/trill.ly
@@ -1,10 +1,9 @@
 \version "1.7.18"
 
-\header {
-texidoc="show trill line type"
+\header { texidoc="@cindex Trill
+Show trill line type. "
 }
 
-\paper { raggedright = ##t} 
 
 \score {
   \context RhythmicStaff \notes {
@@ -22,7 +21,7 @@ texidoc="show trill line type"
      = #(cons (make-musicglyph-markup "scripts-trill")  "")
     a#(ly:export (make-span-event 'TextSpanEvent START)) b c a #(ly:export (make-span-event 'TextSpanEvent STOP))
   }
-  \paper { }  
+       \paper { raggedright = ##t} 
 }
 
 %% new-chords-done %%

diff --git a/input/test/trills.ly b/input/test/trills.ly
index c535dee669514fbd46bac7073a2a8454370a5946..8b0ac8431bfc3c254ddc8f9c746fa28b2ad6c3e9 100644 (file)
--- a/input/test/trills.ly
+++ b/input/test/trills.ly
@@ -1,14 +1,13 @@
-\paper  {
-  linewidth = 433.619940\pt
-  
-} 
 \version "1.7.18"
+
 \header {
-  texidoc="Document trills, pralls and turns."
+  texidoc="@cindex Trills
+Document trills, pralls and turns."
   
-  title="Marques des agr\\'ements et leur signification"
-  composer="D'Anglebert"
-  year="1689"
+% TODO:  these don't get built, right?  check it, then delete.
+%  title="Marques des agr\\'ements et leur signification"
+%  composer="D'Anglebert"
+%  year="1689"
 }
 
 invisible = \property Voice.NoteHead \override #'transparent = ##t
@@ -107,5 +106,6 @@ endHorizScript = {
       }
     >
   >
+       \paper{ }
 }
 %% new-chords-done %%

diff --git a/input/test/tuplet-rest.ly b/input/test/tuplet-rest.ly
index 8a24cdb2a7a424b1ae782750603f8a6d1221f46b..5166a68c31ce6acb01755bdfba8752e87d3c3018 100644 (file)
--- a/input/test/tuplet-rest.ly
+++ b/input/test/tuplet-rest.ly
@@ -1,6 +1,5 @@
 \version "1.7.18"
-
-
+% regression or delete.  -gp
 
 \score {
   \context Voice \notes \relative c'' {

diff --git a/input/test/tuplet-spanner-duration.ly b/input/test/tuplet-spanner-duration.ly
index dfcbd35be85cf32c6322257d3b7b46b37c15cea4..18ca2f36a1064c081537fcfa7b08be20ed2506cf 100644 (file)
--- a/input/test/tuplet-spanner-duration.ly
+++ b/input/test/tuplet-spanner-duration.ly
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% regression or delete.
 
 \score
 {

diff --git a/input/test/two-key.ly b/input/test/two-key.ly
index 7d83fea44ec000c460926569f8be867a63cb0f2d..6c13918ba6175ff32d97a8506dc3fb9c0367cf5f 100644 (file)
--- a/input/test/two-key.ly
+++ b/input/test/two-key.ly
@@ -1,7 +1,7 @@
 \version "1.7.18"
-\header {
+% regression
 
-texidoc = "If you specify two different key sigs at one point, a
+\header { texidoc = "If you specify two different key sigs at one point, a
   warning is printed."
 
 }

diff --git a/input/test/two-slurs.ly b/input/test/two-slurs.ly
index 5dc8df00f50086c5172f480f8f27aaabbac81378..44d91142ecd9753141bc8fb706b3177290978265 100644 (file)
--- a/input/test/two-slurs.ly
+++ b/input/test/two-slurs.ly
@@ -1,9 +1,12 @@
 \version "1.7.18"
 
-%
+\header{ texidoc = "@cindex Two Slurs
+You can print a slur in each voice. "
+}
+
 % We'd want to combine the stems, but have two slurs too...
 % Looks like the a-due engraver
-%
+
 \score{
        \context Staff <
                \context Voice=v \notes\relative c''{

diff --git a/input/test/unfold-all-repeats.ly b/input/test/unfold-all-repeats.ly
index cb3b03530552c496fec6567c361cef9ad6ac406b..2be72c36827aabb62d0bdb454508b3bbef23b0cf 100644 (file)
--- a/input/test/unfold-all-repeats.ly
+++ b/input/test/unfold-all-repeats.ly
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% regression.  -gp
 
 \header { 
 texidoc = "The standard function unfold-repeats will recursively unfold

diff --git a/input/test/uniform-breaking.ly b/input/test/uniform-breaking.ly
index 9df550dae2b87fb820690ef69f0334d71499072e..525aeda04224ff8050fcad9541e8cd47ccf4e2ec 100644 (file)
--- a/input/test/uniform-breaking.ly
+++ b/input/test/uniform-breaking.ly
@@ -1,4 +1,7 @@
 \version "1.7.18"
+% definately need to check with Han or Jan for this one.
+% I haven't a clue what it does, but the output doesn't look
+% special.  -gP
 
 %{
 Hmm, ik vraag me af of dit al helemaal koel is.

diff --git a/input/test/vaticana.ly b/input/test/vaticana.ly
index 41bc93a5457dfab87a8bdf24227205dccc25ae73..c6c80d279468b2b734566385b29fc659bf0972dd 100644 (file)
--- a/input/test/vaticana.ly
+++ b/input/test/vaticana.ly
@@ -1,6 +1,8 @@
 \version "1.7.19"
-\header {
-    texidoc    = "vaticana ligature test"
+% possible rename to ancient-something.
+
+\header { texidoc      = "Ancient Vaticana
+Vaticana ligature test. "
 }
 
 \include "gregorian-init.ly"
@@ -39,12 +41,14 @@ verba = \context Lyrics = verba \lyrics {
     stafflinethickness = \staffspace / 5.0
     linewidth = 15.0 \cm
     indent = 0.0
+       raggedright = ##t
 %
 % FIXME: ragged-right alignment is currently broken
+       % I don't think it is any more.  -gp
 %   width = 12.0 \cm
-%   raggedright = ##t
 %   gourlay_maxmeasures = 30.
 %
+
     \translator {
       \VoiceContext
       \name VaticanaVoice

diff --git a/input/test/vertical-align.ly b/input/test/vertical-align.ly
index 4a00cd2e2da15467756511adf0e363cd37eb5fbc..82d87b738b12db7c063a3a872d831f3a39605e57 100644 (file)
--- a/input/test/vertical-align.ly
+++ b/input/test/vertical-align.ly
@@ -1,6 +1,5 @@
 \version "1.7.18"
-
-
+% regression or delete.  -gp
 
 \score {
 \notes <

diff --git a/input/test/vertical-extent.ly b/input/test/vertical-extent.ly
index 3ddbc34c22c858127989d997ab1224248d5c065b..42b9e63e2bd421317a801b6ab30fe5013b5d87b8 100644 (file)
--- a/input/test/vertical-extent.ly
+++ b/input/test/vertical-extent.ly
@@ -1,11 +1,12 @@
+\version "1.7.18"
+% TODO: huh?  what's this file about?  -gp
 
-\header { texidoc = "vertical extents may be overriden by
+\header { texidoc = "
+Vertical extents may be overriden by
 verticalExtent, verticalExtent, verticalExtent. These are
-normal property values, and are written itno the grob when the
+normal property values, and are written into the grob when the
 associated context finishes, so using it in \property works.
-
- " }
-\version "1.7.18"
+" }
 
 \score {
   \notes  <

diff --git a/input/test/vertical-text.ly b/input/test/vertical-text.ly
index 09d11a1d657a8d5291c2c21786dcd03ffa170d07..2c29945486f0594becfaa6278416e0ce17b30b62 100644 (file)
--- a/input/test/vertical-text.ly
+++ b/input/test/vertical-text.ly
@@ -1,4 +1,6 @@
 \version "1.7.18"
+% TODO: huh?  This text isn't vertical...?
+
 \score{
        <
                \context Staff = o \notes\relative c,,, { 

diff --git a/input/test/voice-switch.ly b/input/test/voice-switch.ly
index 5950396ca703b09e3c11374d47aeab57164dfeaa..f4fae7cdebcc273c08a7cfc0316e244324b04ada 100644 (file)
--- a/input/test/voice-switch.ly
+++ b/input/test/voice-switch.ly
@@ -1,4 +1,6 @@
 \version "1.7.18"
+% delete.  We have other partcombine examples -- if that's
+% what this is.  -gp
 
 \score{
        \context Staff <

diff --git a/input/test/volta.ly b/input/test/volta.ly
index 7de0d01f6838d3949e2b70b0e4a79862f7373ee9..e4e895be1fffa1114e917d88280963324aed8ad4 100644 (file)
--- a/input/test/volta.ly
+++ b/input/test/volta.ly
@@ -1,8 +1,7 @@
-% DOCUMENTME!
-
 \version "1.7.18"
-
-
+% DOCUMENT ME!
+% I think this is an old example of alternate repeats,
+% but that's covered in refman now.  candidate for delete.
 
 
 voiceE =  \notes {