Stefan Monnier wrote:

   I've several times hesitated when writing a docstring: should it document
   the function or the command.

I normally include paragraphs saying "When used interactively..." to
document the command and "When used from Lisp..." to document the
function.  But the fact remains that for complete newbies, the Emacs
manual usually provides better documentation than docstrings.

Sincerely,

Luc.


_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel

Reply via email to