From d12d721e46d077c3e9557567f84c0eb401fc277a Mon Sep 17 00:00:00 2001
From: Heikki Junes <heikki.junes@hut.fi>
Date: Thu, 19 Feb 2004 00:31:18 +0000
Subject: [PATCH]         * input/regression/{many}.ly: refresh, trying to
 guess how         it was designed.

---
 ChangeLog                                        |  5 +++++
 .../accidental-unbroken-tie-spacing.ly           |  4 ++--
 input/regression/beams.ly                        |  2 +-
 input/regression/collision-heads.ly              |  2 +-
 .../collision-merge-differently-dotted.ly        |  2 +-
 input/regression/dots.ly                         | 14 +++++++-------
 input/regression/figured-bass.ly                 |  4 ++--
 input/regression/lyric-phrasing.ly               | 16 +++++++---------
 input/regression/multi-measure-rest-grace.ly     |  2 +-
 .../regression/multi-measure-rest-instr-name.ly  |  7 ++++---
 input/regression/multi-measure-rest-spacing.ly   |  4 ++--
 input/regression/new-markup-syntax.ly            |  2 +-
 input/regression/note-head-style.ly              |  7 ++++---
 input/regression/number-staff-lines.ly           |  2 +-
 input/regression/ottava-broken.ly                |  4 ++--
 input/regression/ottava.ly                       |  4 ++--
 input/regression/part-combine-solo-global.ly     |  6 +++---
 input/regression/prefatory-spacing-matter.ly     |  2 +-
 input/regression/rehearsal-mark-letter.ly        |  2 +-
 input/regression/rehearsal-mark-number.ly        |  2 +-
 input/regression/repeat-fold.ly                  |  3 ++-
 input/regression/repeat-percent-skipbars.ly      |  2 +-
 input/regression/repeat-percent.ly               |  2 +-
 input/regression/repeat-slash.ly                 |  3 ++-
 input/regression/rest-polyphonic.ly              |  2 +-
 input/regression/rest.ly                         |  6 +++---
 input/regression/slur-cross-staff.ly             |  3 +--
 input/regression/slur-dots.ly                    |  4 ++--
 input/regression/slur-staccato.ly                |  2 +-
 input/regression/spacing-accidental-staffs.ly    |  2 +-
 input/regression/spacing-accidental-stretch.ly   |  2 +-
 input/regression/spacing-end-of-line.ly          |  4 ++--
 input/regression/spacing-folded-clef.ly          |  2 +-
 input/regression/spacing-grace.ly                |  2 +-
 input/regression/spacing-multi-tuplet.ly         |  8 ++++----
 input/regression/spacing-rest.ly                 |  4 ++--
 input/regression/spacing-short-notes.ly          |  6 +++---
 input/regression/spacing-stem-direction.ly       |  4 ++--
 input/regression/spacing-stem-same-direction.ly  |  2 +-
 input/regression/spacing-to-grace.ly             |  2 +-
 input/regression/spacing-very-tight.ly           | 12 +++++++-----
 input/regression/span-bar.ly                     |  3 ++-
 input/regression/staccato-pos.ly                 |  2 +-
 input/regression/staff-mixed-size.ly             |  6 +++---
 input/regression/staff-tweak.ly                  |  5 ++---
 input/regression/stem-spacing.ly                 |  4 ++--
 input/regression/system-extents.ly               |  4 ++--
 input/regression/tie-accidental.ly               |  2 +-
 input/regression/tie-break-accidental.ly         |  2 +-
 input/regression/tie-busy-grobs.ly               |  5 ++---
 input/regression/tie-chord.ly                    |  4 ++--
 input/regression/tuplet-nest.ly                  |  2 +-
 input/regression/tuplet-properties.ly            |  4 ++--
 input/regression/volta-broken-left-edge.ly       |  2 +-
 54 files changed, 111 insertions(+), 104 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 29e321ec93..e11510c827 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-02-19  Heikki Junes  <hjunes@cc.hut.fi>
+
+	* input/regression/{many}.ly: refresh, trying to guess how
+	it was designed.
+
 2004-02-18  Han-Wen Nienhuys   <hanwen@xs4all.nl>
 
 	* VERSION: release 2.1.25
diff --git a/input/regression/accidental-unbroken-tie-spacing.ly b/input/regression/accidental-unbroken-tie-spacing.ly
index 2dd5efdc33..83dd8bdae5 100644
--- a/input/regression/accidental-unbroken-tie-spacing.ly
+++ b/input/regression/accidental-unbroken-tie-spacing.ly
@@ -1,7 +1,7 @@
 
 \header {
-texidoc = "Tied accidentaled notes (which cause reminder accidentals) don't wreak havoc in
-the spacing when unbroken."
+texidoc = "Tied accidentaled notes (which cause reminder accidentals) do not 
+wreak havoc in the spacing when unbroken."
 }
 
 \version "2.1.25"
