On Wednesday Jul 09 2025, Matt Wette wrote:

> Apologies if I got this wrong.   I am now not sure if you are talking C
> code or Scheme.
>
> On 7/9/25 7:41 AM, Matt Wette wrote:
>> On 7/8/25 12:08 AM, Dirk-Jan C. Binnema wrote:
>>> Dear all,
>>>
>>> I'm working on a (new) guile-binding for mu[1]. I did it earlier around
>>> ~2013 or so, it's nice to see where Guile has changed (and where not)!
>>>
>>> One thing I'm not quite sure about is how to document my Guile code.
>>> What I want is:
>>>
>>
>> I developed an emacs minor mode to deal with this.  It is not yet
>> robust, but works
>> in most cases.   One writes procedure documentation as texinfo in
>> comments and
>> then runs an emacs command that generates a formatted docstring. It
>> works by
>> passing the comments through `texi2any --plaintext.
>>
>> ref: https://github.com/mwette/guile-contrib/blob/main/scheme-texidoc.el

<snip>

Oh, nice, so this semi-automatically convert ;;-style to docstring.

Perhaps this could work if there aren't too many manual steps involved
(or even doing it automatically at build-time)

Kind regards,
Dirk.

-- 
Dirk-Jan C. Binnema                  Helsinki, Finland
e:d...@djcbsoftware.nl           w:www.djcbsoftware.nl
gpg: 6987 9CED 1745 9375 0F14 DA98 11DD FEA9 DCC4 A036

Reply via email to