From: Heikki Junes Date: Fri, 27 Feb 2004 21:33:31 +0000 (+0000) Subject: update texidocs. X-Git-Tag: release/2.1.28~13 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=eb21820e45c82a777d1fe6774bd6a3f3bc972525;p=lilypond.git update texidocs. --- diff --git a/ChangeLog b/ChangeLog index b46ba62630..df99be6c04 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2004-02-27 Heikki Junes + + * input/test/[j-o]*.ly: update texidocs. + 2004-02-27 Jan Nieuwenhuizen * scm/documentation-generate.scm (usermanref): Add macro for TeX. diff --git a/input/test/lilypond-testpage.ly b/input/test/lilypond-testpage.ly index 8d8bb2d2b3..448e6c98f4 100644 --- a/input/test/lilypond-testpage.ly +++ b/input/test/lilypond-testpage.ly @@ -17,7 +17,7 @@ metre = "metre" opus = "opus" piece = "piece" poet = "poet" -texidoc = "This file tests lilypond titling. It should be processed with lilypond. " +texidoc = "In the generated output for printing, there are several titles which do not appear in the web pages. " % % todo: check whether title.ly does the same. --hwn diff --git a/input/test/lyric-hyphen-retain.ly b/input/test/lyric-hyphen-retain.ly index c5fdff2d37..6a65519940 100644 --- a/input/test/lyric-hyphen-retain.ly +++ b/input/test/lyric-hyphen-retain.ly @@ -3,14 +3,15 @@ \header { -texidoc = "In tight situations, hyphens are removed, except at the -end of the line. Normally, lyrics aren't set this tight, but by -tuning down @code{padding} of in @code{SeparationItem}, syllables are put closer together, and hyphens may disappear. - -In some languages (eg. German and Hungarian). hyphens should not -disappear, since spelling depends on hyphenation. In this case, -hyphens can be forced to remain by setting @code{minimum-length} on -the LyricHyphen grob. +texidoc = "In tightly engraved music, hyphens are removed, except at the +end of the line. Normally, lyrics are not typeset so tightly, but by +tuning down @code{padding} of in @code{SeparationItem}, syllables are put +closer together, and as a result hyphens may disappear. + +In some languages (e.g. German and Hungarian), hyphens should not +disappear, since spelling depends on hyphenation. For that purpose, +hyphens can be forced to remain by overriding @code{minimum-length} of +the @code{LyricHyphen} grob. " } diff --git a/input/test/lyrics-skip-notes.ly b/input/test/lyrics-skip-notes.ly index 302d515faa..86b5480b8f 100644 --- a/input/test/lyrics-skip-notes.ly +++ b/input/test/lyrics-skip-notes.ly @@ -3,7 +3,8 @@ { texidoc =" -By inserting @code{\\skip} statements into lyric lines, one can put less lyric syllables to a melody. +By inserting @code{\\skip} statements into lyric lines, one can attach +less lyric syllables to a melody. " } diff --git a/input/test/mensural-ligatures.ly b/input/test/mensural-ligatures.ly index 2301f31741..1ff99ddd49 100644 --- a/input/test/mensural-ligatures.ly +++ b/input/test/mensural-ligatures.ly @@ -3,7 +3,8 @@ % check with ancient- stuff. rename, merge, something. -gp \header { texidoc = "@cindex Ancient Mensural Ligatures -LilyPond can print mensural ligatures." +In mensural ligatures, notes with ancient durations are printed +in a tight manner." } diff --git a/input/test/midi-scales.ly b/input/test/midi-scales.ly index d0f5062b9c..7525288cf0 100644 --- a/input/test/midi-scales.ly +++ b/input/test/midi-scales.ly @@ -2,7 +2,13 @@ \version "2.1.26" % candidate for regression. -gp \header { - texidoc="MIDI and midi2ly test file. Diff between this and midi2ly.py should be minimal." + texidoc="Converting LilyPond input to MIDI and then again back with + @code{midi2ly.py} is a reversible procedure in some simple cases, + which mean that the original @code{.ly} -file and the one converted + back from the generated @code{.midi} -file do not differ. + Here are produced some scales. + + " } %{ diff --git a/input/test/move-accidentals.ly b/input/test/move-accidentals.ly index e0711fdca9..469ea32ee9 100644 --- a/input/test/move-accidentals.ly +++ b/input/test/move-accidentals.ly @@ -2,8 +2,8 @@ % possible rename to scheme- or something like that. -gp \header { texidoc= "@cindex Scheme Manual Accidentals -Positions of accidentals may be manually set. This -involves some scheme code. " } +The positions of accidentals may be manually set by incorporating +some Scheme code. " } #(define (make-acc-position-checker pos) (lambda (elt) diff --git a/input/test/move-specific-text.ly b/input/test/move-specific-text.ly index 254341abc5..6a3e9dc8ea 100644 --- a/input/test/move-specific-text.ly +++ b/input/test/move-specific-text.ly @@ -2,8 +2,8 @@ \version "2.1.26" % possible rename to scheme- or something like that. -gp \header { texidoc = "@cindex Scheme Move Text -You can move objects around with scheme. This example shows how to -move text around. " } +Objects, like text, can be moved around by using some Scheme code. +" } #(define (make-text-checker text) (lambda (grob) (equal? text (ly:grob-property grob 'text)))) diff --git a/input/test/music-creation.ly b/input/test/music-creation.ly index db0204b7e0..6a1cfc730f 100644 --- a/input/test/music-creation.ly +++ b/input/test/music-creation.ly @@ -2,8 +2,9 @@ % possible rename to scheme- something. -gp \header { texidoc = "@cindex Scheme Music Creation -You can create music expressions from Scheme. The -mechanism for this is rather clumsy to use, so avoid it if possible. " +You can engrave music using just Scheme expressions. Although those +expressions reflect the inner mechanism of LilyPond, they are rather +clumsy to use, so avoid them, if possible. " } #(define (make-note-req p d) diff --git a/input/test/nested-groups.ly b/input/test/nested-groups.ly index 0bbb575f9f..6db3382580 100644 --- a/input/test/nested-groups.ly +++ b/input/test/nested-groups.ly @@ -1,11 +1,12 @@ \version "2.1.26" \header{ texidoc="@cindex Nested Staff Groups -LilyPond can print nested groups of staffs. " +Staffs can be nested in various combinations. Here, @code{StaffGroup} +and @code{ChoirStaff} produce similar straight brackets, whereas +@code{GrandStaff} produces curly brackets. In @code{InnerStaffGroup} +and @code{InnerChoirStaff}, the brackets are shifted leftwards. -% old texidoc; it sounds like a testing comment, rather than an "example" comment. -%In InnerStaffGroup and InnerChoirStaff, the brackets should be shiftet leftwards. -} +" \score { \notes << @@ -29,7 +30,7 @@ LilyPond can print nested groups of staffs. " >> \new ChoirStaff << \new Staff {c' d' e' f'} - \new InnerStaffGroup << + \new InnerChoirStaff << \new Staff {c' d' e' f'} \new Staff {c' d' e' f'} >> diff --git a/input/test/no-bar-lines.ly b/input/test/no-bar-lines.ly index 68f00cce17..fe94aebd07 100644 --- a/input/test/no-bar-lines.ly +++ b/input/test/no-bar-lines.ly @@ -3,7 +3,9 @@ % possible rename to bar-lines-foo. -gp \header{ texidoc = "@cindex Bar Lines Remove -You can stop LilyPond from printing bar lines by removing the engraver. " +Engravers can be removed one by one. Here, the time signature and bar lines +have been removed. +" } \score { diff --git a/input/test/no-staff.ly b/input/test/no-staff.ly index 35d66d52da..3df16beebd 100644 --- a/input/test/no-staff.ly +++ b/input/test/no-staff.ly @@ -2,7 +2,9 @@ % possible rename to staff-something. -gp \header{ texidoc = "@cindex Staff Remove -You can stop LilyPond from printing the staff by removing the engraver. " +The printing of the staff lines may be suppressed by removing the +corresponding engraver. +" } \score { diff --git a/input/test/ossia.ly b/input/test/ossia.ly index 17ffb5e792..47ad3b34f7 100644 --- a/input/test/ossia.ly +++ b/input/test/ossia.ly @@ -1,9 +1,7 @@ -\header { texidoc = "A temporary ossia in an instrumental part for - just a few bars on a separate staff. Here is an example using - proper short staffs. A simpler solution is to instantiate a full - staff, and let @code{RemoveEmptyStaffContext} take out the unused parts. - - Both solutions are demonstrated here. +\header { texidoc = "A temporary ossia in an instrumental part may + be printed using a separate, short staff. A simpler solution is + also given: instantiate a full staff, and let + @code{RemoveEmptyStaffContext} take out the unused parts. " } \version "2.1.26"