From: Heikki Junes <heikki.junes@hut.fi>
Date: Thu, 26 Feb 2004 22:37:35 +0000 (+0000)
Subject: *** empty log message ***
X-Git-Tag: release/2.1.28~23
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=9cc688b9beb440af5c552aa99425435a2e67db97;p=lilypond.git

*** empty log message ***
---

diff --git a/ChangeLog b/ChangeLog
index 80291d0b7c..86893d993f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-02-27  Heikki Junes <hjunes@cc.hut.fi>
+
+	* input/test/[+c-i]*.ly: refresh descriptions -- maintain
+	impersonal style.
+
 2004-02-26  Jan Nieuwenhuizen  <janneke@gnu.org>
 
 	* scm/define-markup-commands.scm (upright): New markup command.
diff --git a/input/test/+.ly b/input/test/+.ly
index a97750d8ce..0ce4e1d92d 100644
--- a/input/test/+.ly
+++ b/input/test/+.ly
@@ -8,7 +8,7 @@ texidoc = #(string-append "
 @section Introduction
 
 This document shows all kinds of tips and tricks, from simple to
-advanced.  Here you may also find dirty tricks, or very the very
+advanced.  You may also find dirty tricks, or the very very
 latest features that have not been documented or fully implemented
 yet. 
 This document is for LilyPond version 
