[Top][All Lists]

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

Re: Scheme file docstring format

From: Neil Jerram
Subject: Re: Scheme file docstring format
Date: 19 Feb 2001 22:49:13 +0000

>>>>> "Marius" == Marius Vollmer <address@hidden> writes:

    Marius> Neil Jerram <address@hidden> writes:
    >> D'oh!  The blank line between the end of the comment and the
    >> `(define ...)' should _not_ be there.

    Marius> Right, but I _like_ those blank lines...  We should
    Marius> probably recommend to use a style like this

      ;; doc doc doc doc
      (define ...)

Well I guess I do too; otherwise I wouldn't have made that slip.

Obviously the playoff here is with accidentally picking up a preceding
comment that is _not_ the docstring for a top level define.  The style
you suggest seems like a good solution to me.


reply via email to

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