Re: Doc of 'style ?
See commit 7e427da63980dfb6c9d1304ee189ac966c868f32 E On 7. mar. 2008, at 19:07, Graham Percival wrote: On Fri, 7 Mar 2008 13:55:49 +0100 Erlend Aasland <[EMAIL PROTECTED]> wrote: Well, here's the possible style values for these interfaces. Since english is not my main language, I leave it to somebody else to write a nice documentation string. Other doc strings were written by Han-Wen and Jan, so don't feel that they need to be in "nice English". We're never going to have so much doc help that we can be picky about this kind of thing in the IR. Please produce a full patch for this. Cheers, - Graham ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
2008/3/7, Erlend Aasland <[EMAIL PROTECTED]>: > lily/dots.cc, 2 valid styles: > vaticana and "" (an empty string) > default is "" this should really be: undefined, (if it isn't already). All styles should default 19th/20th century traditional style if undefined. -- Han-Wen Nienhuys - [EMAIL PROTECTED] - http://www.xs4all.nl/~hanwen ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
On Fri, 7 Mar 2008 13:55:49 +0100 Erlend Aasland <[EMAIL PROTECTED]> wrote: > Well, here's the possible style values for these interfaces. Since > english is not my main language, I leave it to somebody else to > write a nice documentation string. Other doc strings were written by Han-Wen and Jan, so don't feel that they need to be in "nice English". We're never going to have so much doc help that we can be picky about this kind of thing in the IR. Please produce a full patch for this. Cheers, - Graham ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
2008/3/7, Rune Zedeler <[EMAIL PROTECTED]>: > Quoting Valentin Villenave <[EMAIL PROTECTED]>: > > > I can't wait to see how a "bezier-sandwich" looks like! :) > > That would be a tie/slur :-) Oh, I see... what a self-explanatory name then :) > The top edge of the slur is a bezier, the bottom is a bezier where the > control > points are just a bit different. Therefore "bezier-sandwich". I get it. However, perhaps you'll agree with me when I say this could be better documented; besides, by documenting it we could also help users to tweak these stencils themselves. Currently, the only stencil property that is really well documented is text-interface, which is already very useful as it allows users to replace anything by any text or musicglyph they want; if other stencil possibilities were documented as well, users could even replace a TrillSpanner by a slur, and tweak this slur the way they'd want :) (side-question: how the hell can we achieve what Haipeng is asking for??? -- but that's another story) Cheers, Valentin ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
On 07/03/2008, Rune Zedeler wrote: > That would be a tie/slur :-) > > The top edge of the slur is a bezier, the bottom is a bezier where the > control > points are just a bit different. Therefore "bezier-sandwich". What about a thing called doubleSlurs that creates slurs on top of and under a musical expression. That's a real sandwich. :-) OT: Is it possible to tweak just one of the slurs in doubleSlurs? Does override change both simultaneously? -Risto ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
Quoting Valentin Villenave <[EMAIL PROTECTED]>: > I can't wait to see how a "bezier-sandwich" looks like! :) That would be a tie/slur :-) The top edge of the slur is a bezier, the bottom is a bezier where the control points are just a bit different. Therefore "bezier-sandwich". -Rune ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
Hi, On 7. mar. 2008, at 13:18, Mats Bengtsson wrote: […] the documentation of style is missing in the following interfaces: custos-interface, system-start-delimiter-interface, dots-interface. Anybody interested in doing some detective work in the C++ source code to figure out what should be written in the documentation string for these interfaces? Well, here's the possible style values for these interfaces. Since english is not my main language, I leave it to somebody else to write a nice documentation string. lily/dots.cc, 2 valid styles: vaticana and "" (an empty string) default is "" lily/system-start-delimiter.cc, 4 valid styles: bracket, brace, bar-line & line-bracket no default value (is bar-line an ok default value?) lily/custos-interface, 4 valid styles: mensural, vaticana, medicaea and hufnagel default is mensural Erlend /Mats ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
Bertalan Fodor (LilyPondTool) wrote: As I know the stencil callback is unfortunately C code. So the valid styles are only present in the C sources. That's a drawback of the current documentation system. It's not really that bad, see http://lists.gnu.org/archive/html/lilypond-devel/2008-03/msg00013.html I made a quick search and notice that the documentation of style is missing in the following interfaces: custos-interface, system-start-delimiter-interface, dots-interface. Anybody interested in doing some detective work in the C++ source code to figure out what should be written in the documentation string for these interfaces? /Mats ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
Valentin Villenave wrote: An additional question: are the spanner styles documented anywhere? When I tried to answer Haipeng on -user, I browsed the Internals Reference but couldn't find anything else than: style (symbol): 'line This setting determines in what style a grob is typeset. Valid choices depend on the stencil callback reading this property. Yes, so the next step in you search for the answer should be to check what the value of stencil is for this particular grob. For example, for a TextSpanner, the value is ly:line-spanner::print. Therefore, click on the line-spanner-interface, where you will find the answer to your question. The documentation of the style property should perhaps be extended by something like "... reading this property, see the documentation of the interface that seems most related to the current setting of the stencil property." ... I can't wait to see how a "bezier-sandwich" looks like! :) That's the stencil type used for slurs, so you have already seen lots of them. /Mats ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
As I know the stencil callback is unfortunately C code. So the valid styles are only present in the C sources. That's a drawback of the current documentation system. Bert Valentin Villenave wrote: An additional question: are the spanner styles documented anywhere? When I tried to answer Haipeng on -user, I browsed the Internals Reference but couldn't find anything else than: style (symbol): 'line This setting determines in what style a grob is typeset. Valid choices depend on the stencil callback reading this property. So I browsed the source files, trying to get a list of possible stencil callbacks; I found these in define-sencil-commands.scm: (map ly:register-stencil-expression '(beam bezier-sandwich blank bracket char circle dashed-line dashed-slur dot draw-line embedded-ps glyph-string named-glyph path polygon repeat-slash resetcolor round-filled-box setcolor text url-link utf-8-string white-dot white-text zigzag-line grob-cause no-origin placebox unknown delay-stencil-evaluation )) I can't say I have any idea of to use them. I looked in output-ps.scm, but that didn't really help. Can anyone help me to document it? I can't wait to see how a "bezier-sandwich" looks like! :) Cheers, Valentin ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel -- LilyPondTool is the editor for LilyPond files. See http://lilypondtool.organum.hu ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
An additional question: are the spanner styles documented anywhere? When I tried to answer Haipeng on -user, I browsed the Internals Reference but couldn't find anything else than: style (symbol): 'line This setting determines in what style a grob is typeset. Valid choices depend on the stencil callback reading this property. So I browsed the source files, trying to get a list of possible stencil callbacks; I found these in define-sencil-commands.scm: (map ly:register-stencil-expression '(beam bezier-sandwich blank bracket char circle dashed-line dashed-slur dot draw-line embedded-ps glyph-string named-glyph path polygon repeat-slash resetcolor round-filled-box setcolor text url-link utf-8-string white-dot white-text zigzag-line grob-cause no-origin placebox unknown delay-stencil-evaluation )) I can't say I have any idea of to use them. I looked in output-ps.scm, but that didn't really help. Can anyone help me to document it? I can't wait to see how a "bezier-sandwich" looks like! :) Cheers, Valentin ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
As a general rule of thumb, if a snippet has made its way into input/lsr/ but we haven't covered that section in GDP yet, I wouldn't bother saying that it should be in the manual. In the case of Rhythms, we're still working on Tuplets. We probably won't get to rests for at least another week. In this case, the snippet is more about Ancient notation, so we're looking at two months at least. Cheers, - Graham On Mon, 03 Mar 2008 11:40:49 +0100 Mats Bengtsson <[EMAIL PROTECTED]> wrote: > As a starting point, I have added a list of possible values for the > style property > in rest-interface and stem-tremolo-interface, respectively. > > I also recommend to include input/lsr/rest-styles.ly in the manual. > > /Mats > > Han-Wen Nienhuys wrote: > > 2008/2/27, Rune Zedeler <[EMAIL PROTECTED]>: > > > >> Is the 'style-setting documented anywhere? > >> E.g. to get the old quarter rest I had to read the source code of > >> rest.cc to see that the correct style was #'classical > >> > >> Is this documented somewhere? > >> > > > > it should be documented in the rest-interface, I suppose. Since > > style is shared by many interfaces, appropriate values should be > > documented in the respective grob-interface. > > > > > > -- > = > Mats Bengtsson > Signal Processing > School of Electrical Engineering > Royal Institute of Technology (KTH) > SE-100 44 STOCKHOLM > Sweden > Phone: (+46) 8 790 8463 > Fax: (+46) 8 790 7260 > Email: [EMAIL PROTECTED] > WWW: http://www.s3.kth.se/~mabe > = > > > > ___ > lilypond-devel mailing list > lilypond-devel@gnu.org > http://lists.gnu.org/mailman/listinfo/lilypond-devel ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
2008/3/3, Mats Bengtsson <[EMAIL PROTECTED]>: > I also recommend to include input/lsr/rest-styles.ly in the manual. As it's already tagged as "docs" and included in the tarball, there should be no problem doing so. Cheers, Valentin ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
As a starting point, I have added a list of possible values for the style property in rest-interface and stem-tremolo-interface, respectively. I also recommend to include input/lsr/rest-styles.ly in the manual. /Mats Han-Wen Nienhuys wrote: 2008/2/27, Rune Zedeler <[EMAIL PROTECTED]>: Is the 'style-setting documented anywhere? E.g. to get the old quarter rest I had to read the source code of rest.cc to see that the correct style was #'classical Is this documented somewhere? it should be documented in the rest-interface, I suppose. Since style is shared by many interfaces, appropriate values should be documented in the respective grob-interface. -- = Mats Bengtsson Signal Processing School of Electrical Engineering Royal Institute of Technology (KTH) SE-100 44 STOCKHOLM Sweden Phone: (+46) 8 790 8463 Fax: (+46) 8 790 7260 Email: [EMAIL PROTECTED] WWW: http://www.s3.kth.se/~mabe = ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: Doc of 'style ?
2008/2/27, Rune Zedeler <[EMAIL PROTECTED]>: > Is the 'style-setting documented anywhere? > E.g. to get the old quarter rest I had to read the source code of > rest.cc to see that the correct style was #'classical > > Is this documented somewhere? it should be documented in the rest-interface, I suppose. Since style is shared by many interfaces, appropriate values should be documented in the respective grob-interface. -- Han-Wen Nienhuys - [EMAIL PROTECTED] - http://www.xs4all.nl/~hanwen ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel