]> git.donarmstrong.com Git - lilypond.git/commitdiff
update texidocs.
authorHeikki Junes <heikki.junes@hut.fi>
Fri, 27 Feb 2004 21:33:31 +0000 (21:33 +0000)
committerHeikki Junes <heikki.junes@hut.fi>
Fri, 27 Feb 2004 21:33:31 +0000 (21:33 +0000)
13 files changed:
ChangeLog
input/test/lilypond-testpage.ly
input/test/lyric-hyphen-retain.ly
input/test/lyrics-skip-notes.ly
input/test/mensural-ligatures.ly
input/test/midi-scales.ly
input/test/move-accidentals.ly
input/test/move-specific-text.ly
input/test/music-creation.ly
input/test/nested-groups.ly
input/test/no-bar-lines.ly
input/test/no-staff.ly
input/test/ossia.ly

index b46ba62630dd0db86eb3c724b9a3e6d5bbca32c2..df99be6c0439ed723504043c05afec0275e2d02d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2004-02-27  Heikki Junes <hjunes@cc.hut.fi>
+
+       * input/test/[j-o]*.ly: update texidocs.
+
 2004-02-27  Jan Nieuwenhuizen  <janneke@gnu.org>
 
        * scm/documentation-generate.scm (usermanref): Add macro for TeX.
index 8d8bb2d2b37c0fc3505c78d7dbc709dff3682091..448e6c98f4662ea3467cddf994a4d63e0880715c 100644 (file)
@@ -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
index c5fdff2d3799ddc6dc7251e512f7e32d70fef940..6a655199406df8a21ecf1d6be8fbb784aa1571d4 100644 (file)
@@ -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.
 "
 
 }
index 302d515faac1c464b4dcf77f4e1925c506ab9b0f..86b5480b8f474ec181ef725773ad6689316d91db 100644 (file)
@@ -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. 
 
 "
 }
index 2301f3174176597d07526dff7b47b6646ff95d83..1ff99ddd49243c3efd348bd31d7b83db68bf61dd 100644 (file)
@@ -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."
 }
 
 
index d0f5062b9cf29f6964bdab66a4a97569734a80c2..7525288cf019dd75c43ae536e0c4de15bed3756b 100644 (file)
@@ -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.
+  
+  "
 }
 
 %{
index e0711fdca9150ee807fe8e323aa880434f9c9c12..469ea32ee945051cdb8d08e32e606f8c4dcf6bdb 100644 (file)
@@ -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)
index 254341abc50fa4e721f24f57f8c7908dc54786bf..6a3e9dc8ea99227254a40d6362070fd3a6f72bce 100644 (file)
@@ -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))))
index db0204b7e0e0700a53636fc7d27bc1579f02d1ec..6a1cfc730f4c194b3e4635cff2940778b9d457b1 100644 (file)
@@ -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)
index 0bbb575f9f2a55f366b7177ff8ced94381da99e1..6db3382580e387968bcf7e6ac084e43f85ea5509 100644 (file)
@@ -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'}
    >>
index 68f00cce17a1c382cada7bb95832533bc86ebc0f..fe94aebd07560731a33476502414733acb630952 100644 (file)
@@ -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 {
index 35d66d52dabf3ae741ed7828d691ff7af71be029..3df16beebdd4e970381c4dcd665a09333590c758 100644 (file)
@@ -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 {
index 17ffb5e792fb5b20d91a3477fb0ca6b7e3421f3d..47ad3b34f77b3103a9da0d4aab3631327d4aabb1 100644 (file)
@@ -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"