Re: [Chicken-users] chicken symbol-table and ...

[Felix Winkelmann]

Linh Dang wrote:

> It's more than that. In my hen.el package, typing C-c C-h will would
> pop up the documentation of the symbol under the cursor. The search
> are done in this order:
>
>         - r5rs info file
>         - chicken info file
>         - SRFIs info file (if I figure a way to convert the HTML back
>           to info).

Hey, very nice.

> I know it's entirely up to you an dyou're very busy, but I wish
> that either you would either:
>
>         - use texinfo as the original format for the manual! :-)
>           texinfo is a much higher level (logical markup) language
>           than LaTeX. from TeXish pov, texinfo IS a macro package like
>           LaTeX, which means it can be compiled into hi-quality
>           dvi/pdf/html document.
>
> or
>
>         - be much more consistent with your LaTeX use. Now, some times
>           procedure/syntax are listed in `itemize' environment,
>           sometimes it's `description'! Converting to texinfo is so
>           much a pain.
>
>           The nice thing about texinfo is that you have @deffn command
>           to describe a function, @defvr for variables, @defmac for
>           macros, @defspec for special-forms and @lisp enviroment to
>           show scheme code snippets! R5RS uses texinfo as their
>           original format.
>
> Just my 0.02cents wish anyway! please don't take it as a complaint!

No, not at all. In fact I think using tex as the main documentation
format was a mistake. Since there will always be an even better
documentation format than the one chosen, I consider translating the
manual into SXML. Well, one of these days...


cheers,
felix