|
From: | David Nalesnik |
Subject: | Re: Jianpu Notation |
Date: | Thu, 23 Apr 2015 10:21:03 -0500 |
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.
[Prev in Thread] | Current Thread | [Next in Thread] |