]> git.donarmstrong.com Git - lilypond.git/commitdiff
Added texidoc index and some comments.
authorGraham Percival <graham@percival-music.ca>
Fri, 20 Jun 2003 02:53:39 +0000 (02:53 +0000)
committerGraham Percival <graham@percival-music.ca>
Fri, 20 Jun 2003 02:53:39 +0000 (02:53 +0000)
43 files changed:
ChangeLog
input/test/scales-greek.ly
input/test/scales.ly
input/test/scheme-interactions.ly
input/test/script-abbreviations.ly
input/test/script-chart.ly
input/test/script-horizontal.ly
input/test/script-priority.ly
input/test/separate-staccato.ly
input/test/short-part-combine.ly
input/test/simple-slur-endings.ly
input/test/sketch.ly
input/test/slur-area.ly
input/test/slur-attachment-override.ly
input/test/slur-attachment.ly
input/test/slur-beautiful.ly
input/test/slur-broken-cross-staff.ly
input/test/slur-broken.ly
input/test/slur-damping.ly
input/test/slur-dash.ly
input/test/slur-follow-music.ly
input/test/slur-positions.ly
input/test/slur-proof.ly
input/test/slur-symmetry-2.ly
input/test/slur-symmetry-3.ly
input/test/slur-ugly.ly
input/test/smart-transpose.ly
input/test/solo-a2.ly
input/test/spacing-2.ly
input/test/span-bars.ly
input/test/spanner-after-break-tweak.ly
input/test/stacked-scripts.ly
input/test/staff-bracket.ly
input/test/staff-container.ly
input/test/staff-lines.ly
input/test/staff-margin-partial.ly
input/test/staff-size.ly
input/test/stem-centered.ly
input/test/stem-cross-staff.ly
input/test/stem-length.ly
input/test/stem.ly
input/test/system-start-brace.ly
input/test/system-start-bracket.ly

index 4712d846ba62014e253c0929528b3fad9c091b5f..861f073cab70dd32e4bba757b271814e02ec1739 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -10,6 +10,8 @@
        stem-extend was deleted (it was duplicate example, and not as
        good).
 
+       * input/test/s*.ly: add texidoc index.
+
 2003-06-20  Han-Wen Nienhuys  <hanwen@cs.uu.nl>
 
        * lily/slur.cc (get_boundary_notecolumn_y): change name from
index 9525ab11ef74cda6f95407967bda0bcf29bf3eaa..b89889e36243d12c9ff6659d4c3bf5cf9aa3ba65 100644 (file)
@@ -1,7 +1,7 @@
 \version "1.7.18"
-
 \header {
-  texidoc = "Show different scales."
+  texidoc = "@cindex Scales Greek
+Show different scales."
 }
 
 voicedefault = \notes {
@@ -54,8 +54,7 @@ voicedefault = \notes {
        }
 
     >
-       \paper {
-       }
+       \paper { }
        \midi {}
 }
 %% new-chords-done %%
index bd734a37eb3936472116b2663f80488adadef5dd..07d0c34d1580e3ae0a1cf8d1f26409d0e3630848 100644 (file)
@@ -1,5 +1,8 @@
 \version "1.7.18"
-
+% is this really useful?  candidate for long-term delete
+\header {texidoc = "@cindex Scales
+Prints scales. "
+}
 \score { 
   \context Voice \notes\relative c {
     % sharp-major 
 }
 
   \paper { }  
-  \midi { }
 }
 %% new-chords-done %%
index e9a51243b2ba801c6598dfd35dd30506ec97b999..8aabb25a00c76fe041b201fe9ce99de5745d0b18 100644 (file)
@@ -1,14 +1,10 @@
 \version "1.7.18"
-
-\header {
-
-    texidoc = "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. "
-
+\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. "
 }
 
