>
> On a related note, I've found that looking at the various interface links
> shown at the bottom of the grob properties pages can lead to otherwise
> unknown definitions to cryptic properties. For example, on the Slur
> properties page (
> http://lilypond.org/doc/v2.19/Documentation/internals/slur),
> you'll see the major properties' default values. However, the "details"
> property is just a list with no explanation. What to do now? You'll notice
> that there are a handful of interfaces shown at the bottom, including:
> - grob-interface
> - outside-staff-interface
> - slur-interface
> - spanner-interface
>
> The properties come from these interfaces. If you click on the
> slur-interface link (
> http://lilypond.org/doc/v2.19/Documentation/internals/slur_002dinterface),
> then you'll happily notice that each of the "detail" properties have a
> description. Whoa! I think you'll find this little tactic helpful in the
> future.


Thanks, this provides more clue than the raw scm files.



> Should there be a section about how to handle all the intricacies
> of slurs? Maybe... Probably? Either way, you now at least have more
> understanding as to what the properties mean. It may lead one of YOU to
> write the section about mastering slurs in every way... Or maybe a
> tutorial...
>
> Best,
> Abraham
>
>
Yes, it is best to simply produce better docs rather than rant.


So, in response to Carl's doc patch, here are my thoughts:

\version "2.19.15"

%{

    Examples most usefully demonstrate common cases for why you would want
to adjust slurs.
    Iin addition to a tame example, so you can see how these global
adjustments affect slurs that don't really need adjustment.

    These are when there is more vertical distance to cover
    and avoiding accidentals. (Is there some other way to do that
automatically?)

    Secondly, I think it makes sense to demonstrate reasonable ranges for
the values, including the defaults
    This helps folks from having to guess from scratch at what the units
mean\
%}

music = \relative { g''2( a ) | b,8 ( fis ) g-. ( [ e'-. b'-. ] a-. [ f?-.
d-. ] ) | c2 ( ~ \tuplet 3/2 { c8 g e } c4 ) | \break }

\layout {
  indent = 1\cm
  short-indent = 1\cm
}

\score {
  \relative {

    <>^"default: height-limit = 2"
    \music \bar "||"

    <>^"height-limit = 4"
    \override Slur.height-limit = 4
    \music \bar "||"

    <>^"height-limit = 6"
    \override Slur.height-limit = 6
    \music \bar "|."
  }
}

\score {
  \relative {

    %  the problem with examples for ratio
    %  is that the ratio doesn't really come into play unless the
height-limit is larger.

    \override Slur.height-limit = 5

    <>^"height-limit=5, default: ratio=0.36"
    \music \bar "||"

    <>^"ratio = 0.44"
    \override Slur.ratio = 0.44
    \music \bar "||"

    <>^"ratio = 0.52"
    \override Slur.ratio = 0.52
    \music \bar "|."
  }
}

\score {
  \relative {

    <>^"default: free-head-distance=0.3"
    \music \bar "||"

    <>^"free-head-distance = 0.7"
    \override Slur.details.free-head-distance = 0.7
    \music \bar "||"

    <>^"free-head-distance = 1.5"
    \override Slur.details.free-head-distance = 1.5
    \music \bar "|."
  }
}


David Elaine Alt
415 . 341 .4954                                           "*Confusion is
highly underrated*"
[email protected]
self-immolation.info
skype: flaming_hakama
Producer ~ Composer ~ Instrumentalist
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
_______________________________________________
lilypond-user mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/lilypond-user

Reply via email to