Re: Scheme file docstring format

[Martin Grabmueller]

> From: Marius Vollmer <address@hidden>
> Date: 18 Feb 2001 23:19:41 +0100
> 
> Neil Jerram <address@hidden> writes:
> 
> > OK, I'd like to propose a format for Scheme file docstrings, and also
> > the rule for how the snarfer finds these docstrings.
> > 
> > First the format:
> > 
> > - Following the elisp coding standards, Scheme file docstrings begin
> >   with two semicolons, aligned with the following `(define ...)'.
> 
> I like your suggestion.  But Id also like to see a discussion of why
> this is better than the existing way of doing things, with a real
> string.  (I think your suggestion _is_ better, but I like to know what
> other people think.)

IMHO editing is much nicer in comments than in strings (Emacs'
indenting does work properly, etc.).  It speeds up loading the source
files, too.