[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: DOC_STRINGS_IN_COMMENTS
From: |
Gerd Moellmann |
Subject: |
Re: DOC_STRINGS_IN_COMMENTS |
Date: |
14 Oct 2001 14:52:05 +0200 |
User-agent: |
Gnus/5.09 (Gnus v5.9.0) Emacs/21.1.50 |
Miles Bader <address@hidden> writes:
> I'm a bit confused by this change:
>
> 2001-10-13 Gerd Moellmann <address@hidden>
>
> * lisp.h (DEFUN, DEFVAR_LISP, ...) [DOC_STRINGS_IN_COMMENTS]:
> Provide definitions for doc strings in comments.
> * fns.c: Put doc strings in comments.
>
> I can understand why it might be good to put the doc-strings inside of
> comments (e.g., no annoying \n\ at the end of every line), but why
> change the DEFUN macro? Why not just put the comment-form doc-string in
> the same place the old string-form used to be? Not only would this be
> less confusing for people used to the old type of DEFUN, but it would
> have the rather big advantage of not requiring entire files to be
> converted en-mass.
This would mean the last macro arg of DEFUN and alike would be empty,
for example in `DEFxxx ("my-var", ..., /* ... */)'. Empty macro
args are not supported by all compilers.
- DOC_STRINGS_IN_COMMENTS, Miles Bader, 2001/10/14
- Re: DOC_STRINGS_IN_COMMENTS,
Gerd Moellmann <=
- Re: DOC_STRINGS_IN_COMMENTS, Miles Bader, 2001/10/14
- Re: DOC_STRINGS_IN_COMMENTS, Gerd Moellmann, 2001/10/15
- Re: DOC_STRINGS_IN_COMMENTS, Miles Bader, 2001/10/15
- Re: DOC_STRINGS_IN_COMMENTS, Richard Stallman, 2001/10/16
- Re: DOC_STRINGS_IN_COMMENTS, Gerd Moellmann, 2001/10/16
- Re: DOC_STRINGS_IN_COMMENTS, Miles Bader, 2001/10/16
- Re: DOC_STRINGS_IN_COMMENTS, Miles Bader, 2001/10/16
- Re: DOC_STRINGS_IN_COMMENTS, Pavel JanÃk, 2001/10/16
- Re: DOC_STRINGS_IN_COMMENTS, Miles Bader, 2001/10/16
- Re: DOC_STRINGS_IN_COMMENTS, Richard Stallman, 2001/10/16