[Top][All Lists]

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

Re: Scheme file docstring format

From: Martin Grabmueller
Subject: Re: Scheme file docstring format
Date: Mon, 19 Feb 2001 16:28:02 +0100

> 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.

reply via email to

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