-
 foo = \notes \transpose c c { d''4-. }
 bra = \notes \transpose c c { e'4-. }
 
@@ -22,5 +18,6 @@ bra = \notes \transpose c c { e'4-. }
       \baz
       c4
   }
+       \paper {raggedright=##t}
 }
 %% new-chords-done %%
index f84e7d070db86f0589fbe9028108e5a883f7e917..02fd19b71320a4aa5de45ea79dc09f7c22a19310 100644 (file)
@@ -1,7 +1,7 @@
 \version "1.7.18"
-
-\header {
-    texidoc = "Some scripts may be entered using an abbreviation"
+% covered by refman.  delete.  -gp
+\header { texidoc = "@cindex Script Abbreviations
+Some scripts may be entered using an abbreviation. "
 }
 
 \score {
index 86d846a68ba1fce1c347e1860c1e33f88adc8c34..36cbbc50d0811a8e321b1d47b23a18398b3a120b 100644 (file)
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% covered in refman.  delete, or move to an appendix. -gp
 \header {
     texidoc ="A chart showing all feta scripts"
 }
index ac597b765dcf92cdfc50ca3a6f849937502e9441..02990120e742ccf521d96d8328eb3f85f45e4923 100644 (file)
@@ -1,9 +1,8 @@
 \version "1.7.18"
-%{
 
-Please don't use this Scheme hacking unless you have a good reason.
-
-%}
+\header{ texidoc = "@cindex Script Horizontal
+Please don't use this Scheme hacking unless you have a good reason. "
+}
        
 \score {
        \notes \context Voice <
@@ -26,6 +25,7 @@ Please don't use this Scheme hacking unless you have a good reason.
                \consists Script_engraver
                \consists Text_engraver         
                }
+       raggedright=##t
        }
 }
 %% new-chords-done %%
index 52ff9169a4be47db381d90dc5c9efc0590d74192..e0ee7c3279f32d2920e824471d84f2fbff6118b8 100644 (file)
@@ -1,9 +1,10 @@
 \version "1.7.18"
-\header {
-    texidoc = "Relative placements of different script types can be controlled
-by overriding script-priority."
+
+\header { texidoc = "@cindex Script Priority
+Relative placements of different script types can be controlled
+by overriding script-priority. "
 }
-\paper { raggedright = ##t} 
+
 
 \score{
     \context Staff \notes \relative g''{
@@ -17,6 +18,6 @@ by overriding script-priority."
        
        a4^\prall^\markup \fontsize  #-2 \musicglyph #"accidentals-1"
     }
+       \paper { raggedright = ##t} 
 }
-
 %% new-chords-done %%
index c0d03df289beee5a2d7a4aff287acc0e282964d8..3da0c28fc6e369077dfdbcaab2bb44ac95e71ff5 100644 (file)
@@ -1,9 +1,9 @@
 \version "1.7.18"
-\header {
+% possible rename.  -gp
 
-texidoc="You can enter notes and articulations separately, and merge
+\header { texidoc="@cindex Seperate Staccato
+You can enter notes and articulations separately, and merge
 them into one thread.  Here is an example to add repeated staccato dots."
-
 } 
 
 staccatos = \notes { s4-. s-. s-. s s }
@@ -15,5 +15,6 @@ music = \notes\relative c' { c4 d e f g  a b c d e }
      \music
      \repeat unfold 2 \staccatos
    >
+       \paper{raggedright=##t}
 }
 %% new-chords-done %%
index 409cfea2445d64b6f183116d287ff379b9fda0be..89783ca084314b7ea317909bb13a25b59cb97966 100644 (file)
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% covered by part-combine.ly.  delete -gp
 
 \score{
        \context Staff <
index e69aa47499b3621d38765d9624dbf3d515a1d4d3..c4a31c55cebf657558e2fd63806aab84981d1c22 100644 (file)
@@ -1,5 +1,6 @@
 \version "1.7.18"
-
+%  regression or delete.  -gp
+\header {texidoc = ""}
 \score{
        \notes \relative c''{
                \slurUp c(a-) d(g,-)\break
index acf5c1ffe367b6464b5db03d70646eda2571e4c5..2beab50097866509d698770782e7f91c4b0e76d3 100644 (file)
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% looks like a really old file.  delete.  -gp
 \header {
 texidoc="sketch output supported features"
 }
index 8de5729562f7ff0b56085fdd02480b96268b76a9..d1bb9ddb785d671ce8855a4dcb3147be5ac411ca 100644 (file)
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% regression or delete.  -gp
 
 \score{
 \notes\relative c''{
index 431be7900bf70e7ead30c6246b8c423c7b2d95cf..fcac5a2eead651cac76b05905d86e3aad947d22a 100644 (file)
@@ -1,12 +1,10 @@
 \version "1.7.18"
 
 \header{
-texidoc="
-In some cases, you may want to set slur attachments by hand.
-"
+texidoc="@cindex Slur Attachment Override
+In some cases you may want to set slur attachments by hand. "
 }
 
-
 fragment = \notes {
   \property Voice.autoBeaming = ##f
   \property Voice.Stem \set #'direction = #1
@@ -16,10 +14,9 @@ fragment = \notes {
   d,32( f'4  d8.-)
 }
 
-\paper { raggedright = ##t} 
 
 \score {
-  \notes\relative c \fragment
-  \paper { }  
+       \notes\relative c \fragment
+       \paper { raggedright = ##t} 
 }
 %% new-chords-done %%
index 27ebf64cea01ef2ff174c42d45bd75317b11bc2b..b87da39b799ffeaffcef1570e9c18523fb863b70 100644 (file)
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% covered by slur-attachment-override.  delete  -gp
 
 fragment = \notes {
   \property Voice.Slur \set #'direction = #1
index 0aa13d9efe0c4c090a61b3ede7ab569d726a79d5..23d8e72494eb7231344ae604632583649dc3b52b 100644 (file)
@@ -1,6 +1,7 @@
 \version "1.7.18"
-\header {
-    texidoc ="Similarly, the curvature of a slur is adjusted to stay clear of note
+% 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}.
index 4342521a13df6cd6192f7b8486e28f30021d50a0..364d59af62fda294ab27085af47e58e086c5a71c 100644 (file)
@@ -1,9 +1,7 @@
 \version "1.7.18"
-\header{
-texidoc="
-The same goes for slurs. They behave decently when broken across
-linebreak.
-"
+% regression or delete.  -gp
+\header{ texidoc="
+Slur behave decently when broken across linebreak. "
 }
 
        
index 9c3a7a7c5832c686d217aebcbfb1b9fec7e67b82..7c3946cd85f2d14274f4ebd244135d1af89f3fc4 100644 (file)
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% regression or delete.  -gp
 
 \score{
        \notes\relative c''{
index e5b60babbe18c452a4c12ff2027e06a3b7a67df4..a990ddcdd1380e9cf626d09dc8bcd6d7fff208ac 100644 (file)
@@ -1,6 +1,5 @@
 \version "1.7.18"
-% test damping
-
+% delete.  -gp
 
 \score{
        \notes\relative c'{
index 4003b4d9c389c46e0de617ffec8ff6a9b8e52ec6..c50387268449250c6b7421b9fbbc21613fd42baf 100644 (file)
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% regression or delete.  -gp
 
 \score{
        \notes{
index 68d37dc286ad3c807c99402f45a5432bcf8119ec..a36300f0610aa619cc65033ed984a42736f5b5a8 100644 (file)
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% more fodder for regression.  -gp
 
 \score { 
   \context Voice \notes\relative c {
@@ -22,6 +23,5 @@
   \paper {
     raggedright = ##t
   }  
-  \midi { }
 }
 %% new-chords-done %%
index 6b1602a457b1b5feb2f37a43f972038b709355fd..48254c413d7ba0ca57c39d9db477ce1a3f8e1b05 100644 (file)
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% if this test isn't covered in regression, we're in trouble.  :)  delete.  -gp
 
 \score{
        \notes\relative c''{
index de382496c8c103316969a747302f6cb0e7a877e2..d88ff40cb8b478c42476592f57e1fe25a5cdef5a 100644 (file)
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% looks pretty, but it's for regression.  -gp
 
 x = {
   \outputproperty #(make-type-checker 'note-head-interface) 
index 676290058b8dccd9964f9b31c8c89902182c0e56..1af46ea4a43c9e9931188cf06203e036ebef73fd 100644 (file)
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% another regression.  -gp
 \header{
 % should look the same
 title="symmetry"
index ecf560284c32e727a12fd3453c8fc0784f51c713..177f4916c5641f455aeaed6af9c4a11c389af029 100644 (file)
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% regression, and should be merged with -2.
 \header{
 title="symmetry.
 
index 23ae3a50a97dde77eef19205a2fe2c6a113ab6f4..2578d4a591282c23ab9097e61ede4a3d2cd68c28 100644 (file)
@@ -1,8 +1,7 @@
 \version "1.7.18"
 
-\header {
-texidoc="You can get ugly slurs, if you want.
-"
+\header { texidoc="@cindex Slur Ugly
+You can get ugly slurs, if you want. "
 }
 
 baseWalk = \notes \relative c {
index 51b230370d9075e816397b8e541fd336beedd5d6..46fc91e10860baa6050193f966c2dd7b91681688 100644 (file)
@@ -1,7 +1,7 @@
 \version "1.7.18"
 
 \header {
-texidoc="
+texidoc="@cindex Smart Transpose
 @example
     Here's a copy of my feature request :
 @quotation
index 9df735ae0134b610977ef8e5fc46ad39450b1e00..092a98ee803a5f5937e807a231a07f032d6e4298 100644 (file)
@@ -17,6 +17,7 @@
                >
        \paper{
                linewidth = 100.\mm
+               raggedright=##t
        }
 }
 %% new-chords-done %%
index ab2c00728a4388f2b4599c320008c4c9b0b2d253..cffeb0552eb3e46181603c49271d8f9a94c59a4f 100644 (file)
@@ -1,4 +1,5 @@
 \version "1.7.18"
+% more yummy regression goodness.  -gp
 \header {
 texidoc = "
 1. upon stretching: every note should stretch according to duration
index 42f131155220ddb6b2d2df8bc0f69a2d332321d1..f3bd836de9ea609581002189a7dcfff15c4dbfbd 100644 (file)
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% regression again?  *sigh*  :)   -gp
 
 nt =  \notes { c1 \break c1 c1 } 
 stuff =  \notes \relative c'' <
index c7b80b3d5506dcd609461e5c7dec7894a90cebd2..fd10d39e0fcc34db204f901ee946c291b7925fe7 100644 (file)
@@ -1,12 +1,9 @@
 \version "1.7.21"
-\header
-{
-    
-texidoc = "To selectively tweak spanners after the linebreaking
-process, Scheme code must be used.  In this simple example, the tie
-after the line break is set transparent."
-
 
+\header { texidoc = "@cindex Spanner After Break Transparent
+To selectively tweak spanners after the linebreaking
+process, Scheme code must be used.  In this simple example, the tie
+after the line break is set transparent. "
 }
 
 \score { \notes {
index 8e38a65d7ef6f5a010166f7e8db2f3b94ed40e1e..bcb5d5ebd22652f37bebfb894a4e74d288d0cba9 100644 (file)
@@ -1,5 +1,9 @@
 \version "1.7.18"
 
+\header { texidoc = "@cindex Stacked Text Articulation
+You can stack text and articulations. "
+}
+
 \score {
        \notes {
                c2_"geen gedonder"_"jij gaat onder"
index a20e5b46b50cfa2c8fdf97b4b975005851ffdafe..dcddbc6acc196d8ec3a42d541feb9c255e2fbc36 100644 (file)
@@ -1,5 +1,9 @@
 \version "1.7.18"
 
+\header{texidoc = "@cindex Staff Bracket
+Here's an example of staff brackets. "
+}
+
 \score
 {
   \context StaffGroup = a < 
@@ -21,6 +25,7 @@
       \StaffContext
       \consists Instrument_name_engraver
     }
+       raggedright=##t
   }
 }
 %% new-chords-done %%
index d99ddc89325c5f20fe0460a3f9f55e4e325a98dd..ce8d3633d36ff183dec66ca51ea6f2b521a4fc00 100644 (file)
@@ -1,12 +1,9 @@
 \version "1.7.18"
 
-
-\header {
-
- texidoc = "By splitting the grouping (Axis_group_engraver) and
+\header { texidoc = "@cindex Staff Container
+By splitting the grouping (Axis_group_engraver) and
 creation functionality into separate contexts, you can override
-interesting things. You can also drop the \consistsend feature."
-
+interesting things. You can also drop the \consistsend feature. "
 }
 
 
@@ -35,6 +32,7 @@ interesting things. You can also drop the \consistsend feature."
                \StaffContext
                \remove Axis_group_engraver
        }
+       raggedright=##t
 }
 }
 
index 2e82997efad351247e92aa5cfd011fd256459bcc..ab0d55e09e3e9b5817bba2822fd48f09bf7fc10e 100644 (file)
@@ -1,6 +1,7 @@
 \version "1.7.18"
-\header {
-texidoc="staff symbol property set workaround"
+
+\header { texidoc="@cindex Staff Lines
+Staff symbol property set workaround. "
 }
 
 
@@ -27,6 +28,5 @@ lower = \notes\relative c {
         #'line-count = #4
     >  
   >
-  \paper { }  
-  \midi { }  
+  \paper { raggedright=##t}  
 }%% new-chords-done %%
index aad12c0e49ec1d1b8067bb3b63e9d11d0e282858..588003d2df44f28ee0a45872b4e2815dcb4f1785 100644 (file)
@@ -1,7 +1,6 @@
 \version "1.7.18"
 % test staff margin with partial measure.
-
-
+% regression.  -gp
 
 \score {
 \notes { \property Staff.instrument = "foo" \partial 4 c4 c1 }
index dbc927a9f68b6fcca7fb8aac68a9e354520005b2..650d6d49e70ca264bdcc69754ada59f5e1a18892 100644 (file)
@@ -1,10 +1,11 @@
+\version "1.7.18"
 
-\header { texidoc = "Setting staff sizes is a little clumsy.  There
+\header { texidoc = "@cindex Staff Size
+Setting staff sizes is a little clumsy.  There
 are two options: using StaffContainer and override/revert, or
-\outputproperty. Both methods are shown in this example."
+\outputproperty. Both methods are shown in this example. "
 }
 
-\version "1.7.18"
 \score {
   \notes \relative c' < \context StaffContainer = SA{
      \property StaffContainer.StaffSymbol \set #'staff-space = #(/ 16 20)
index bc9e551b52a2940ea72ba34b67c1b4ce20772764..5ca85a1418d928286236b61dc0cf9d308b9e7a18 100644 (file)
@@ -1,15 +1,18 @@
 \version "1.7.18"
+% possible rename to ancient- something.
 \header {
-    texidoc ="mensural note heads."
-    }
+    texidoc ="@cindex Ancient Mensural Note Heads
+Mensural note heads. "
+}
 
 \score {
-\notes {
-\relative c'' {
-\property Voice . NoteHead \set #'style = #'mensural
-c\maxima*1/8
-c\longa*1/4 c\breve*1/2 c1 c2 c4 c8 
-}
-}
+       \notes {
+       \relative c'' {
+               \property Voice . NoteHead \set #'style = #'mensural
+               c\maxima*1/8
+               c\longa*1/4 c\breve*1/2 c1 c2 c4 c8 
+               }
+       }
+       \paper{raggedright=##t}
 }
 %% new-chords-done %%
index da3282f4b16afb142248914f023251d2f832b531..2310911129ec48550f77f3c3b68351e18ee9ece9 100644 (file)
@@ -1,16 +1,9 @@
 \version "1.7.18"
 
-\header {
-    texidoc = "
-
+\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.
-
-@cindex  Cross staff stems
-@cindex Stems, cross staff
-
-"
+lower stave so it reaches the stem in the upper stave, or vice versa. "
 }
 
 stemExtend = \once \property Voice.Stem \override #'length  = #22
index f68697253e49383049dbe74c7832dc48b26d3cfe..7c5ad94e0381940eafdbfb18b9cae0053479c7f9 100644 (file)
@@ -1,11 +1,14 @@
 \version "1.7.18"
 
+\header{ texidoc = "@cindex Stem Length
+You can alter the length of stems. "
+}
+
 \score { 
   \context Voice \notes\relative c {
        g''4 \property Voice.Stem \set #'length = #14  g4
        \property Voice.Stem \set #'length = #3 g4  g,,4  
   }
-  \paper { }  
-  \midi { }
+  \paper { raggedright = ##t }  
 }
 %% new-chords-done %%
index d88071479300bb627bd94d2230d55a31f9fe3261..b8f6441d1042cde9ba1328b6749c047cc7ff7e53 100644 (file)
@@ -1,12 +1,11 @@
 \version "1.7.18"
-\header{
-texidoc =       "This file tests the length of stems and placement 
+% regression, _so_ regression.  :)  =-gp
+
+\header{ texidoc = "
+This file tests the length of stems and placement 
 of beams"
-  
 }
 
-
-
 beamintervals = \notes{
   \time 7/4
   \stemUp
index 70db29a0ae98b43255a88cab84be15f2aa618260..fbc93966894414b7de5db6dee4d9a2c848e79a4d 100644 (file)
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% delete.
 
 \score {
        \notes  \context PianoStaff < \context Staff = SA { s1 }
index e22710a74b77be8aefaba23dd03b329ac32f3e9c..545d5b36f55f023be82aec6c4a31470e1fa38804 100644 (file)
@@ -1,5 +1,5 @@
 \version "1.7.18"
-
+% delete.
 
 \score {
        \notes  \context StaffGroup < \context Staff = SA { s1 }