From: Heikki Junes Date: Fri, 27 Feb 2004 23:37:16 +0000 (+0000) Subject: * input/test/[p-r]*.ly: use more verbose texidocs. add comments X-Git-Tag: release/2.1.28~12 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=36f2940b55faf9ec9bf1d33ae706981369be510f;p=lilypond.git * input/test/[p-r]*.ly: use more verbose texidocs. add comments of missing features. --- diff --git a/ChangeLog b/ChangeLog index df99be6c04..57837b8705 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2004-02-28 Heikki Junes + + * input/test/[p-r]*.ly: use more verbose texidocs. add comments + of missing features. + 2004-02-27 Heikki Junes * input/test/[j-o]*.ly: update texidocs. diff --git a/input/test/part-combine.ly b/input/test/part-combine.ly index 5e2ec17e59..c81f2c655d 100644 --- a/input/test/part-combine.ly +++ b/input/test/part-combine.ly @@ -2,10 +2,11 @@ \version "2.1.26" \header{ texidoc="@cindex Part Combine -In orchestral scores and hymns, voices are traditionally combined onto -one staff. LilyPond has a part combiner, that combines or separates two -voices according to actual rhythm and pitch. User-defined texts such as -``solo'' and ``@`a2'' are typeset automagically, as appropriate. " +In orchestral scores and hymns, voices are traditionally combined into +one staff. LilyPond has a part combiner that combines, or separates, two +voices according to the actual rhythm and pitch. Configurable texts, such +as ``solo'' and ``@`a2'', are typeset automatically in appropriate +places. " } \score{ diff --git a/input/test/partial-blank.ly b/input/test/partial-blank.ly index 2522ddbad2..bdc14c112b 100644 --- a/input/test/partial-blank.ly +++ b/input/test/partial-blank.ly @@ -2,10 +2,10 @@ \version "2.1.26" % check with invisible-notes or blank-notes. possible rename. -gp \header{ texidoc = "@cindex Partial Blank -When entering half music (i.e. for students to complete by hand) -you need the spacing to correspond to the timing -- all measures -same length, etc. This thing implements it by adding invisible -staff with lots of fast notes. " +When entering partially typeset music (i.e. for students to be +completed by hand), you may need the spacing that correspond to the +timing of notes: all measures have same length, etc. It can be +implemented by adding an invisible staff with a lot of fast notes. " } quickmeasure = \notes { diff --git a/input/test/phrasing-slur-height.ly b/input/test/phrasing-slur-height.ly index 6c1b5f71ca..634b898937 100644 --- a/input/test/phrasing-slur-height.ly +++ b/input/test/phrasing-slur-height.ly @@ -1,7 +1,8 @@ \version "2.1.26" \header{ texidoc="@cindex Phrasing Slur Height -Make PhrasingSlur higher, to avoid colission from other slurs. " +The @code{PhrasingSlur} can be made higher in order to avoid collision +with other slurs. " } \score { diff --git a/input/test/piano-staff-distance.ly b/input/test/piano-staff-distance.ly index 0e16a723a5..62d01cdac7 100644 --- a/input/test/piano-staff-distance.ly +++ b/input/test/piano-staff-distance.ly @@ -2,9 +2,9 @@ \header { - texidoc = "It is possible to have different staff distances across -piano systems, but it requires some advanced magic. Kids don't try -this at home. " + texidoc = "It is possible to have different staff distances between +the staffs of a piano system, but it requires some advanced Scheme code. +Currently, this is for testing purposes. " } diff --git a/input/test/polymetric-differing-notes.ly b/input/test/polymetric-differing-notes.ly index d63f44e4d5..88b88fc291 100644 --- a/input/test/polymetric-differing-notes.ly +++ b/input/test/polymetric-differing-notes.ly @@ -6,14 +6,17 @@ @cindex scaling durations -You can have multiple time signatures occuring at the same time, with -different durations aligned. This is done by 1. compressing one of -the lines, analogous to \times, but without the bracket, and -2. manually setting timeSignatureFraction to the desired fraction. +It is possible to have multiple time signatures, each one in an own staffs, +at the same time, and have even a proper vertical alignment of the different +durations. This is done, firstly, by setting a common time signature for +each staff but replacing it manually using @code{timeSignatureFraction} to +the desired fraction, and secondly, by scaling the printed durations to +the actual, polymetric durations. -This example puts 3/4, 9/8 and 10/8 in parallel. The last staff shows -what happens on the inside: a 3/4 time signature is combined with a -3/5 tuplet yielding the equivalent of a 10/8. +In this example, music with the time signatures of 3/4, 9/8 and 10/8 are +used in parallel. In the second staff, shown durations are multiplied by +2/3, so that 2/3 * 9/8 = 3/4, and in the third staff, shown durations are +multiplied by 3/5, so that 3/5 * 10/8 = 3/4. " diff --git a/input/test/polymetric.ly b/input/test/polymetric.ly index 3dd234801f..c741341a9c 100644 --- a/input/test/polymetric.ly +++ b/input/test/polymetric.ly @@ -7,12 +7,15 @@ You can have multiple time signatures occuring at the same time. This is done by moving the timing engraver to staff context. Also, -Staff should be given the alias @code{Timing} to make @code{\\time} -command work correctly. Barlines distort the regular spacing, though. - +@code{Staff} should be given the alias @code{Timing} to make @code{\\time} +command work correctly. The spacing is aligned vertically, although the bar +lines seem to distort the regular spacing. " } +%% Multiple time signatures seem not to be printed, however. +%% Should print bar lines according to the time signature of each staff. -HJJ + \score{ \notes \relative c' << \new Staff { diff --git a/input/test/preset-extent.ly b/input/test/preset-extent.ly index a5ea061099..1c71816884 100644 --- a/input/test/preset-extent.ly +++ b/input/test/preset-extent.ly @@ -3,10 +3,9 @@ @cindex Preset Extent - -Grob extents may be hard coded using grob properties. -The lyrics in this example have extent (-10,10) which is why they are -spaced so widely. +The object may be extended to larger sized by overriding their properties. +The lyrics in this example have an extent of @code{(-10,10)}, which is why +they are spaced so widely. " diff --git a/input/test/repeat-manual.ly b/input/test/repeat-manual.ly index 866597be28..16a63e08e6 100644 --- a/input/test/repeat-manual.ly +++ b/input/test/repeat-manual.ly @@ -1,8 +1,8 @@ \version "2.1.26" \header { texidoc = "@cindex Repeat Manual -You can manually control repeat signs and numbers to produce -unusual output. " +By controlling manually the signs and numbers in repeats, an unusual +output can be produced. " } \score { \notes \relative c'' { diff --git a/input/test/repeat-shorter-bracket.ly b/input/test/repeat-shorter-bracket.ly index 62ceebb9d5..b4027542a6 100644 --- a/input/test/repeat-shorter-bracket.ly +++ b/input/test/repeat-shorter-bracket.ly @@ -4,8 +4,8 @@ @cindex shorter volta bracket -By setting @code{voltaSpannerDuration} the length of a volta bracket -can be shortened. +By setting @code{voltaSpannerDuration}, the horizontal length of a volta +bracket can be shortened. " diff --git a/input/test/repeat.ly b/input/test/repeat.ly index 2340781071..715f567c5a 100644 --- a/input/test/repeat.ly +++ b/input/test/repeat.ly @@ -3,9 +3,12 @@ % possible rename to lyric-repeat or repeat-lyric. \header{ texidoc = "@cindex Repeat Lyrics -You can use alternate lyrics as well as alternate notes for repeats. " +Alternate lyrics can be used, as well as alternate notes for repeats. " } +%% Syntax << { aaa } { bbb } >> seems not to work in lyrics. +%% The notes are lyrics do not match syntactically here. - HJJ + \score{ << \context Staff \notes\relative c'{ diff --git a/input/test/rest-dot-positions.ly b/input/test/rest-dot-positions.ly index 0ce8f9a8f7..9bd52ad3a9 100644 --- a/input/test/rest-dot-positions.ly +++ b/input/test/rest-dot-positions.ly @@ -2,7 +2,7 @@ \version "2.1.26" % candidate for regression. -gp \header { texidoc = "@cindex Rest Dot Positions -This file tests dotted rests. " } +Dots of rests should follow the rest positions. " } muz = \notes \relative c'' { \time 6/1 diff --git a/input/test/rests.ly b/input/test/rests.ly index 4012db84b0..e96150de9b 100644 --- a/input/test/rests.ly +++ b/input/test/rests.ly @@ -3,7 +3,7 @@ \header { texidoc = "@cindex Rests -Rests in various styles. +Rests may be used in various styles. " } diff --git a/input/test/reverse-music.ly b/input/test/reverse-music.ly index ad6beddb30..79825d9087 100644 --- a/input/test/reverse-music.ly +++ b/input/test/reverse-music.ly @@ -2,7 +2,10 @@ \version "2.1.26" % possible rename to scheme-something. \header { texidoc="@cindex Scheme Reverse Music -Simple customised music apply. " +Symmetric, or palindromical music can be produced, first, by printing +some music, and second, by printing the same music applying a Scheme +function to reverse the syntax. +" } music = \notes \relative c'' { c4 d4( e4 f4 } diff --git a/input/test/rhythm-excercise.ly b/input/test/rhythm-excercise.ly index 430e60a41e..b8303dd0be 100644 --- a/input/test/rhythm-excercise.ly +++ b/input/test/rhythm-excercise.ly @@ -1,7 +1,8 @@ \version "2.1.26" \header { texidoc = "@cindex Rhythm Exercise -This example shows a way to generate rhythm exercises with -LilyPond (e.g. no staff but retaining the barlines). " +Rythmic exercises may be produced by removing the @code{Clef} engraver, +putting all notes to the same pitch and using transparent staff lines. +" } \score { \notes { c4 c4 c8[ c8] c2 c2 }