GNU bug report logs - #22462
25.0.50; Docstring of cl-defun/defmacro are too short

Previous Next

Full log

Message #8 received at 22462 <at> debbugs.gnu.org (full text, mbox):

From: Marcin Borkowski <mbork <at> mbork.pl>
To: Artur Malabarba <bruce.connor.am <at> gmail.com>
Cc: 22462 <at> debbugs.gnu.org
Subject: Re: bug#22462: 25.0.50; Docstring of cl-defun/defmacro are too short
Date: Mon, 25 Jan 2016 12:04:04 +0100

On 2016-01-25, at 09:43, Artur Malabarba <bruce.connor.am <at> gmail.com> wrote:

> Every time I turn to cl-defun or cl-defmacro (usually for the extra
> arglist versatility), I end up asking myself “was it &key or &keys?” or
> “what was the name of that really long option?”.
>
> Naturally, I turn to `C-h f cl-defun', only to be told that it works
> “Like normal ‘defun’, except ARGLIST allows full Common Lisp
> conventions”. That's not very helpful for someone who's not profficient
> in Common Lisp.
>
> I think there should be a link to the relevant info node and, preferably,
> a brief summary of the conventions.

+1.  And I'd vote for a summary, not a link.

Best,

-- 
Marcin Borkowski
http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski
Faculty of Mathematics and Computer Science
Adam Mickiewicz University

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.