Proposal for SRFI 253: In-source documentation Antero Mejr (25 May 2024 06:19 UTC)
Re: Proposal for SRFI 253: In-source documentation Vladimir Nikishkin (25 May 2024 06:25 UTC)
Re: Proposal for SRFI 253: In-source documentation Antero Mejr (25 May 2024 06:59 UTC)
Re: Proposal for SRFI 253: In-source documentation Retropikzel (25 May 2024 06:40 UTC)
Re: Proposal for SRFI 253: In-source documentation Antero Mejr (25 May 2024 06:46 UTC)
Re: Proposal for SRFI 253: In-source documentation Retropikzel (25 May 2024 07:14 UTC)
Re: Proposal for SRFI 253: In-source documentation Antero Mejr (25 May 2024 07:32 UTC)
Re: Proposal for SRFI 253: In-source documentation Retropikzel (25 May 2024 08:19 UTC)
Re: Proposal for SRFI 253: In-source documentation Antero Mejr (25 May 2024 09:02 UTC)
Re: Proposal for SRFI 253: In-source documentation Lassi Kortela (25 May 2024 10:04 UTC)
Re: Proposal for SRFI 253: In-source documentation Jakub T. Jankiewicz (25 May 2024 09:44 UTC)
Re: Proposal for SRFI 253: In-source documentation Antero Mejr (25 May 2024 10:32 UTC)
Re: Proposal for SRFI 253: In-source documentation Jakub T. Jankiewicz (25 May 2024 11:36 UTC)
Re: Proposal for SRFI 253: In-source documentation Daphne Preston-Kendal (25 May 2024 11:06 UTC)
Re: Proposal for SRFI 253: In-source documentation Antero Mejr (25 May 2024 11:23 UTC)
Re: Proposal for SRFI 253: In-source documentation Daphne Preston-Kendal (25 May 2024 11:30 UTC)

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.