]> git.donarmstrong.com Git - lilypond.git/commitdiff
reformulate texidocs.
authorhjunes <hjunes>
Sat, 28 Feb 2004 12:58:35 +0000 (12:58 +0000)
committerhjunes <hjunes>
Sat, 28 Feb 2004 12:58:35 +0000 (12:58 +0000)
24 files changed:
ChangeLog
input/test/scales-greek.ly
input/test/scheme-interactions.ly
input/test/script-abbreviations.ly
input/test/script-chart.ly
input/test/script-priority.ly
input/test/script-stack.ly
input/test/slur-attachment-override.ly
input/test/slur-beautiful.ly
input/test/slur-dash.ly
input/test/slur-manual.ly
input/test/slur-minimum-length.ly
input/test/slur-ugly.ly
input/test/smart-transpose.ly
input/test/spacing-2.ly
input/test/spanner-after-break-tweak.ly
input/test/staff-bracket.ly
input/test/staff-container.ly
input/test/staff-lines.ly
input/test/staff-size.ly
input/test/staff-space.ly
input/test/stem-cross-staff.ly
input/test/stem-extend.ly
input/test/stem-length.ly

index 7ab737f2801df0e948bf15740a3607741e8fbd9c..e8d4e4cbb74daae7c02708e02e559961fd49e4a8 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
        
 2004-02-28  Heikki Junes <hjunes@cc.hut.fi>
 
+       * input/test/stem-centered.ly: remove.
+       * input/test/mensural-note-heads.ly: new file. take content from
+       removed file stem-centered.ly.
+
+       * input/test/scales-greek.ly: simplify.
+
+       * input/test/s*.ly: reformulate texidocs.
+       
        * input/test/[p-r]*.ly: use more verbose texidocs. add comments
        of missing features.
 
