DOC_STRINGS_IN_COMMENTS

[Miles Bader]

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.

-Miles
-- 
Suburbia: where they tear out the trees and then name streets after them.