* input/test/[t-v]*.ly: finish rewriting texidocs.

diff --git a/ChangeLog b/ChangeLog
index e8d4e4cbb74daae7c02708e02e559961fd49e4a8..680335dfea604c4b42c9b7feff1949f4e3274403 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -17,6 +17,11 @@
        
 2004-02-28  Heikki Junes <hjunes@cc.hut.fi>
 
+       * input/test/[t-v]*.ly: finish rewriting texidocs.
+
+       * input/test/vaticana.ly: remove.
+       * input/test/ligature-vaticana.ly: new, renamed file name.
+
        * input/test/stem-centered.ly: remove.
        * input/test/mensural-note-heads.ly: new file. take content from
        removed file stem-centered.ly.

diff --git a/input/test/tablature-hammer.ly b/input/test/tablature-hammer.ly
index d96f594a24bb70a37482f72dfe373e5d645f1ffd..674bd535b481055e1c18b7b41957875debead124 100644 (file)
--- a/input/test/tablature-hammer.ly
+++ b/input/test/tablature-hammer.ly
@@ -1,7 +1,7 @@
 
 \version "2.1.26"
 \header {texidoc = "@cindex Tablature hammer
-You can fake a hammer in tablature with slurs. "
+A hammer in tablature can be faked with slurs. "
 } 
 
 \score{

diff --git a/input/test/tablature.ly b/input/test/tablature.ly
index a74a5cea25317c34f991abac456aa58b953a3006..062c966612cec5aae758605848492272754a4c49 100644 (file)
--- a/input/test/tablature.ly
+++ b/input/test/tablature.ly
@@ -1,11 +1,15 @@
 \version "2.1.26"
 
 \header{ texidoc = "@cindex Tabulature
-A sample tablature, with both normal staff and tab.
+Tablature is internally done by overriding the note-head formatting function
+and let it act on a 6-line staff. A special engraver takes then care of 
+choosing the fret and converting the pitch to a number. 
 
-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. "
+Thus, by providing the fret numbers, the same music can be generated both 
+for a normal and tabulature staffs. By default, the fret is the smallest 
+possible, according to @code{minimumFret}.
+
+"
 }
 
 partition = \notes {

diff --git a/input/test/temporary-stave.ly b/input/test/temporary-stave.ly
index 74a5d66f0ba99fd4f55d97bb93d750aeabb9fc7f..72f7514f708c6a1338ccd0c35f502f122c68d5c2 100644 (file)
--- a/input/test/temporary-stave.ly
+++ b/input/test/temporary-stave.ly
@@ -5,8 +5,8 @@
 
 texidoc= "
 An additional stave can be typeset in the middle of a score line. 
-A new context type is created to avoid printing time and key
-signatures and clef at the beginning of the temporary stave.
+A new context type is created for the temporary staff to avoid printing 
+time and key signatures and clef at the beginning of the extra stave.
 "
 } 
 

diff --git a/input/test/text-rotate.ly b/input/test/text-rotate.ly
index d0c8ad4052573f424e4a49e633798ad6b8636275..a8d2707746406c891ce20b93dcad2f2d22400ce0 100644 (file)
--- a/input/test/text-rotate.ly
+++ b/input/test/text-rotate.ly
@@ -5,9 +5,9 @@
 @cindex rotated text
 @cindex choir, rotated text
 
-Rotated text may be faked using inline TeX (or inline
-postscript). To see the result, this files must be processed with
-the lilypond.py script, and a line must be uncommented.
+Inline TeX (or PostScript) may be used, for example, to rotate text.
+To see the result, use the @code{lilypond.py} script to generate the 
+output for printing of the source of this example (commenting one line).
 
 "
 

diff --git a/input/test/text-spanner.ly b/input/test/text-spanner.ly
index 0ac414db1f720dba8af9853a5990f2bee80d7b2a..1d7ae2ddeac7c7df6a14e149effbc67661f2e341 100644 (file)
--- a/input/test/text-spanner.ly
+++ b/input/test/text-spanner.ly
@@ -2,7 +2,9 @@
 \version "2.1.26"
 
 \header { texidoc = "@cindex text spanner
-You can make LilyPond print text spanners. "
+Text spanners can be used in the similar manner than markings for pedals
+or octavation.
+"
 }
 
 \score{

diff --git a/input/test/textscript.ly b/input/test/textscript.ly
index b1ab15489351cc830da3e4f080e1e19af6fed39a..bb07993620df1a85dd7b5702346e6806e0098650 100644 (file)
--- a/input/test/textscript.ly
+++ b/input/test/textscript.ly
@@ -2,7 +2,7 @@
 \version "2.1.26"
 
 \header { texidoc = "@cindex Textscript
-Test font selection and scm text markup. "
+There are different fonts and glyphs to be used with @code{\markup} command. "
 }
 
 \score{

diff --git a/input/test/tie-cross-voice.ly b/input/test/tie-cross-voice.ly
index e904dd16c0555890f31cf0406b1c10328f1a3d35..f12662e188d84467d45c76490302918d9b89b098 100644 (file)
--- a/input/test/tie-cross-voice.ly
+++ b/input/test/tie-cross-voice.ly
@@ -3,7 +3,7 @@
 
 
 \header {
-    texidoc = "Cross voice ties can be faked by blanking noteheads."
+    texidoc = "Cross voice ties can be faked by using transparent noteheads."
     }
 
 

diff --git a/input/test/tie-sparse.ly b/input/test/tie-sparse.ly
index 89d50e358ab3d9e11e50075b6b1f4266224d8b76..75f160ebce969a3ae4f1312488bb0a806cd81fe6 100644 (file)
--- a/input/test/tie-sparse.ly
+++ b/input/test/tie-sparse.ly
@@ -2,9 +2,10 @@
 \version "2.1.26"
 
 \header { texidoc = "@cindex Tie Sparse
-Setting sparseTies causes only one tie to be
-generated per chord pair. "
+Setting @code{sparseTies} generated only one tie per chord pair. "
 }
+
+% seem not to work -HJJ
        
 \score { 
   \context Voice \notes\relative c {

diff --git a/input/test/time-signature-double.ly b/input/test/time-signature-double.ly
index ba8d0db2f2a476ee5d9caa3e0478636d0c19a14f..e8693b0d42baa153e06abac03680a45ef5909f2d 100644 (file)
--- a/input/test/time-signature-double.ly
+++ b/input/test/time-signature-double.ly
@@ -9,8 +9,8 @@
 
 
 Double time
-signatures are not supported explicitly, but can be faked with markups
-and overriding formatting routines. " }
+signatures are not supported explicitly, but they can be faked with 
+markups and overriding formatting routines. " }
 
 tsMarkup =
 \markup  {

diff --git a/input/test/time.ly b/input/test/time.ly
index e01def09c9ee1ebaac49eb2df0813254deb812c5..22a56fd6fad7e9eeae36f70bd3577777a0b97522 100644 (file)
--- a/input/test/time.ly
+++ b/input/test/time.ly
@@ -4,7 +4,7 @@
 
 \header { texidoc = "@cindex Time
 
-Old time signatures. For further information, consult the file. 
+The different styles for time signatures are shown in this file.
     
 "
 }

diff --git a/input/test/timing.ly b/input/test/timing.ly
index a4b55bfdd2506cb6c520647e1d98382ea8254bd9..56e7df7f36f24be961d9de78fa2bdf43bf24f48f 100644 (file)
--- a/input/test/timing.ly
+++ b/input/test/timing.ly
@@ -4,7 +4,7 @@
 
 \header{ texidoc = "@cindex Bar Length
 
-You can alter the length of bars by setting
+You can alter the length of bars by setting explicitly
 @code{measureLength} or by resetting @code{measurePosition}. "
 }
 

diff --git a/input/test/title.ly b/input/test/title.ly
index 83fac2abecefc06e55627f6a3e520a4c87f952c8..32bbf8132879ddedb1d57fd3cf0ef75f1eece99e 100644 (file)
--- a/input/test/title.ly
+++ b/input/test/title.ly
@@ -17,7 +17,8 @@
   enteredby = "jcn"
   source = "urtext"
 
-  texidoc ="This test lilypond titling. process with lilypond, not lilypond-book." 
+  texidoc ="This example tests titling. By processing with @code{lilypond} 
+  (not @code{lilypond-book}), you will see all the titles." 
 }
 
 \score {

diff --git a/input/test/to-xml.ly b/input/test/to-xml.ly
index 274462d1708ec9dcc49cbe379156e1f7ef70c34a..f6bdc3dd3eeb5d79f2cb2aeae0a6b34c3bb6de0c 100644 (file)
--- a/input/test/to-xml.ly
+++ b/input/test/to-xml.ly
@@ -10,7 +10,7 @@ fooBar = \notes { << c''4 \\ g'4 >> }
 \header {
     texidoc = "@cindex To XML"
        texidoc = #(string-append
-      "The input representation is very generic. It
+      "The input representation is very generic. Therefore, it
       should not be hard to convert it to XML or a similar format:\n\n"
 
       "@example\n"

diff --git a/input/test/transposition.ly b/input/test/transposition.ly
index bc5ed65326747a595979d9446789fdea4dac90b2..e9cee118cba2595fad70e8a1959e63e79216433f 100644 (file)
--- a/input/test/transposition.ly
+++ b/input/test/transposition.ly
@@ -2,13 +2,13 @@
 \version "2.1.26"
 
 \header{ texidoc = "@cindex Transposition
-Transposition test file."
+Transposing has also an effect key signature, if it is given using
+@code{\key}. If @code{keySignature} is set explicitly instead, 
+the key signature is not transposed."
 
-
-% huh what's this supposed to test? 
      }
 
-
+% should the explicitly set key signature transpose also? -HJJ
 
 vOne = \notes \relative c''{
         \clef"violin"

diff --git a/input/test/trill.ly b/input/test/trill.ly
index f49ee75757a864d629811409fbe28c191311631f..9fd74b62c76511d95f7e790ad4f41a305946e54b 100644 (file)
--- a/input/test/trill.ly
+++ b/input/test/trill.ly
@@ -1,9 +1,8 @@
 \version "2.1.26"
 
 \header { texidoc="@cindex Trill
-Show trill line type.
-
-The extended trill is a TextSpanner in @code{trill} style.
+The extended trill may be produced using @code{TextSpanner} with @code{trill} 
+spanner style.
 "
 }
 

diff --git a/input/test/trills.ly b/input/test/trills.ly
index 4faa73e90a0f21d7bf218457cc446b660df4c031..f1ea5af9f2aa7a929700f691ba0f8eeca58e989c 100644 (file)
--- a/input/test/trills.ly
+++ b/input/test/trills.ly
@@ -2,7 +2,8 @@
 
 \header {
   texidoc="@cindex Trills
-Document trills, pralls and turns."
+Trills, pralls and turns may also be written out in full. Here the
+D'Anglebert system (1689) is shown."
   
 }
 

diff --git a/input/test/unfold-all-repeats.ly b/input/test/unfold-all-repeats.ly
index e9ee7f6a27ba50da42407c9b286d02f37d338c15..20826832e2b8b12501afe63dfa4d5df9fa83c524 100644 (file)
--- a/input/test/unfold-all-repeats.ly
+++ b/input/test/unfold-all-repeats.ly
@@ -2,8 +2,8 @@
 % regression.  -gp
 
 \header { 
-texidoc = "The standard function unfold-repeats will recursively unfold
-all repeats for correct MIDI output. Thanks to Rune Zedeler."
+texidoc = "Applying the standard function @code{unfold-repeats} unfolds 
+recursively all repeats for a correct MIDI output."
 }
 
 

diff --git a/input/test/version-output.ly b/input/test/version-output.ly
index 46ac4727dc6aff7d949a3bb2ae20b76dae2af984..48994a4968d82946be106907a3c2bf40348a4066 100644 (file)
--- a/input/test/version-output.ly
+++ b/input/test/version-output.ly
@@ -4,9 +4,10 @@
 
 
     texidoc = #(string-append "By putting the output of
-    @code{lilypond-version} into a lyric, we can print the version
-    number in a score, or a lilypond-book document. Another option is
-    to append the version to the doc-string, like this: "
+    @code{lilypond-version} into a lyric, it is possible to print the 
+    version number of LilyPond in a score, or in a document generated
+    with @code{lilypond-book}.  Another possibility is to append the 
+    version number to the doc-string, in this manner: "
 
   (lilypond-version)
   )

diff --git a/input/test/vertical-extent.ly b/input/test/vertical-extent.ly
index 9d48ace82128e91b9f45b1caa4607303fb34bdbb..21d989a969d2285e54d9bd848fc8e577b65356df 100644 (file)
--- a/input/test/vertical-extent.ly
+++ b/input/test/vertical-extent.ly
@@ -2,10 +2,9 @@
 % TODO: huh?  what's this file about?  -gp
 
 \header { texidoc = "
-Vertical extents may be overriden by
-minimumVerticalExtent, extraVerticalExtent, and  verticalExtent. These are
-normal property values, and are written into the grob when the
-associated context finishes, so using it in \property works.
+Vertical extents may increased by setting @code{minimumVerticalExtent}, 
+@code{extraVerticalExtent}, and @code{verticalExtent}. In this example,
+@code{verticalExtent} is increased.
 " }
 
 \score {