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 10:21:03 -0500



On Thu, Apr 23, 2015 at 9: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.
>
> Comments in the code are not the documentation I am talking about.
> The JianpuStaff should be added to the Internals Reference, and the
> documentation should be added to all of the languages of LilyPond
> documentation.
>
> 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.


Some documentation technique would be nice.  There are currently two Scheme engravers in the codebase (Measure_counter_engraver, and the Span_stem_engraver).  Allowing full inclusion of Scheme engravers would/should be an encouragement to development efforts from power users.

David 

reply via email to

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