IRC channel logs

2025-12-20.log

back to list of logs

<rlb>ieure: some of the module-related bits are just not well documented yet.
<rlb>I've needed to poke around in boot-9.scm myself, more than once.
<cow_2001>is there no way to attach docstrings to forms?
<cow_2001>procedures may have the documentation procedure property
<identity>cow_2001: afaik you can attach docstrings only to functions
<cow_2001>been thinking of how one might define docstrings for syntax and maybe (define-doc foo "FOO is a syntactic form or whatever that does x y and z.") (define-syntax foo ...) could work?
<cow_2001>i mean, from the point of view of a user
<cow_2001>if the first object of a procedure definition's body is a string, it'll be the docstring of that procedure, but it's not that easy for syntax definitions
<mwette>there are object properties
<mwette>(define document (make-object-property)) (set! (document) form "bla")
<mwette>er, (set! (document form) "bla")
<mwette>(document form) => "bla"
<rlb>cow_2001: depending on what you're looking for, possibly related: https://codeberg.org/guile/guile/pulls/73