[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: SRFI-108/SRFI-109 special characters

This page is part of the web mail archives of SRFI 108 from before July 7th, 2015. The new archives for SRFI 108 contain all messages, not just those from before July 7th, 2015.



On Sat, Nov 24, 2012 at 6:21 PM, Per Bothner <per@xxxxxxxxxxx> wrote:

I think your remark that Scribble-style is not really compatible with
Scribble is enough to sink the idea.  It's hard to maintain two subtly
different lexical syntaxes in one's head.  The XML-style is really not
much like XML, and creates no mental conflicts.

I'd be curious to hear from people with Scribble experience.  Would you
rather have something that is similar to Scribble, but not 100% the same
syntax, or something totally different?

Chibi uses a Scribble-variant for its documentation
and I'm quite happy with it.  The only thing it doesn't
do is automatic removal of leading whitespace up to
the point where a form was started, which is complicated
and I'm not entirely sure a good idea - you can always
strip later.  It's otherwise 100% Scribble though.

I've never had cause to use Scribble in Racket or Ikarus.
Since it's mostly for documentation, it's unlikely I will.

So to answer your question, in my limited experience
similar is good enough.  But if we start sharing code
more often things could be different.

-- 
Alex