Re: Proposal for SRFI 253: In-source documentation
Antero Mejr 25 May 2024 09:02 UTC
Retropikzel <xxxxxx@iki.fi> writes:
> What would be the implications or how/would it work if instead of #? ?# and #*
> *#, #|? ?|# and #|* *|# would be used?
#? and #* are non-nesting, but #| has nesting. That would be a tricky
difference. Nesting doesn't make sense for documentation comments.
> I'm thinking, would it make the implementations without this SRFI work and those
> who do implement this be enhanced? I'm assuming if I use #? ?# and the
> implementation does not implement this SRFI then it would error making writing
> portable code harder.
One of the goals here is a low barrier to adoption. Adding the #? and #*
extensions to a reader should only take about 20 lines of code or so,
and the rest is provided in the sample implementation. Hopefully that
will help with uptake.
Also implementations don't have to support #| comments, only R7RS or
SRFI 30 compliant implementations have to.