Re: DOC_STRINGS_IN_COMMENTS

[Gerd Moellmann]

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.