diff --git a/input/regression/beams.ly b/input/regression/beams.ly
index a1dc043546..9838ceae2d 100644
--- a/input/regression/beams.ly
+++ b/input/regression/beams.ly
@@ -1,7 +1,7 @@
 
 \version "2.1.22"
 \header {
-    texidoc = "A simple test for beams."
+    texidoc = "Beaming can be also given explicitly."
 }
 
     \paper { raggedright= ##t }
diff --git a/input/regression/collision-heads.ly b/input/regression/collision-heads.ly
index 8da3ef2c25..2b1a2596d9 100644
--- a/input/regression/collision-heads.ly
+++ b/input/regression/collision-heads.ly
@@ -2,7 +2,7 @@
 \header {
     texidoc =
 
-    "If @code{merge-differently-headed}, then
+    "If @code{merge-differently-headed} is enabled, then
 open note heads may be merged with black noteheads, but only
 if the black note heads are from 8th or shorter notes.
 "
diff --git a/input/regression/collision-merge-differently-dotted.ly b/input/regression/collision-merge-differently-dotted.ly
index 8fb1135069..415f031b31 100644
--- a/input/regression/collision-merge-differently-dotted.ly
+++ b/input/regression/collision-merge-differently-dotted.ly
@@ -1,7 +1,7 @@
 \version "2.1.22"
 \header {
     
-    texidoc = "If NoteCollision has merge-differently-dotted = \\#t note
+    texidoc = "If NoteCollision has merge-differently-dotted = ##t note
 heads that have differing dot counts may be merged anyway.  Dots
 should not disappear when merging similar note heads."
     
diff --git a/input/regression/dots.ly b/input/regression/dots.ly
index 6cf29b100c..3381ba2fdd 100644
--- a/input/regression/dots.ly
+++ b/input/regression/dots.ly
@@ -5,16 +5,16 @@
     Augmentation dots should never be printed on a staff line,
 but rather be shifted vertically. They should go up, but in case of
 multiple parts, the down stems have down shifted dots.  In case of
-chords, all dots should be in a column.  The dots go along as rests
-are shifted to avoid collisions.
+chords, all dots should be in a column.  The dots follow the shift
+of rests when avoiding collisions.
 
-The priorities, are (ranked in importance):
+The priorities to print the dots are (ranked in importance):
 
 @itemize @bullet
-@item keeping dots off staff lines
-@item keeping dots close to their  note heads
-@item moving dots in the direction specified by the voice
-@item moving dots up
+@item keeping dots off staff lines,
+@item keeping dots close to their  note heads,
+@item moving dots in the direction specified by the voice,
+@item moving dots up.
 @end itemize
 
 "
diff --git a/input/regression/figured-bass.ly b/input/regression/figured-bass.ly
index b59079c26e..883011b44e 100644
--- a/input/regression/figured-bass.ly
+++ b/input/regression/figured-bass.ly
@@ -4,9 +4,9 @@ texidoc = "
 Figured bass is created by the FiguredBass context which eats
 figured bass requests and  rest-requests.  You must enter these using
 the special @code{\figures @{ @}} mode, which allows you to type
-numbers, like @code{<<4 6+>>}.
+numbers, like @code{<4 6+>}.
 
-You can also type letters by entering quoted strings, as demonstrated in the last example. 
+You can also type letters by entering quoted strings.
 " }
 
 \score { \notes  <<
diff --git a/input/regression/lyric-phrasing.ly b/input/regression/lyric-phrasing.ly
index fd0ddc9839..3f3414e78d 100644
--- a/input/regression/lyric-phrasing.ly
+++ b/input/regression/lyric-phrasing.ly
@@ -1,23 +1,21 @@
 
 \version "2.1.22"
 \header{
-  texidoc="Lyric phrasing
+  texidoc="
+  The multiple stanzas of lyric phrasing are aligned according to the start 
+  and end of a phrase.
 
-  The multiple stanzas are aligned according to the start and end of a phrase.
-
-  Also, lyrics at the beginning of a melismata should be left aligned.
-  (is that only lyrics that are followed by `__'?  Because
-  that seems to be the case now -- jcn)
+  By default, lyrics are centered with respect to the corresponding notes.
 
 @example
-	   |        |        |     |      |
-	  x|       x|       x|    x|     x|
+           |        |        |     |      |
+          x|       x|       x|    x|     x|
 
      1:  Start  sentence  melisma      end.
      2:  x         x         x______      x
 @end example
 
-  Only lyrics that are followed by '__' while there is a melisma,
+  While there is a melisma, lyrics are followed by '__' and they
   are left-aligned, in this case the third x."
 }
 
diff --git a/input/regression/multi-measure-rest-grace.ly b/input/regression/multi-measure-rest-grace.ly
index 363dfcef7f..e156fc5776 100644
--- a/input/regression/multi-measure-rest-grace.ly
+++ b/input/regression/multi-measure-rest-grace.ly
@@ -2,7 +2,7 @@
 
 
 \header {
-texidoc= "Grace notes and multi-measure rests."
+texidoc= "Multi-measure rests are centered also in the case of grace notes."
 }
 
 \score   {
diff --git a/input/regression/multi-measure-rest-instr-name.ly b/input/regression/multi-measure-rest-instr-name.ly
index 9607523904..89ee4351c2 100644
--- a/input/regression/multi-measure-rest-instr-name.ly
+++ b/input/regression/multi-measure-rest-instr-name.ly
@@ -1,7 +1,8 @@
 \version "2.1.23"
-\header { texidoc = "This combines instrument names and multimeasure rests (there was an
-interesting bug in 1.3.98). " }
-
+\header { texidoc = "There are both long and short intstrument names.
+Engraving instrument names should not be confused by the
+multimeasure rests. " }
+% (there was an interesting bug in 1.3.98)
 \score{
 	\context Staff <<
 	      \set Staff.instrument = "instrument"
diff --git a/input/regression/multi-measure-rest-spacing.ly b/input/regression/multi-measure-rest-spacing.ly
index a4db531ffe..1fc68fa7a4 100644
--- a/input/regression/multi-measure-rest-spacing.ly
+++ b/input/regression/multi-measure-rest-spacing.ly
@@ -1,7 +1,7 @@
 \header {
 
-    texidoc = "By setting texts starting with a mmrest, an extra spacing 
-column is created. This should not cause problems."
+    texidoc = "By setting texts starting with a multi-measure rest, an 
+extra spacing column is created. This should not cause problems."
     }
 \version "2.1.22"
 
diff --git a/input/regression/new-markup-syntax.ly b/input/regression/new-markup-syntax.ly
index 36f64728bb..bb8141b341 100644
--- a/input/regression/new-markup-syntax.ly
+++ b/input/regression/new-markup-syntax.ly
@@ -1,5 +1,5 @@
 \header  {
-texidoc = "With the new markup syntax, text may be written in various manenrs."
+texidoc = "With the new markup syntax, text may be written in various manners."
 }
 
 \version "2.1.22"
diff --git a/input/regression/note-head-style.ly b/input/regression/note-head-style.ly
index 2640802151..204af6b6c4 100644
--- a/input/regression/note-head-style.ly
+++ b/input/regression/note-head-style.ly
@@ -1,9 +1,10 @@
 \version "2.1.22"
 \header{
 texidoc="
-Note head shapes are settable.  The stem endings should be adjusted
-per note head.  If you want different note head styles on one stem,
-you must create a special context called.
+Note head shapes may be set from several choices.  
+The stem endings should be adjusted according to the note head.  
+If you want different note head styles on one stem,
+you must create a special context.
 
 Harmonic notes have a different shape and different
 dimensions. 
diff --git a/input/regression/number-staff-lines.ly b/input/regression/number-staff-lines.ly
index 36e4e706f1..492d3da449 100644
--- a/input/regression/number-staff-lines.ly
+++ b/input/regression/number-staff-lines.ly
@@ -3,7 +3,7 @@
 
 \header{
 texidoc=" The number of stafflines of a staff can be set.  Ledger
-lines both on note heads and rests are adjusted.  Barlines also are
+lines both on note heads and rests, as well as barlines, are
 adjusted accordingly.  "
 }
 
diff --git a/input/regression/ottava-broken.ly b/input/regression/ottava-broken.ly
index ddd784d8b7..2d40b53716 100644
--- a/input/regression/ottava-broken.ly
+++ b/input/regression/ottava-broken.ly
@@ -3,8 +3,8 @@
 \header
 {
     
-texidoc = "Ottava brackets behave properly at line breaks: there is 
-no vertical line and the horizontal line does not stick out."
+texidoc = "At line breaks, ottava brackets have no vertical line and 
+their horizontal line does not stick out."
 
 
 }
diff --git a/input/regression/ottava.ly b/input/regression/ottava.ly
index 88c704e808..494e034d9e 100644
--- a/input/regression/ottava.ly
+++ b/input/regression/ottava.ly
@@ -4,8 +4,8 @@
 texidoc = "Ottava brackets are supported, through the
 use of the scheme function @code{set-octavation}.
 
-The spanner should go below for 8va bassa, and the string can be tuned
-with @code{Staff.ottavation}.
+The spanner should go below a staff for 8va bassa, and the ottavation
+string can be tuned with @code{Staff.ottavation}.
 
 "
 
diff --git a/input/regression/part-combine-solo-global.ly b/input/regression/part-combine-solo-global.ly
index 139f3e72fa..b767dd1f77 100644
--- a/input/regression/part-combine-solo-global.ly
+++ b/input/regression/part-combine-solo-global.ly
@@ -1,7 +1,7 @@
 
-\header { texidoc = "Solo/Solo2 also is global: In this example, solo1
-	  should not printed over the 1st note, because the voice
-	  switch would kill the slur."
+\header { texidoc = "In this example, solo1
+	  should not be printed over the 1st note, because of the slur
+	  which is present from the one-voice to the two-voice situation."
 
 }
 
diff --git a/input/regression/prefatory-spacing-matter.ly b/input/regression/prefatory-spacing-matter.ly
index 21656dd799..20a1ea21eb 100644
--- a/input/regression/prefatory-spacing-matter.ly
+++ b/input/regression/prefatory-spacing-matter.ly
@@ -3,7 +3,7 @@
 \header {
 
     texidoc = "Distances between prefatory items (e.g. clef, bar, etc.)
-   are done using engraving standard distances.  These distances
+   are determined by engraving standards.  These distances
    depend on which items are combined."
 
 }
diff --git a/input/regression/rehearsal-mark-letter.ly b/input/regression/rehearsal-mark-letter.ly
index 1ead1b0ff5..3891b347bd 100644
--- a/input/regression/rehearsal-mark-letter.ly
+++ b/input/regression/rehearsal-mark-letter.ly
@@ -1,7 +1,7 @@
 
 
 \header { texidoc= "Rehearsal marks in letter style: the I is skipped,
-and after Z, we continue with double letters.  The mark may be set
+and after Z, double letters are used.  The mark may be set
 with @code{\mark NUMBER}, or with @code{Score.rehearsalMark}."
       }
 
diff --git a/input/regression/rehearsal-mark-number.ly b/input/regression/rehearsal-mark-number.ly
index 6d24a46843..f31b8968e8 100644
--- a/input/regression/rehearsal-mark-number.ly
+++ b/input/regression/rehearsal-mark-number.ly
@@ -1,7 +1,7 @@
 \header { texidoc= "
 
 Marks can be printed as numbers.  
-By setting @code{markFormatter} we may choose a different style of mark printing. Also, marks can be specified manually, with a markup argument" 
+By setting @code{markFormatter} we may choose a different style of mark printing. Also, marks can be specified manually, with a markup argument." 
 	  
       }
 
diff --git a/input/regression/repeat-fold.ly b/input/regression/repeat-fold.ly
index 00d4891667..6ce743ef7d 100644
--- a/input/regression/repeat-fold.ly
+++ b/input/regression/repeat-fold.ly
@@ -2,7 +2,8 @@
 
 \header{
 texidoc="
-Folded.  This doesn't make sense without alternatives, but it works.
+Folded repeat may not make sense without alternatives, and there
+should not be more alternatives than repeats.
 "
 }
 
diff --git a/input/regression/repeat-percent-skipbars.ly b/input/regression/repeat-percent-skipbars.ly
index 8e33df0122..5e2c19bb24 100644
--- a/input/regression/repeat-percent-skipbars.ly
+++ b/input/regression/repeat-percent-skipbars.ly
@@ -2,7 +2,7 @@
 
 
 \header {
-texidoc = "Percent repeats are not skipped, even when skipBars is set.  "
+texidoc = "Percent repeats are not skipped, even when @code{skipBars} is set."
 }
 
     \paper { raggedright= ##t }
diff --git a/input/regression/repeat-percent.ly b/input/regression/repeat-percent.ly
index 67558043d7..738a629ea4 100644
--- a/input/regression/repeat-percent.ly
+++ b/input/regression/repeat-percent.ly
@@ -1,6 +1,6 @@
 \version "2.1.22"
 \header {
-texidoc = "Measure  repeats are supported, and may be nested with beat repeats."
+texidoc = "Measure repeats may be nested with beat repeats."
 }
 	
 \score { \notes \relative c'' \context Voice { \time 4/4
diff --git a/input/regression/repeat-slash.ly b/input/regression/repeat-slash.ly
index 9f6e2c96c1..5769ff10f8 100644
--- a/input/regression/repeat-slash.ly
+++ b/input/regression/repeat-slash.ly
@@ -1,6 +1,7 @@
 \version "2.1.22"
 \header {
-texidoc = "Beat repeats are supported."
+texidoc = "Within a bar, beat repeats denote that a music snippet should be
+played again."
 }
 
 \score { \notes \relative c'
diff --git a/input/regression/rest-polyphonic.ly b/input/regression/rest-polyphonic.ly
index ae19a08bd8..d9dab97309 100644
--- a/input/regression/rest-polyphonic.ly
+++ b/input/regression/rest-polyphonic.ly
@@ -2,7 +2,7 @@
 
     texidoc = "In polyphonic situations, rests are moved down
 even if there is no opposite note or rest. The amount is two
-staff-spaces. "
+@code{staff-space}s. "
 
     }
 
diff --git a/input/regression/rest.ly b/input/regression/rest.ly
index 7103048274..21e6fa7d5a 100644
--- a/input/regression/rest.ly
+++ b/input/regression/rest.ly
@@ -2,9 +2,9 @@
 
 \header{
 texidoc="
-Rests.  Note that the dot of 8th, 16th and 32nd rests rest should be
-next to the top of the rest.  All rests except the whole rest are
-centered on the middle staff line.
+There is a big variety of rests.  Note that the dot of 8th, 16th and 32nd 
+rests rest should be next to the top of the rest.  All rests except the 
+whole rest are centered on the middle staff line.
 "
 }
 
diff --git a/input/regression/slur-cross-staff.ly b/input/regression/slur-cross-staff.ly
index d3d63213bc..310801d8fa 100644
--- a/input/regression/slur-cross-staff.ly
+++ b/input/regression/slur-cross-staff.ly
@@ -2,8 +2,7 @@
 \version "2.1.22"
 \header{
 texidoc="
-The same goes for slurs. They behave decently when broken across
-linebreak.
+Slurs behave decently when broken across a linebreak.
 "
 }
 
diff --git a/input/regression/slur-dots.ly b/input/regression/slur-dots.ly
index a12cbdb0c3..1b70c900a7 100644
--- a/input/regression/slur-dots.ly
+++ b/input/regression/slur-dots.ly
@@ -1,8 +1,8 @@
 
 \version "2.1.22"
 \header{
-texidoc="Slurs should not get confused by augmentation dots.  We use a lot
-of dots here, to make problems more visible."
+texidoc="Slurs should not get confused by augmentation dots.  With a lot
+of dots, the problems becomes more visible."
 }
 \score {
   \notes\relative c'' {
diff --git a/input/regression/slur-staccato.ly b/input/regression/slur-staccato.ly
index 96ce6eedae..936828c608 100644
--- a/input/regression/slur-staccato.ly
+++ b/input/regression/slur-staccato.ly
@@ -1,7 +1,7 @@
 
 \version "2.1.22"
 \header {
-texidoc="Manual hack for slur and staccato."
+texidoc="An extra offset may be added between a slur and staccato(s)."
 }
 
 \paper { raggedright = ##t}
diff --git a/input/regression/spacing-accidental-staffs.ly b/input/regression/spacing-accidental-staffs.ly
index f9a0a60891..cc4b3b9d0f 100644
--- a/input/regression/spacing-accidental-staffs.ly
+++ b/input/regression/spacing-accidental-staffs.ly
@@ -1,7 +1,7 @@
 \version "2.1.22"
 
 \header { 
-texidoc = "Accidentals in different staves don't effect the
+texidoc = "Accidentals in different staves do not affect the
 spacing of the quarter notes here."
 }
 
diff --git a/input/regression/spacing-accidental-stretch.ly b/input/regression/spacing-accidental-stretch.ly
index 1366f06a2d..643190d8aa 100644
--- a/input/regression/spacing-accidental-stretch.ly
+++ b/input/regression/spacing-accidental-stretch.ly
@@ -2,7 +2,7 @@
 \version "2.1.25"
 
 \header {
-    texidoc = "Accidentals don't influence the amount of stretchable space. "
+    texidoc = "Accidentals do not influence the amount of stretchable space. "
 }
 
 \score {
diff --git a/input/regression/spacing-end-of-line.ly b/input/regression/spacing-end-of-line.ly
index 26e875f44f..ae9d5ef42f 100644
--- a/input/regression/spacing-end-of-line.ly
+++ b/input/regression/spacing-end-of-line.ly
@@ -2,8 +2,8 @@
 \version "2.1.22"
 \header {
     
-    texidoc ="Broken matter at the end of line does not upset the
-    space following rests and notes."  }
+    texidoc ="Broken engraving of a bar at the end of a line does not upset 
+    the space following rests and notes."  }
 
 \score
 {
diff --git a/input/regression/spacing-folded-clef.ly b/input/regression/spacing-folded-clef.ly
index 073fdf2ba2..cb02ea635b 100644
--- a/input/regression/spacing-folded-clef.ly
+++ b/input/regression/spacing-folded-clef.ly
@@ -1,7 +1,7 @@
 \version "2.1.22"
 \header {
 texidoc = "A clef can be folded below notes in a different staff, if
-this doesn't disrupt the flow of the notes."
+this does not disrupt the flow of the notes."
 }
 
 \score { \notes \relative c'' <<
diff --git a/input/regression/spacing-grace.ly b/input/regression/spacing-grace.ly
index e8c7c31740..de819d3eca 100644
--- a/input/regression/spacing-grace.ly
+++ b/input/regression/spacing-grace.ly
@@ -1,7 +1,7 @@
 
 \version "2.1.22"
 \header {
-  texidoc = "Grace note spacing. Should be tuned? "
+  texidoc = "Grace note spacing. Should it be tuned? "
 }
 	
 \score {
diff --git a/input/regression/spacing-multi-tuplet.ly b/input/regression/spacing-multi-tuplet.ly
index f2dd5cc2e9..7d3c931d5c 100644
--- a/input/regression/spacing-multi-tuplet.ly
+++ b/input/regression/spacing-multi-tuplet.ly
@@ -1,10 +1,10 @@
 \version "2.1.22"
 \header{
-texidoc = "Concurrent tuplets should be spaced equidistantly on
-all staffs.
+texidoc = "Concurrent tuplets should be equidistant on all staffs.
 
-Note that this only spaces correctly (exactly) when raggedright
-is. For non-raggedright, it still shows a bug: uneven spacing. 
+Note that this only spaces correctly (exactly) when @code{raggedright}
+is enabled. For a non-@code{raggedright} case, it still shows a bug: 
+uneven spacing. 
 "  }
 
 
diff --git a/input/regression/spacing-rest.ly b/input/regression/spacing-rest.ly
index a75daef9f8..3076ad50b1 100644
--- a/input/regression/spacing-rest.ly
+++ b/input/regression/spacing-rest.ly
@@ -2,8 +2,8 @@
 \version "2.1.22"
 \header {
     texidoc = "Rests get a little less space, since they are narrower.
-However, the feta quarter rest is relatively wide, causing this effect to be
-very small.
+However, the quarter rest in feta font is relatively wide, causing this 
+effect to be very small.
 "
     }
 \score { \notes \relative c'' \context Staff {
diff --git a/input/regression/spacing-short-notes.ly b/input/regression/spacing-short-notes.ly
index b6da4a1e18..d0d33a41ae 100644
--- a/input/regression/spacing-short-notes.ly
+++ b/input/regression/spacing-short-notes.ly
@@ -2,10 +2,10 @@
 \version "2.1.22"
 \header {
     
-texidoc = "Notes that are shorter than the common shortest note, Get a
+texidoc = "Notes that are shorter than the common shortest note get a
 space (i.e. without the space needed for the note) proportional to
-their duration. So 16th notes get 1/2 of the space of an eigth note.
-The total distance for a 16th is (including note head) is 3/4 of the
+their duration. So, the 16th notes get 1/2 of the space of an eigth note.
+The total distance for a 16th (which includes note head) is 3/4 of the
 eighth note. "
 
 }
diff --git a/input/regression/spacing-stem-direction.ly b/input/regression/spacing-stem-direction.ly
index c470efd8bb..84046ea513 100644
--- a/input/regression/spacing-stem-direction.ly
+++ b/input/regression/spacing-stem-direction.ly
@@ -5,8 +5,8 @@
 
 texidoc="
 
-LilyPond corrects for optical spacing of stems. The overlap between to
-adjacent stems of different direction is used as a measure for how
+There are optical corrections to the spacing of stems. The overlap between 
+two adjacent stems of different direction is used as a measure for how
 much to correct."
 
 }
diff --git a/input/regression/spacing-stem-same-direction.ly b/input/regression/spacing-stem-same-direction.ly
index 324d4b0594..2a077b9e7f 100644
--- a/input/regression/spacing-stem-same-direction.ly
+++ b/input/regression/spacing-stem-same-direction.ly
@@ -2,7 +2,7 @@
 \version "2.1.22"
 \header {
 	texidoc = "For juxtaposed chords with the same direction, a
-slight optical correction is used. It is constant, and only works if
+slight optical correction is used. It is constant, and works only if
 two chords have no common head-positions range."
 }
 
diff --git a/input/regression/spacing-to-grace.ly b/input/regression/spacing-to-grace.ly
index 5101cb8e0c..bf89e78c60 100644
--- a/input/regression/spacing-to-grace.ly
+++ b/input/regression/spacing-to-grace.ly
@@ -2,7 +2,7 @@
 \version "2.1.22"
 \header {
 
-    texidoc ="Space from a normal note/barline to a grace note is
+    texidoc ="Space from a normal note (or barline) to a grace note is
     smaller than to a normal note."
     
 }
diff --git a/input/regression/spacing-very-tight.ly b/input/regression/spacing-very-tight.ly
index c5b41e653f..ff727007e4 100644
--- a/input/regression/spacing-very-tight.ly
+++ b/input/regression/spacing-very-tight.ly
@@ -2,11 +2,13 @@
 \version "2.1.22"
 \header {
 texidoc = "
- When tightly spaced, hinterfleisch -> 0.
- Stems may touch the bar lines, opposite stems may touch eachother.
- We need a mininum of about a note-width/interline space in these
- situations, so that in tightly spaced music all vertical lines
- are about equally spaced.
+ When tightly spaced, the spaces between elements (hinterfleisch?) 
+ may approach zero. In that case, 
+ stems may touch the bar lines and opposite stems may touch eachother.
+ In these situations,
+ a mininum of about a note-width/interline space is needed,
+ so that all vertical lines are approximately equally spaced in tightly 
+ spaced music.
 
  "
  
diff --git a/input/regression/span-bar.ly b/input/regression/span-bar.ly
index 4914895ea2..e22c018bfc 100644
--- a/input/regression/span-bar.ly
+++ b/input/regression/span-bar.ly
@@ -1,6 +1,7 @@
 \version "2.1.23"
 \header {
-texidoc = "Span bars draw only in between staff bar lines, so setting those to transparent shows bar lines between systems only.
+texidoc = "Span bars are drawn only between staff bar lines. By setting 
+bar lines to transparent, they are shown only between systems.
 "
 }
 
diff --git a/input/regression/staccato-pos.ly b/input/regression/staccato-pos.ly
index 62d5796d2d..25a90a9b64 100644
--- a/input/regression/staccato-pos.ly
+++ b/input/regression/staccato-pos.ly
@@ -3,7 +3,7 @@
 
 \header{
 texidoc="
-The staccato dot (and all scripts with follow-into-staff set), must
+The staccato dot (and all scripts with follow-into-staff set) must
 not be on staff lines.
 "
 }
diff --git a/input/regression/staff-mixed-size.ly b/input/regression/staff-mixed-size.ly
index c6661b9486..acd37b4d3c 100644
--- a/input/regression/staff-mixed-size.ly
+++ b/input/regression/staff-mixed-size.ly
@@ -1,9 +1,9 @@
 \header {
     
 texidoc = "Staves may be present in several sizes within a score.
-This is achieved with an internal scaling factor. When code forgets to
-take into account the scaling factor, objects generally become too
-thick or too large on smaller staves."
+This is achieved with an internal scaling factor. If the scaling factor is 
+forgotten in some places, objects generally become too thick or too 
+large on smaller staves."
 
 }
 
diff --git a/input/regression/staff-tweak.ly b/input/regression/staff-tweak.ly
index 8a4121ff4b..bd60e6ee3e 100644
--- a/input/regression/staff-tweak.ly
+++ b/input/regression/staff-tweak.ly
@@ -1,9 +1,8 @@
 \version "2.1.22"
 
 \header {
-texidoc = "The staff is a grob, and may be adjusted as well: this one
- shows a staff with 6 thick line, and a slightly large staffspace.
-Beams remain correctly quantized."    
+texidoc = "The staff is a grob (graphical object) which may be adjusted as well, for example, to have 6 thick lines and a slightly large @code{staff-space}.
+However, beams remain correctly quantized."    
 
 }
 
diff --git a/input/regression/stem-spacing.ly b/input/regression/stem-spacing.ly
index ae41bf3034..e76f96a4a5 100644
--- a/input/regression/stem-spacing.ly
+++ b/input/regression/stem-spacing.ly
@@ -3,8 +3,8 @@
 
 \header{
 texidoc="
-In a limited number of cases, LilyPond corrects for optical spacing
-effects.  In this example, space for opposite pointed stems is adjusted.
+In a limited number of cases, the optical spacing effects are corrected.  
+In this example, space for opposite pointed stems is adjusted.
 "
 
 }
diff --git a/input/regression/system-extents.ly b/input/regression/system-extents.ly
index 2b879ad88e..ef5eba4a07 100644
--- a/input/regression/system-extents.ly
+++ b/input/regression/system-extents.ly
@@ -1,8 +1,8 @@
 \version "2.1.23"
 \header {
 
-    texidoc = "LilyPond correctly determines the size of every
-    system. This includes postscript constructs such as slurs."
+    texidoc = "The size of every system is correctly determined; this 
+    includes postscript constructs such as slurs."
 
     }
 	  
diff --git a/input/regression/tie-accidental.ly b/input/regression/tie-accidental.ly
index 6d45c7418e..9e5de4fef9 100644
--- a/input/regression/tie-accidental.ly
+++ b/input/regression/tie-accidental.ly
@@ -7,7 +7,7 @@ When tying notes with accidentals across a bar boundary, the
 accidental must not be drawn on the note in the next bar.  Unless the
 tie crosses a line break, in which case the accidental is repeated if
 it would be different from an untied note.  The next note of the same
-pitch in this next bar should always show the accidental (even if it's
+pitch in this next bar should always show the accidental (even if it is
 natural).  Slurring a accidentaled note to a natural one across bar
 boundaries should be explicit.
 
diff --git a/input/regression/tie-break-accidental.ly b/input/regression/tie-break-accidental.ly
index e3aadd5a98..b04e20223a 100644
--- a/input/regression/tie-break-accidental.ly
+++ b/input/regression/tie-break-accidental.ly
@@ -3,7 +3,7 @@
 \header {
 texidoc = "First and second bes (tied across line break)
 should get an accidental, but others should not.
-Only first B should get natural sign."
+Only first b should get natural sign."
 }
 
 \score {
diff --git a/input/regression/tie-busy-grobs.ly b/input/regression/tie-busy-grobs.ly
index a84c606883..b69a380ac1 100644
--- a/input/regression/tie-busy-grobs.ly
+++ b/input/regression/tie-busy-grobs.ly
@@ -2,9 +2,8 @@
 \header {
 
 texidoc = "Tie engraver uses @code{busyGrobs} to keep track of
-note heads. Test if this queue works by throwing many  mixed tuplets at it.
-
-This test may show collisions between tie and beam. 
+note heads. By throwing many  mixed tuplets on the queue,
+one may have collisions between ties and beams. 
 " 
 
 }
diff --git a/input/regression/tie-chord.ly b/input/regression/tie-chord.ly
index 8d68236166..9ad29d3328 100644
--- a/input/regression/tie-chord.ly
+++ b/input/regression/tie-chord.ly
@@ -3,8 +3,8 @@
 \header{
 texidoc="
 When tying chords, the outer slurs point outwards, the inner slurs
-point away from the center of the staff.  Override with
-@code{tieVerticalDirection}.
+point away from the center of the staff. The behavior can be overridden 
+by setting explicitly the @code{direction} of a @code{TieColumn}.
 "
 }
 
diff --git a/input/regression/tuplet-nest.ly b/input/regression/tuplet-nest.ly
index 284832844f..ee45781503 100644
--- a/input/regression/tuplet-nest.ly
+++ b/input/regression/tuplet-nest.ly
@@ -1,7 +1,7 @@
 
 \version "2.1.25"
 \header {
-  texidoc="Manual hack for nested tuplets, move outer tuplet up."
+  texidoc="By a manual hack for nested tuplets, an outer tuplet can be moved up."
 }
 
 #(define (make-text-checker-once text)
diff --git a/input/regression/tuplet-properties.ly b/input/regression/tuplet-properties.ly
index 148fda13db..5aaf2e495e 100644
--- a/input/regression/tuplet-properties.ly
+++ b/input/regression/tuplet-properties.ly
@@ -1,7 +1,7 @@
 
 \header {
-texidoc = "Tuplet bracket formatting supports numerous options:
-NB should have no bracket, B should have bracket.
+texidoc = "Tuplet bracket formatting supports numerous options,
+for instance, bracketed (B) and non-bracketed (NB).
 "
 }
  
diff --git a/input/regression/volta-broken-left-edge.ly b/input/regression/volta-broken-left-edge.ly
index dab875e259..debd4f9a8b 100644
--- a/input/regression/volta-broken-left-edge.ly
+++ b/input/regression/volta-broken-left-edge.ly
@@ -1,7 +1,7 @@
 \version "2.1.22"
 
 \header {
-texidoc ="Broken volta spanners behave correctly at left edge in all cases."
+texidoc ="Broken volta spanners behave correctly at their left edge in all cases."
 
 }
 
-- 
2.39.5