From: Heikki Junes <heikki.junes@hut.fi>
Date: Mon, 16 Feb 2004 01:54:55 +0000 (+0000)
Subject:         * input/regression/{many}.ly: improve descriptions: use complete
X-Git-Tag: release/2.1.24~5
X-Git-Url: https://git.donarmstrong.com/lilypond.git?a=commitdiff_plain;h=9e46baedcca4e12733b6f9616a406acf03366c68;p=lilypond.git

    * input/regression/{many}.ly: improve descriptions: use complete
        sentences, try to describe what is tested, avoid `we´, do not use
        don't, ...
---

diff --git a/ChangeLog b/ChangeLog
index eeeed40f58..36a35e0eba 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2004-02-16  Heikki Junes  <hjunes@cc.hut.fi>
+
+	* input/regression/{many}.ly: improve descriptions: use complete 
+	sentences, try to describe what is tested, avoid `we´, do not use 
+	don't, ... 
+
 2004-02-15  Heikki Junes  <hjunes@cc.hut.fi>
 
 	* Documentation/user/refman.itely: use `@c´ if $internalsref{...} @c
diff --git a/input/regression/auto-beam.ly b/input/regression/auto-beam.ly
index b4f4605aff..9af3a94736 100644
--- a/input/regression/auto-beam.ly
+++ b/input/regression/auto-beam.ly
@@ -1,7 +1,8 @@
 
 \header {
 
-texidoc="Test automatic beamer: the last measure should have a single beam."
+texidoc="Beams are place automatically; the last measure should have a single 
+beam."
 
 }
 
diff --git a/input/regression/auto-change.ly b/input/regression/auto-change.ly
index fa124b2dc6..d3f1111c9e 100644
--- a/input/regression/auto-change.ly
+++ b/input/regression/auto-change.ly
@@ -5,7 +5,7 @@
 
 texidoc=" Auto change piano staff switches voices between up
 and down staves automatically rests are switched along with the coming
-note. When central C is reached, we don't switch (by default).
+note. When central C is reached, staff is not yet switched (by default).
 
 "
 }
diff --git a/input/regression/bar-number.ly b/input/regression/bar-number.ly
index 0d4262238d..def5d06592 100644
--- a/input/regression/bar-number.ly
+++ b/input/regression/bar-number.ly
@@ -3,11 +3,11 @@
 
 \header {
 
-texidoc="Bar number settable and padding adjustable.  Bar numbers
-start counting after the anacrusis.
+texidoc="Bar number may be set and their padding adjusted individually.  
+The counting of bar numbers is started after the anacrusis.
 
-The padding should be increased, to prevent clashes at the start of the line.
- 
+To prevent clashes at the beginning of a line, the padding may have to 
+be increased.
 "
 
 }
diff --git a/input/regression/bar-scripts.ly b/input/regression/bar-scripts.ly
index 28f5cdf29c..e419112187 100644
--- a/input/regression/bar-scripts.ly
+++ b/input/regression/bar-scripts.ly
@@ -3,7 +3,7 @@
 texidoc="
 
 Markings that are attached to (invisible) barlines are 
-delicate: the are attached to the rest of the score without the score
+delicate: they are attached to the rest of the score without the score
 knowing it.  Consequently, they fall over  often.
 "
 }
diff --git a/input/regression/beam-auto-knee.ly b/input/regression/beam-auto-knee.ly
index 48788e6a5d..455d846060 100644
--- a/input/regression/beam-auto-knee.ly
+++ b/input/regression/beam-auto-knee.ly
@@ -1,7 +1,7 @@
 
 \version "2.1.22"
 
-\header{ texidoc="Automatic kneeing. A knee is made when a horizontal
+\header{ texidoc="A knee is made automatically when a horizontal
 beam fits in a gap between note heads that is larger than a predefined
 threshold.
 "
diff --git a/input/regression/beam-break.ly b/input/regression/beam-break.ly
index 5019e29eaa..af501340ea 100644
--- a/input/regression/beam-break.ly
+++ b/input/regression/beam-break.ly
@@ -1,6 +1,6 @@
 
 \header {
-    texidoc = "Beams can be printed across line breaks if forced.
+    texidoc = "Beams can be printed across line breaks, if forced.
 "
 
 }
diff --git a/input/regression/beam-cross-staff-auto-knee.ly b/input/regression/beam-cross-staff-auto-knee.ly
index 23bbb59ae1..d9859d9c43 100644
--- a/input/regression/beam-cross-staff-auto-knee.ly
+++ b/input/regression/beam-cross-staff-auto-knee.ly
@@ -3,8 +3,8 @@
 
 \header{
 
-    texidoc="Automatic cross-staff knees also work (here we see them
-with explicit staff switches)."
+    texidoc="Automatic cross-staff knees work also (here they were
+produced with explicit staff switches)."
 
      }
 
diff --git a/input/regression/beam-cross-staff-slope.ly b/input/regression/beam-cross-staff-slope.ly
index 4628485c63..206629ba50 100644
--- a/input/regression/beam-cross-staff-slope.ly
+++ b/input/regression/beam-cross-staff-slope.ly
@@ -1,6 +1,6 @@
 \version "2.1.22"
 \header {
-    texidoc = "Cross staff  (kneed) beams don't cause extreme slopes."
+    texidoc = "Cross staff  (kneed) beams do not cause extreme slopes."
 }
 
 \score {
diff --git a/input/regression/beam-cross-staff.ly b/input/regression/beam-cross-staff.ly
index 11d502890d..1a14b72fe1 100644
--- a/input/regression/beam-cross-staff.ly
+++ b/input/regression/beam-cross-staff.ly
@@ -3,7 +3,7 @@
 \header{
 texidoc="
 Beams can be typeset over fixed distance aligned staves, beam
-beautification doesn't really work, but knees do. Beams should be
+beautification does not really work, but knees do. Beams should be
 behave well, wherever the switching point is.
 "
 }
diff --git a/input/regression/beam-french.ly b/input/regression/beam-french.ly
index 97346006a1..29965ea3db 100644
--- a/input/regression/beam-french.ly
+++ b/input/regression/beam-french.ly
@@ -3,8 +3,7 @@
 
 \header {
 
-    texidoc = "French style beaming. In french beaming, the
-    stems do not go to the outer beams."
+    texidoc = "In french style beaming, the stems do not go between beams."
 
 }
 
diff --git a/input/regression/beam-funky.ly b/input/regression/beam-funky.ly
index 82cfcdae0e..85450ca006 100644
--- a/input/regression/beam-funky.ly
+++ b/input/regression/beam-funky.ly
@@ -2,7 +2,7 @@
 \version "2.1.22"
 \header {
     
-    texidoc = "Knee beaming, complex configurations.  According to
+    texidoc = "In complex configurations of knee beaming, according to
 Paul Roberts, the first stem of a beam determines the direction of the
 beam, and as such the way that following (kneed) stems attach to the
 beam. This is in disagreement with the current algorithm."
diff --git a/input/regression/beam-quanting-horizontal.ly b/input/regression/beam-quanting-horizontal.ly
index cbd0431643..b07e8386df 100644
--- a/input/regression/beam-quanting-horizontal.ly
+++ b/input/regression/beam-quanting-horizontal.ly
@@ -3,8 +3,8 @@
 
 \header{
 
-    texidoc = "Test beam quant positions for horizontal beams.  Staff
-lines should be covered in all cases. For 32nd beams, the free stem
+    texidoc = "In this test for beam quant positions for horizontal beams,
+staff lines should be covered in all cases. For 32nd beams, the free stem
 lengths are between 2 and 1.5."
 
 }
diff --git a/input/regression/beam-rest.ly b/input/regression/beam-rest.ly
index b63797b9ec..94c1c30c8d 100644
--- a/input/regression/beam-rest.ly
+++ b/input/regression/beam-rest.ly
@@ -1,6 +1,6 @@
 
 \header {
- texidoc = "The number of beams doesn't change on a rest."
+ texidoc = "The number of beams does not change on a rest."
 }
 
 \version "2.1.22"
diff --git a/input/regression/beam-second.ly b/input/regression/beam-second.ly
index d0166b9b18..a3f8363166 100644
--- a/input/regression/beam-second.ly
+++ b/input/regression/beam-second.ly
@@ -2,8 +2,8 @@
 \version "2.1.22"
 \header{
   texidoc="
-Seconds are tricky.  We used to have problems with seconds being too
-steep, or getting too long stems.  In a file like this, showing
+Engraving second intervals is tricky.  We used to have problems with seconds 
+being too steep, or getting too long stems.  In a file like this, showing
 seconds, you'll spot something fishy very quickly.
  
 " }
diff --git a/input/regression/beams.ly b/input/regression/beams.ly
index 4cc90d5f8d..a1dc043546 100644
--- a/input/regression/beams.ly
+++ b/input/regression/beams.ly
@@ -1,7 +1,7 @@
 
 \version "2.1.22"
 \header {
-    texidoc = "Beams (simple)."
+    texidoc = "A simple test for beams."
 }
 
     \paper { raggedright= ##t }
diff --git a/input/regression/chord-name-entry-11.ly b/input/regression/chord-name-entry-11.ly
index b48307fc37..dcd7f1ec24 100644
--- a/input/regression/chord-name-entry-11.ly
+++ b/input/regression/chord-name-entry-11.ly
@@ -2,7 +2,7 @@
 
 \header {
 
-    texidoc = "The 11 is only added to natural-3 if it
+    texidoc = "The 11 is only added to major-13 if it
  is mentioned explicitly."
 
 }
diff --git a/input/regression/chord-name-entry.ly b/input/regression/chord-name-entry.ly
index 39fd5bf3ca..c39f185b86 100644
--- a/input/regression/chord-name-entry.ly
+++ b/input/regression/chord-name-entry.ly
@@ -3,8 +3,10 @@
 
 \header {
 
-texidoc = "Test file for the new chordname entry code (@code{\chords}
-mode): the suffixes are printed below the pitches."
+texidoc = "Chords can be produced with the new chordname entry 
+code (@code{\chords} mode), using a pitch and a suffix. Here,
+the suffixes are printed below pitches.
+"
 
 }
 
diff --git a/input/regression/chord-names-bass.ly b/input/regression/chord-names-bass.ly
index 9f5c10132f..d2aef7d5ec 100644
--- a/input/regression/chord-names-bass.ly
+++ b/input/regression/chord-names-bass.ly
@@ -2,7 +2,8 @@
 
 \header {
 
-texidoc = "Test igatzek inversion and bass notes.
+texidoc = "In ignatzek inversions, a note is dropped down to act as the
+bass note of the chord. Bass note may be also added explicitly.  
 Above the staff: computed chord names. Below staff: entered chord name. 
 "
 
diff --git a/input/regression/chords-funky-ignatzek.ly b/input/regression/chords-funky-ignatzek.ly
index b70d189775..63be07cef0 100644
--- a/input/regression/chords-funky-ignatzek.ly
+++ b/input/regression/chords-funky-ignatzek.ly
@@ -2,7 +2,7 @@
 
 
 \header {
-texidoc = "Jazz chords, unusual combinations."
+texidoc = "Jazz chords may have unusual combinations."
 }
 
 chs = \notes 
diff --git a/input/regression/collision-2.ly b/input/regression/collision-2.ly
index 5f520ac857..54a5671b71 100644
--- a/input/regression/collision-2.ly
+++ b/input/regression/collision-2.ly
@@ -1,6 +1,6 @@
 \version "2.1.22"
 \header {
-texidoc = "Collisions for single head notes. "
+texidoc = "Single head notes may collide. "
 }
     \paper { raggedright= ##t }
 
diff --git a/input/regression/collisions.ly b/input/regression/collisions.ly
index d0b5cf53f8..cde397ac8d 100644
--- a/input/regression/collisions.ly
+++ b/input/regression/collisions.ly
@@ -2,8 +2,8 @@
 \version "2.1.22"
 \header{
 texidoc="
-Normal collisions. We have support for polyphony, where the
-middle voices are horizontally shifted.
+In addition to normal collision rules, there is support for polyphony, 
+where the collosion are avoided by shifting middle voices horizontally.
 "
 filename = 	 "collisions.ly"
 enteredby = 	 "HWN,JCN"
diff --git a/input/regression/custos.ly b/input/regression/custos.ly
index 8c9bcfdaa3..02e4587011 100644
--- a/input/regression/custos.ly
+++ b/input/regression/custos.ly
@@ -1,6 +1,6 @@
 \version "2.1.23"
 \header {
-    texidoc = "Custodes in various styles."
+    texidoc = "Custodes may be engraved in various styles."
 }
 
 \score {
diff --git a/input/regression/drums.ly b/input/regression/drums.ly
index 6631b280af..ce183c8ae8 100644
--- a/input/regression/drums.ly
+++ b/input/regression/drums.ly
@@ -1,6 +1,9 @@
 
 \header {
-   texidoc = "Test drum notation."
+   texidoc = "In drum notation, there is a special clef symbol, drums are
+   placed to their own staff positions and have note heads according to the 
+   drum, an extra symbol may be attached to the drum, and the number of lines 
+   may be restricted."
 }
 
 
diff --git a/input/regression/key-clefs.ly b/input/regression/key-clefs.ly
index 7d524dabb8..7b75b6e9f3 100644
--- a/input/regression/key-clefs.ly
+++ b/input/regression/key-clefs.ly
@@ -1,6 +1,6 @@
 
 \version "2.1.22"
-\header { texidoc = "Tests placement of accidentals in every clef. " }
+\header { texidoc = "Each clef have own accidental placing rules. " }
 
 \score { \notes
   \relative cis' {
diff --git a/input/regression/lyric-extender.ly b/input/regression/lyric-extender.ly
index 83fb1e79e1..8b2092742b 100644
--- a/input/regression/lyric-extender.ly
+++ b/input/regression/lyric-extender.ly
@@ -1,6 +1,6 @@
 \version "2.1.22"
 
-\header { texidoc= "Tests lyric extenders. "}
+\header { texidoc= "In lyric extenders, a syllable may be extended over several notes. "}
 
     \paper { raggedright= ##t }
 \score{
diff --git a/input/regression/lyric-hyphen.ly b/input/regression/lyric-hyphen.ly
index 0ae485bc6b..3e4f5afeb9 100644
--- a/input/regression/lyric-hyphen.ly
+++ b/input/regression/lyric-hyphen.ly
@@ -1,5 +1,5 @@
 \version "2.1.22"
-\header {texidoc="Tests lyric hyphens. "}
+\header {texidoc="In lyrics, hyphens may be used."}
 \score{
 	<<
 	\context Staff \notes { c' (c') (c') c' }
diff --git a/input/regression/mmrest-collision.ly b/input/regression/mmrest-collision.ly
index 37a2683a91..26e92bad90 100644
--- a/input/regression/mmrest-collision.ly
+++ b/input/regression/mmrest-collision.ly
@@ -1,6 +1,6 @@
 \version "2.1.23"
-\header { texidoc = "Tests a collision between multimeasure rests in
-different voices. " }
+\header { texidoc = "Collision between multimeasure rests in different voices
+may be avoided. " }
 \score {
   \context Staff \notes <<
     \new Voice {
diff --git a/input/regression/tuplet-rest.ly b/input/regression/tuplet-rest.ly
index d477edc08b..f35bf4a14a 100644
--- a/input/regression/tuplet-rest.ly
+++ b/input/regression/tuplet-rest.ly
@@ -1,6 +1,6 @@
 
 \version "2.1.22"
-\header {texidoc = "Tests tuplet rests. "}
+\header {texidoc = "Tuplets may contain rests. "}
 
 \score {
   \context Voice \notes \relative c'' {