|
From: | David Nalesnik |
Subject: | Re: Jianpu Notation |
Date: | Thu, 23 Apr 2015 11:52:32 -0500 |
On Thu, Apr 23, 2015 at 11:07 AM, Carl Sorensen <address@hidden> wrote:
On 4/23/15 7: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.
>>
>>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.
Yes, it's certainly possible. And it can be done automatically (not from
comments) because the information is in Scheme structures with known
syntax.
[Prev in Thread] | Current Thread | [Next in Thread] |