[Top][All Lists]

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

Re: iff?

From: Matthias Koeppe
Subject: Re: iff?
Date: 25 Apr 2001 12:32:42 +0200
User-agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.6

Ivan Toshkov <address@hidden> writes:

> I think one of the best features of using docstrings as they are is that
> the function remains (or could remain) portable scheme code.  If Guile
> should use another approach, it should become an SRFI.

Indeed, but even the current practice of including docstrings as the
first body form is non-portable when internal defines are used, like this:

        (define (foo)
          "Doc string"
          (define (local) ...)

Guile accepts these defines as if they were at the beginning of the

It should be pointed out in the documentation that this construction
is non-portable.

There should be an advertised shorthand for (set-object-property!
OBJECT 'documentation DOC), which should be used when internal defines
are present.  It would also come handy for documenting non-procedures,
like macros or syntaxes.

Matthias Köppe --

reply via email to

[Prev in Thread] Current Thread [Next in Thread]