On Thu, Apr 23, 2015 at 12:34:32PM +0000, Carl Sorensen wrote: > > > On 4/22/15 10:57 PM, "Super-User" <[email protected]> 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. _______________________________________________ lilypond-user mailing list [email protected] https://lists.gnu.org/mailman/listinfo/lilypond-user
