On Thu, Apr 23, 2015 at 9:55 AM, H. S. Teoh <hst...@quickfur.ath.cx> wrote:
> On Thu, Apr 23, 2015 at 12:34:32PM +0000, Carl Sorensen wrote: > > > > > > On 4/22/15 10:57 PM, "Super-User" <david...@qq.com> 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
_______________________________________________ lilypond-user mailing list lilypond-user@gnu.org https://lists.gnu.org/mailman/listinfo/lilypond-user