diff --git a/input/test/caps.ly b/input/test/caps.ly
index e55d01efa1..953dd45bc8 100644
--- a/input/test/caps.ly
+++ b/input/test/caps.ly
@@ -2,7 +2,7 @@
 \version "2.1.26"
 \header {
 texidoc = "@cindex Capital Letters
-You can set the font to use small caps.
+The font can be changed to small caps.
 " }
 
 shapeSC = \override LyricText  #'font-shape = #'caps
diff --git a/input/test/cautionaries.ly b/input/test/cautionaries.ly
index 4f27e92759..36a2f946d8 100644
--- a/input/test/cautionaries.ly
+++ b/input/test/cautionaries.ly
@@ -1,7 +1,8 @@
 \version "2.1.26"
 \header{
 	texidoc="@cindex Cautionary Accidentals
-LilyPond can display cautionary accidentals in different ways.
+Cautinary accidnetals are displayed in slurs by default. They can be 
+shown also with accidentals of smaller size.
 " }
 \score { \notes \context Staff \transpose c c'' {
   \key d \major
diff --git a/input/test/chord-names-german.ly b/input/test/chord-names-german.ly
index ec8d939789..9a53d50882 100644
--- a/input/test/chord-names-german.ly
+++ b/input/test/chord-names-german.ly
@@ -1,13 +1,9 @@
 \version "2.1.26"
 \header  {
     texidoc = "@cindex Chord Names German
-By setting @code{chordRootNamer}, the root
-of the chord may be named with a different function.
-
-Setting @code{\germanChords} gives true german chord-names,
-@code{\semiGermanChords} gives semi-german chord-names - - with Bb and
-keeping the english names.
-
+The english naming of chords (default) can be changed to german 
+(@code{\germanChords} replaces B and Bes to H and B) or semi-german 
+(@code{\semiGermanChords} replaces B and Bes to H and Bb).
 
 " }
 
diff --git a/input/test/chord-names-jazz.ly b/input/test/chord-names-jazz.ly
index 0cd30317ca..16a75957d7 100644
--- a/input/test/chord-names-jazz.ly
+++ b/input/test/chord-names-jazz.ly
@@ -4,14 +4,15 @@
 \header {
 
 texidoc = " Chord names are generated from a list pitches.  The
-functions constructing the names are customisable. This file shows
-Jazz chords, following Ignatzek (1995), page 17 and 18, Banter chords,
+functions which construct these names can be customised. Here are shown
+Jazz chords, following Ignatzek (pp. 17-18, 1995), Banter chords,
 and an alternative Jazz  chord notation.
 
-
 "
 
 }
+% There are three references, but only two ways to print chord names?
+% Which refers to where? -HJJ
 
 chs = \notes \transpose c' c' 
 {
diff --git a/input/test/chord-names-no-inversions.ly b/input/test/chord-names-no-inversions.ly
index b2ea64702f..bf74e87f7c 100644
--- a/input/test/chord-names-no-inversions.ly
+++ b/input/test/chord-names-no-inversions.ly
@@ -1,7 +1,8 @@
 \version "2.1.26"
 \header { texidoc= "@cindex Chord Names No Inversions
-Chord names don't attempt to find inversions and
-bass notes. " }
+Since there are several interpretations for recognizing 
+chord names, the lowest note is the bass note of a chord and the inversion 
+of the chord is found accordingly. " }
 
 scheme = \notes {
   <c' e' g'>1
diff --git a/input/test/chords-without-melody.ly b/input/test/chords-without-melody.ly
index 3e76677c62..747ddb3c13 100644
--- a/input/test/chords-without-melody.ly
+++ b/input/test/chords-without-melody.ly
@@ -1,6 +1,6 @@
 \version "2.1.26"
 \header {
-texidoc = "Jazz chords can also be used without notes."
+texidoc = "Jazz chord names can also be printed without notes."
 }
 
 \score{
diff --git a/input/test/clef-8-syntax.ly b/input/test/clef-8-syntax.ly
index 9a101f35cd..3a03261f13 100644
--- a/input/test/clef-8-syntax.ly
+++ b/input/test/clef-8-syntax.ly
@@ -3,8 +3,8 @@
 \header {
     texidoc = "@cindex Chord Octavation
 Appending @code{_8} or @code{^8} to a clef name will
-add an octavation sign to the clef, although the clef
-name needs to be in quotes (such as \"treble^8\").
+add an octavation sign to the clef; then the clef name 
+is given in quotes (such as \"treble^8\").
 " }
 
 \score { 
diff --git a/input/test/clef-end-of-line.ly b/input/test/clef-end-of-line.ly
index 20689acef0..16d91bfb7d 100644
--- a/input/test/clef-end-of-line.ly
+++ b/input/test/clef-end-of-line.ly
@@ -2,7 +2,7 @@
 \header {
 
     texidoc = "@cindex Clef End of Line
-Scales, but with clef and key signature at the end of the line.
+In these scales, the clef and key signature are shown at the end of the line.
 " }
 
 \score {
diff --git a/input/test/clef-manual-control.ly b/input/test/clef-manual-control.ly
index d1c5b2aa44..c9663d8d05 100644
--- a/input/test/clef-manual-control.ly
+++ b/input/test/clef-manual-control.ly
@@ -3,9 +3,9 @@
 
 @cindex Clef Manual Control
 
-You can use the clef engraver by using @code{\property} directly.
-@code{\clef} is merely a front-end to this. All the notes in this
-example are central C."
+The positioning of glyph and note can be separated. @code{\clef} is 
+a front-end, which keeps them together. All the notes in this example 
+are central C."
 
 }
 
diff --git a/input/test/coriolan-margin.ly b/input/test/coriolan-margin.ly
index ce21eecf75..5732ee8664 100644
--- a/input/test/coriolan-margin.ly
+++ b/input/test/coriolan-margin.ly
@@ -13,7 +13,9 @@
 
 texidoc = "@cindex Orchestra Score
 @cindex Coriolan Score
-Demonstration of how to set up an orchestral score (Beethoven's Coriolan overture).
+In an orchestral score (Beethoven's Coriolan overture), there are 
+different instrument groups, and some of the instruments may be
+transposed. Instruments are indicated either with a long or short name.
 " }
 
 #(set-global-staff-size 16)
diff --git a/input/test/count-systems.ly b/input/test/count-systems.ly
index 1d9e8c0593..4f3fb803ce 100644
--- a/input/test/count-systems.ly
+++ b/input/test/count-systems.ly
@@ -3,10 +3,12 @@
 \header{
     
     texidoc="@cindex Count Systems
-Display the number of systems, or the system number of a
-Grob.  This can be most useful to assertain that a piece uses a
-specified number of lines.
+The function which controls the printing of the system number may be also
+overridden to print, for example, the number of systems or the system
+number of a grob.
 " }
+% Original comment has no sense? -HJJ:
+% This can be most useful to assertain that a piece uses a specified number of lines.
 
 #(define (display-systemno smob)
   (let* ((this-system (ly:grob-system smob))
diff --git a/input/test/crescendi.ly b/input/test/crescendi.ly
index e248906798..e98d4feebf 100644
--- a/input/test/crescendi.ly
+++ b/input/test/crescendi.ly
@@ -2,7 +2,7 @@
 \version "2.1.26"
 \header{
 	texidoc="@cindex Crescendi
-LilyPond can print crescendi in a number of different ways.
+Crescendi can be printed in a number of different ways.
 " }
 \score{
 \notes\relative c''{
diff --git a/input/test/cue-notes.ly b/input/test/cue-notes.ly
index 4ad0549723..2f238f3af3 100644
--- a/input/test/cue-notes.ly
+++ b/input/test/cue-notes.ly
@@ -2,7 +2,7 @@
 % TODO: check to see if this example can be simplified using \small
 % or \tiny.
 \header { texidoc = "@cindex Cue Notes
-Cue notes should be set in smaller type. "
+Cue notes are typeset in a smaller font. "
 %  Cue clefs are usually not restored explicitly. "
 }
 
diff --git a/input/test/divisiones.ly b/input/test/divisiones.ly
index 1232eb46fd..cd81abf0fc 100644
--- a/input/test/divisiones.ly
+++ b/input/test/divisiones.ly
@@ -2,7 +2,7 @@
 \header {
     texidoc = "@cindex Divisiones
 Divisiones are gregorian variants of breathing signs.
-Choices are @code{divisioMinima}, @code{divisioMaior}
+Choices are @code{divisioMinima}, @code{divisioMaior},
 @code{divisioMaxima} and @code{finalis}, @code{virgula} and
 @code{caesura}.
 " }
diff --git a/input/test/dynamic-absolute-volume.ly b/input/test/dynamic-absolute-volume.ly
index 0c8000c8dd..1ddc559f81 100644
--- a/input/test/dynamic-absolute-volume.ly
+++ b/input/test/dynamic-absolute-volume.ly
@@ -2,7 +2,7 @@
 \version "2.1.26"
 \header {
     texidoc = "@cindex Dynamic Absolute Volume
-Absolute dynamics have effect in MIDI files.
+Absolute dynamics have an effect on MIDI files.
 "
 }
 
diff --git a/input/test/dynamic-extra.ly b/input/test/dynamic-extra.ly
index edfcf8b7aa..328b504728 100644
--- a/input/test/dynamic-extra.ly
+++ b/input/test/dynamic-extra.ly
@@ -3,7 +3,7 @@
 % probably should be merged into refman.
 \header{
     texidoc = "@cindex Dynamic Piu Forte
-Additional tricks for dynamics.  Pi`u forte dynamic script. " }
+Più forte dynamics is produced using @code{\markup}. " }
 
 piuf =	\markup {  \italic "pi\\`u" \dynamic "f" }
 
diff --git a/input/test/embedded-scm.ly b/input/test/embedded-scm.ly
index 861432b70c..c052c6a38b 100644
--- a/input/test/embedded-scm.ly
+++ b/input/test/embedded-scm.ly
@@ -1,6 +1,7 @@
 
 \version "2.1.26"
 % TODO: does this work?  It doesn't do anything with 1.7.20
+% Still does not work. 2.1.26 -HJJ
 \header {texidoc="@cindex Embedded scm
 You can embed scm functions in your scores.
 "}
diff --git a/input/test/engraver-contexts.ly b/input/test/engraver-contexts.ly
index 0eb33ad7c3..5dec124c1a 100644
--- a/input/test/engraver-contexts.ly
+++ b/input/test/engraver-contexts.ly
@@ -5,8 +5,8 @@ texidoc ="In polyphonic notation, many voices can share a staff: In
 this situation, the accidentals and staff are shared, but the stems,
 slurs, beams, etc. are private to each voice. Hence, engravers should
 be grouped. The engravers for note head, stems, slurs, etc. go into a
-group called ``Voice context,'' while the engravers for key,
-accidental, bar, etc. go into a group called ``Staff context.'' In the
+group called ``Voice context'', while the engravers for key,
+accidental, bar, etc. go into a group called ``Staff context''. In the
 case of polyphony, a single Staff context contains more than one Voice
 context. Similarly, more Staff contexts can be put into a single Score
 context. "
diff --git a/input/test/engraver-one-by-one.ly b/input/test/engraver-one-by-one.ly
index 8dccfbec91..f768cb9b91 100644
--- a/input/test/engraver-one-by-one.ly
+++ b/input/test/engraver-one-by-one.ly
@@ -2,21 +2,21 @@
 \version "2.1.26"
 \header {
     
-texidoc = "The notation problem, @emph{what} symbols to create,
+texidoc = "The notation problem, creating a certain symbol,
     is handled by plugins. Each plugin is called Engraver. In this example,
-  we switch on engravers  one by one, in the following order
+engravers is switched on one by one, in the following order:
 
 @itemize
-@item Note heads
-@item Staff symbol
-@item Clef
-@item Stem
-@item Beams, slurs, accents
-@item Accidentals, bar lines, time signature, and key signature.
+@item note heads,
+@item staff symbol,
+@item clef,
+@item stem,
+@item beams, slurs, accents,
+@item accidentals, bar lines, time signature, and key signature.
 @end itemize
 
 Engravers are grouped. For example, note heads, slurs, beams etc. form
-a Voice context. Engravers for key, accidental, bar, etc. form the
+a Voice context. Engravers for key, accidental, bar, etc. form a
 Staff context.
 
 "
diff --git a/input/test/extra-staff.ly b/input/test/extra-staff.ly
index 1789f2d889..9ecc88ca79 100644
--- a/input/test/extra-staff.ly
+++ b/input/test/extra-staff.ly
@@ -29,7 +29,9 @@ extra-staff.ly:
 
 \header{ texidoc="@cindex Staff Extra
 @cindex Staff Ossia
-You can add an extra staff after the beginning of a piece. "}
+You can add (possibly temporarily) an extra staff after the beginning of 
+a piece. "
+}
 
 \score {
 	<<
diff --git a/input/test/figured-bass-alternate.ly b/input/test/figured-bass-alternate.ly
index d90e6d13b9..bfa8d47a9c 100644
--- a/input/test/figured-bass-alternate.ly
+++ b/input/test/figured-bass-alternate.ly
@@ -1,7 +1,7 @@
 \header
 {
 texidoc = "An alternate method to make bass figures is to use
-markup texts."
+@code{markup} texts."
 }
 \version "2.1.26"
 
diff --git a/input/test/follow-voice.ly b/input/test/follow-voice.ly
index f28ac95cc4..62faa81f22 100644
--- a/input/test/follow-voice.ly
+++ b/input/test/follow-voice.ly
@@ -3,8 +3,8 @@
 
 % followVoice: connect note heads with line when thread switches staff 
 \header{ texidoc="@cindex followVoice Voice
-Voices can be traced automagically when they switch staves by setting
-property @code{followVoice}. " }
+Voices can be traced automatically when they switch staves by setting
+@code{followVoice}. " }
 
 
 \score {
diff --git a/input/test/force-hshift.ly b/input/test/force-hshift.ly
index 3d743fa939..4e47db8857 100644
--- a/input/test/force-hshift.ly
+++ b/input/test/force-hshift.ly
@@ -2,7 +2,7 @@
 \version "2.1.26"
 \header {
     texidoc="@cindex Force hshift
-Force hshift to override collisions. " }
+Horizontal shift (@code{hshift}) can be forced in order to avoid collisions. " }
 
 \score { 
      \notes\relative c'
diff --git a/input/test/gourlay.ly b/input/test/gourlay.ly
index c35464f713..bc4bf1c9ec 100644
--- a/input/test/gourlay.ly
+++ b/input/test/gourlay.ly
@@ -3,8 +3,8 @@
 
     texidoc="@cindex Gourlay
 
-This is taken from Gourlay's paper on
-breaking lines.  "
+The breaking of line works also with polyphony. This is taken from 
+Gourlay's paper on breaking lines.  "
 
 }
 
diff --git a/input/test/gregorian-scripts.ly b/input/test/gregorian-scripts.ly
index f34f99573f..2746973505 100644
--- a/input/test/gregorian-scripts.ly
+++ b/input/test/gregorian-scripts.ly
@@ -3,7 +3,7 @@
     title	= "Gregorian Scripts"
     texidoc  = "@cindex Gregorian Scripts
 
-Gregorian Scripts:
+Here is demonstrated a preliminary support of Gregorian Scripts:
 
 ictus, circulus, semicirculus, accentus, episem.
 
diff --git a/input/test/harmonic.ly b/input/test/harmonic.ly
index 1b43752103..b9d0864f91 100644
--- a/input/test/harmonic.ly
+++ b/input/test/harmonic.ly
@@ -2,9 +2,8 @@
 \header {
     texidoc ="@cindex Artificial Harmonics
 
-
-Artificial harmonics are notated with a different notehead style. This
-achieved by marking the harmonic pitch with @code{\harmonic}."
+Artificial harmonics are notated with a different notehead style, by 
+marking the harmonic pitch with @code{\harmonic}."
 
 }
 
diff --git a/input/test/header-ifelse.ly b/input/test/header-ifelse.ly
index d2dddec530..fbbb88dbfa 100644
--- a/input/test/header-ifelse.ly
+++ b/input/test/header-ifelse.ly
@@ -14,9 +14,8 @@ texidoc = "
 High level functionality (eg. conditional defines),
 can be accomplished with GUILE.
 
-This example puts the current version in the tagline via Scheme.
-Since the tagline isn't used in creating the webpage, this example
-doesn't output anything unusual in the collated snippets.
+This example puts the current version in the tagline via Scheme,
+however, the tagline is not printed to the collated webpage snippets.
 
 " 
 }
diff --git a/input/test/hshift.ly b/input/test/hshift.ly
index 5ced7fc923..5812d79831 100644
--- a/input/test/hshift.ly
+++ b/input/test/hshift.ly
@@ -1,6 +1,6 @@
 \version "2.1.26"
 \header { texidoc = "@cindex Horizontal Shift
-You can manually shift notes horizontally. " }
+Notes may be manually horizontally shifted. " }
 
 shiftI = \override NoteColumn  #'horizontal-shift = #0
 shiftII = \override NoteColumn  #'horizontal-shift = #1
diff --git a/input/test/incipit.ly b/input/test/incipit.ly
index ba52402004..530b7fe48c 100644
--- a/input/test/incipit.ly
+++ b/input/test/incipit.ly
@@ -1,8 +1,9 @@
 \version "2.1.26"
 \header { texidoc = "@cindex Incipit
-This shows how to make an ``incipit'' to indicate scordatora 
-tuning of a violin part, using the clefStyle property.
-The two first bars of Biber's Rosary sonata III. " }
+This example shows how to make an ``incipit'' to indicate 
+scordatora tuning of a violin part, by overriding the @code{style} of
+a @code{TimeSignature}.
+Here are the two first bars of Biber's Rosary sonata III. " }
 
 
 
diff --git a/input/test/instrument-name-grandstaff.ly b/input/test/instrument-name-grandstaff.ly
index bfb7a4e589..3c0f1e6028 100644
--- a/input/test/instrument-name-grandstaff.ly
+++ b/input/test/instrument-name-grandstaff.ly
@@ -1,6 +1,7 @@
 \version "2.1.26"
 \header { texidoc = "@cindex Instrument Name Grandstaff
-You can name the whole grandstaff in addition to individual staffs. " }
+You can have a name for the whole @code{GrandStaff} in addition to 
+individual @code{Staff}s. " }
 
 \score {
   \notes
diff --git a/input/test/separate-staccato.ly b/input/test/separate-staccato.ly
index 5c7c5825bc..1903dcc875 100644
--- a/input/test/separate-staccato.ly
+++ b/input/test/separate-staccato.ly
@@ -4,7 +4,8 @@
 
 \header { texidoc="@cindex Seperate Staccato
 You can enter notes and articulations separately, and merge
-them into one thread.  Here is an example to add repeated staccato dots."
+them into one thread.  In this example, a repead series of staccato dots 
+is attached to the notes."
 } 
 
 staccatos = \notes { s4-. s-. s-. s s }