Re: Jianpu Notation

[H. S. Teoh]

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.


T

-- 
Be in denial for long enough, and one day you'll deny yourself of things you 
wish you hadn't.