lilypond-user
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Jianpu Notation


From: David Nalesnik
Subject: Re: Jianpu Notation
Date: Thu, 23 Apr 2015 11:52:32 -0500



On Thu, Apr 23, 2015 at 11:09 AM, David Nalesnik <address@hidden> wrote:


On Thu, Apr 23, 2015 at 11:07 AM, Carl Sorensen <address@hidden> wrote:


On 4/23/15 7:55 AM, "H. S. Teoh" <address@hidden> wrote:

>On Thu, Apr 23, 2015 at 12:34:32PM +0000, Carl Sorensen wrote:
>>
>>
>> On 4/22/15 10:57 PM, "Super-User" <address@hidden> wrote:
>>
>> >Seheme, as a dialect of Lisp, can be annotated with ;; so that our
>> >Scheme codes implementing Jianpu can be documented as well.
>>
>>But the Internals Reference (IR) is automatically generated from the
>> C++ source code of the engravers.  And we don't have any automatic
>> tools to generate IR references from Scheme engravers.
>[...]
>
>It should be possible, right? At the very least, we could use a fixed
>format, say for the comment header in the .scm file of the engraver, and
>use a script to extract and format that into documentation.

Yes, it's certainly possible.  And it can be done automatically (not from
comments) because the information is in Scheme structures with known
syntax.

I think there would need to be an enhancement of the mechanism for creating Scheme engravers, though.  C++ engravers have an _expression_ at their ends such as the following (in lily/slur-engraver.cc):

ADD_TRANSLATOR (Slur_engraver,
                /* doc */
                "Build slur grobs from slur events.",

                /* create */
                "Slur ",

                /* read */
                "slurMelismaBusy "
                "doubleSlurs ",

                /* write */
                ""
               );

Checking the documentation for Slur_engraver shows how this is used.  See:

http://www.lilypond.org/doc/v2.18/Documentation/internals/slur_005fengraver

--David


reply via email to

[Prev in Thread] Current Thread [Next in Thread]