index dfa50cccb8429edba310b57aa5356e8c4a1a3ed6..669b33428eaf30e641dac3fa53f2076197bca918 100644 (file)
@@ -2,31 +2,28 @@
 \header {
   texidoc = "
 
-Show different greek scales. All these scales are in the key of C
-(major, ionian, phrygian, etc.)
+In addition to major and minor keys, the key can be given also in terms 
+of greek, modal scales: ionian (= major), dorian, phrygian, lydian, mixolydian,
+aeolian (= minor), and locrian. All these scales are in the key of C.
 
 "
 }
 
 \score  { \notes {
 
-\key c \major c'8 -"major" d'8 e'8 f'8 g'8 a'8 b'8 c''8
+\key c \ionian c'8 -"C ionian, major" d'8 e'8 f'8 g'8 a'8 b'8 c''8
 
-\key c \ionian c'8 -"ionian" d'8 e'8 f'8 g'8 a'8 b'8 c''8
+\transpose d c { \key d \dorian d'8 -"C dorian" e'8 f'8 g'8 a'8 b'8 c''8 d''8}
 
-\transpose d c { \key d \dorian c'8 -"dorian" d'8 e'8 f'8 g'8 a'8 b'8 c''8 }
+\transpose e c { \key e \phrygian e'8 -"C phrygian" f'8 g'8 a'8 b'8 c''8 d''8 e''8}
 
-\transpose e c { \key e \phrygian c'8 -"phrygian" d'8 e'8 f'8 g'8 a'8 b'8 c''8 }
+\transpose f c { \key f \lydian f'8 -"C lydian" g'8 a'8 b'8 c''8 d''8 e''8 f''8}
 
-\transpose f c { \key f \lydian c'8 -"lydian" d'8 e'8 f'8 g'8 a'8 b'8 c''8 }
+\transpose g c  { \key g \mixolydian g'8 -"C mixolydian" a'8 b'8 c''8 d''8 e''8 f''8 g''8}
 
-\transpose g c  { \key g \mixolydian c'8 -"mixolydian" d'8 e'8 f'8 g'8 a'8 b'8 c''8 }
+\transpose a c' { \key a \aeolian a8 -"C aeolian, minor" b8 c'8 d'8 e'8 f'8 g'8 a'8 }
 
-\transpose a c' { \key a \minor c'8 -"minor" d'8 e'8 f'8 g'8 a'8 b'8 c''8 }
-
-\transpose a c' { \key a \aeolian c'8 -"aeolian" d'8 e'8 f'8 g'8 a'8 b'8 c''8 }
-
-\transpose b c' { \key b \locrian c'8 -"locrian" d'8 e'8 f'8 g'8 a'8 b'8 c''8 }
+\transpose b c' { \key b \locrian b8 -"C locrian" c'8 d'8 e'8 f'8 g'8 a'8 b'8 }
 
 }
          
index 2cebce260d08ad86322b2d7faee6e9353f377f7b..7d34a8974b83915c937238e1a947572e8b714f6d 100644 (file)
@@ -1,11 +1,10 @@
 \version "2.1.26"
 \header { texidoc = "@cindex Scheme Interactions
-With @code{ly:export}, you can pass of the result of
-Scheme expressions as lilypond input.  Within a Scheme expression,
-you can use, define or change lilypond variables.
-
-In this example, the E-s and D-s are generated using scheme functions,
-and woven together with manually entered C-s.
+Using @code{ly:export}, the result of Scheme expressions can be passed
+as LilyPond input.  Within a Scheme expression, you can use, define or 
+change the corresponding variables. In this example, the D-s and E-s are 
+generated using scheme functions, and between there are manually 
+(without Scheme) entered C-s.
 
 " }
 
index 8401ef46a885beefa60a1534a8ccf6b493ae4ef2..c4ca5aabea3ab0381473d4ea36cacbc068b90a65 100644 (file)
@@ -4,7 +4,7 @@
 \version "2.1.26"
 \header { texidoc = "@cindex Script Abbreviations
 
-Some scripts may be entered using an abbreviation.
+Some articulations may be entered using an abbreviation.
 
 "
          
index 7dafa32e5eece4a0aa356302ac1358061788df32..8849a27c80525d4d6baa2da7d7dcc584cfe636ed 100644 (file)
@@ -5,7 +5,7 @@
 \header {
     texidoc ="@cindex Feta scripts
 
-A chart showing all feta scripts.
+This chart shows all articulations, or scripts, that feta font contains.
 
 "
 }
index 6843df8b8a4189c972b46a481eb0b15212f8ff1c..cab389290eb12a6f257d800cf051913584913a19 100644 (file)
@@ -3,7 +3,7 @@
 
 \header { texidoc = "@cindex Script Priority
 Relative placements of different script types can be controlled
-by overriding script-priority. "
+by overriding @code{script-priority}. "
 }
 
 
index a1878d86c61df1e1cc5f37d280a5fe749d5cce67..d66dd97bbbca17a316f6ef3c45cdb88b9a8bbc96 100644 (file)
@@ -2,7 +2,7 @@
 \version "2.1.26"
 
 \header { texidoc = "@cindex Stacked Text Articulation
-You can stack text and articulations. "
+Text and articulations may be stacked on top of each other. "
 }
 
 \score {
index e24aadaed56aed281f87ebd8564aa9712c189f65..fb6684ab98a01fae996a630d39f04778ccd2d27b 100644 (file)
@@ -3,7 +3,8 @@
 
 \header{
 texidoc="@cindex Slur Attachment Override
-In some cases you may want to set slur attachments by hand. "
+In some cases, you may want to control the attachment points of a slur 
+by hand. "
 }
 
 
index 1b934515a98753c87a844b923d7f959a11c25faf..1ba9dda0215bae0505d048078c592dd2f7769edb 100644 (file)
@@ -1,16 +1,14 @@
 
 \version "2.1.26"
-% TODO bit too wordy; edit a bit to cut stuff.  -gp
+
 \header { texidoc ="@cindex Slur Beautiful
-Similarly, the curvature of a slur is adjusted to stay clear of note
-heads and stems.  When that would increase the curvature too much, the
-slur is reverted to its default shape.  The threshold for this
-decision is in Slur's object property @code{beautiful}.
-It is loosely related to the enclosed area between the slur and the
-notes.  Usually, the default setting works well, but in some cases you
-may prefer a curved slur when LilyPond decides for a vertically moved
-one.  You can indicate this preference by increasing the
-@code{beautiful} value."
+The curvature of a slur is adjusted to stay away from note heads and 
+stems. When the curvature would increase much, the slur is reverted 
+to its default shape.  The Slur's property @code{beautiful} (which is 
+loosely related to the enclosed area between the slur and the notes)
+controls the transition point, and by increasing that value you may
+keep slurs more curved.
+"
 }
 
 \score { \notes {\relative c' {
index cf512cb6be338c20f82199bb6381a859d68cd65c..fd597de28d9dd5aa4b977d1a0353e176ad3e87fb 100644 (file)
@@ -1,6 +1,7 @@
 \version "2.1.26"
 \header {texidoc = "@cindex Slur, dotted
-You can print different kinds of slurs (dotted, dashed, etc). "
+The appearance of slurs may be changed from solid to dotted or dashed.
+"
 } 
 \score{
        \notes{
index 50f4f79e1e5de89807d9ce4125e6c53c8ad597db..098f4a550da3298194aae99bc4f29270de882950 100644 (file)
@@ -2,14 +2,17 @@
 \header {
 
 
-    texidoc = "In extreme cases, you can resort to setting slur
-    control-points manually. This involves a lot of trial and error,
-    though. Be sure to force line breaks at both sides, since
+    texidoc = "In extreme cases, you can resort to setting the 
+    @code{control-points} of a slur manually, althout it involves 
+    a lot of trial and error. Be sure to force line breaks at both sides, since
     different horizontal spacing will require rearrangement of the
     slur."
  
     }
 
+%% This slur does not look good. Looks like there have not been a line 
+%% break at some point, it is then added, but the slur does not break 
+%% in the case of a line break. -HJJ
 
 \score {\notes \new PianoStaff  <<
     \context Staff = up { \clef bass s1 * 6 } 
index 1aabd0c6f817fe6c8c581f0ddf66c6a8ee115c67..045520ec7ac2ce0967349c28320eb1ab0b6c0c64 100644 (file)
@@ -2,7 +2,7 @@
 \version "2.1.26"
 
 \header { texidoc = "@cindex Slur Minimum Length
-You can set the minimum length of a slur. " 
+By setting the minimum length of a slur, notes are more separated. " 
 }
 
 \score{
index a1e2854fdbf52c18c2666dc97aa36ca8117c6c4a..2af89ea74a1c97d21fdbc61ff2c83832ddf84167 100644 (file)
@@ -2,7 +2,7 @@
 \version "2.1.26"
 
 \header { texidoc="@cindex Slur Ugly
-You can get ugly slurs, if you want. "
+Strange slurs can be produced by setting properties by hand. "
 }
 
 baseWalk = \notes \relative c {
index 2cad84412948974d6546b552a60bdaed09ebca64..612df905c896347d7a6eb88602f52449320bb34a 100644 (file)
@@ -3,22 +3,22 @@
 
 \header {
 texidoc="@cindex Smart Transpose
-@example
-       Here's a copy of my feature request :
-@quotation
-        Your task, if you accept it is to implement a \smarttranspose
-        command>> that would translate such oddities into more natural
-        notations. Double accidentals should be removed, as well as E-sharp
-        (-> F), bC (-> B), bF (-> E), B-sharp (-> C).
-@end quotation
-
-You mean like this. (Sorry 'bout the nuked indentation.)
-
-Modified to use the standard transpose mechanism. The question is
-how useful these enharmonic modifications are. Mats B.
-@end example
+
+There is a way to enforce enharmonic modifications for notes in order
+to have the minimum number of accidentals. In that case, ``Double 
+accidentals should be removed, as well as E-sharp (-> F), bC (-> B),
+bF (-> E), B-sharp (-> C).'', as proposed by a request for a new feature.
+In this example, the double accidentals are removed after transposing
+C scale to Ais.
+
 "
 }
+%
+% Modified to use the standard transpose mechanism. The question is
+% how useful these enharmonic modifications are. Mats B.
+% 
+% Why not to have a function that minimizes the number of accidentals? -HJJ
+i%
 
 #(define  (unhair-pitch p)
   (let* ((o (ly:pitch-octave p))
index 71aed6696607455e510043a645f832df05db8bf2..7a504e5ae080ff56a06163052176ff543bb9d2c6 100644 (file)
@@ -3,9 +3,8 @@
 % more yummy regression goodness.  -gp
 \header {
 texidoc = "
-1. Upon stretching every note should stretch according to duration.
-
-2. 8th notes should be spaced equidistantly.
+When stretching notes, every note should stretch according to its duration.
+Eighth notes should be spaced equidistantly.
 "
 }
 
index 9f933cc1bd3e40a56a70ae1c8a6a40ea9653cffd..a87d80c31c26db13ec8d1d8f04da2d6b03ee4924 100644 (file)
@@ -3,9 +3,9 @@
 
 \header { texidoc = "@cindex Spanner after break
 
-To selectively tweak spanners after the linebreaking
-process, Scheme code must be used.  In this simple example, the tie
-after the line break is moved around. "
+In order to selectively change the properties of spanners after 
+a line break, Scheme code must be used.  In thas manner, the tie
+after the line break in this example is moved around. "
 
       }
 
index cd7d6d62f27da0130e1962e8c6d11effb0297ef4..cf6ea6596c678ae365d1685c6e752479c5e6d099 100644 (file)
@@ -1,7 +1,8 @@
 \version "2.1.26"
 
 \header{texidoc = "@cindex Staff Bracket
-Here's an example of staff brackets. "
+In a music with piano accompaniment, staff brackets, like the one in 
+this example can be used. "
 }
 
 \score
index fdcedab240685fc4e725ae0c483f793dc98cc552..93b51a439830d548573ee1c6a8dd86cefad3f16b 100644 (file)
@@ -4,13 +4,14 @@
 
     texidoc = "
 
-Container by splitting the grouping (Axis_group_engraver) and creation
-functionality into separate contexts, you can override interesting
-things.
-
-Notation like this is used in modern scores. Note that LilyPond is not
-especially prepared for it: the clefs and time-signatures don't do
-what you would expect.
+In this preliminary test of a modern score, the staff lines are washed
+out temporarily. This is done by making a tuned @code{StaffContainer},
+which @code{\skip}s some notes without printing lines either and
+creates a @code{\new Staff} then in order to create the lines again.
+(Be careful if you use this; it has been done by splitting the
+grouping @code{Axis_group_engraver} and creating functionality into 
+separate contexts, but the clefs and time signatures may not do
+what you would expect.)
 
     "
 
index 54b9890d6ecd64770faa01ef49b99fb4cc9e58fe..0a68b641eb91d22c87f2db4f163a30735d73c944 100644 (file)
@@ -3,8 +3,10 @@
 
 \header {
 
-    texidoc="@cindex Staff Lines Staff symbol properties may also be
- set with @code{\\property}. "
+    texidoc="@cindex Staff Lines 
+The number of lines in a staff may changed by overriding @code{line-count}
+in the properties of @code{StaffSymbol}.
+"
          
 }
 
index 75a3c2d72341dca44f69aa5f5ecc3b9878b9d1c1..22cc273c854fcc8e88831c9bec1721e6d1b1f8d4 100644 (file)
@@ -2,8 +2,8 @@
 
 \header { texidoc = "@cindex Staff Size
 
-For setting staff sizes, both @code{staff-space} and @code{fontSize}
-must be set."
+In order to change staff sizes, both @code{staff-space} and @code{fontSize}
+must be scaled."
 
 }
 
index 183dd427fc56359ed94f696a6b40fd16a60fce75..4c4dfb88c6ad97470cb1529a49fdc2584fdc5547 100644 (file)
@@ -1,7 +1,8 @@
 \version "2.1.26"
 
 \header{ texidoc ="@cindex Staff Space
-Setting staff space on a staff. "
+By just increasing @code{staff-space} on a staff, you may produce strange
+results. "
 }
 
 \score { 
index 7c57e1ba86c9a24e156e89963cacfde66a6379db..dcc7c59bc0603c062537973084c3ea96e078d55c 100644 (file)
@@ -1,9 +1,9 @@
 \version "2.1.26"
 
 \header { texidoc = "@cindex Stem Cross Staff
-There is no support for putting chords across staves.
-You can get this result by increasing the length of the stem in the
-lower stave so it reaches the stem in the upper stave, or vice versa. "
+The chords which exceptionally cross staves may be produced by increasing 
+the length of the stem in the lower stave, so it reaches the stem in the 
+upper stave, or vice versa. "
 }
 
 stemExtend = \once \override Stem  #'length = #22
index edfdc986e8e62c5c311066aa259ed119fe1cfdd3..62c4b12d7961cf9977c54278380cca0ae25b43b0 100644 (file)
@@ -1,7 +1,8 @@
 \version "2.1.26"
 
 \header { texidoc = "@cindex Stem Extend
-You can stop LilyPond from extending stems to the center line. "
+Extending stems to the center line may be prevented using @code{no-stem-extend}.
+"
 }
 
 \score { 
index ff6e34e81f8c65661013dc42cffd91c27942fe7e..4729a6c0e07597b7c5879245508b66f28246ac54 100644 (file)
@@ -2,7 +2,7 @@
 \version "2.1.26"
 
 \header{ texidoc = "@cindex Stem Length
-You can alter the length of stems. "
+The length of stems can be altered. "
 }
 
 \score {