of missing features.
+2004-02-28 Heikki Junes <hjunes@cc.hut.fi>
+
+ * input/test/[p-r]*.ly: use more verbose texidocs. add comments
+ of missing features.
+
2004-02-27 Heikki Junes <hjunes@cc.hut.fi>
* input/test/[j-o]*.ly: update texidocs.
\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{
\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 {
\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 {
\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. "
}
@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.
"
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 {
@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.
"
\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'' {
@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.
"
% 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'{
\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
\header {
texidoc = "@cindex Rests
-Rests in various styles.
+Rests may be used in various styles.
"
}
\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 }
\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 }