[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.
- Re: Scheme file docstring format, (continued)
Re: Scheme file docstring format, Martin Grabmueller, 2001/02/17
Re: Scheme file docstring format, Marius Vollmer, 2001/02/18
Re: Scheme file docstring format, Keisuke Nishida, 2001/02/22
Re: Scheme file docstring format, thi, 2001/02/18