[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#22462: 25.0.50; Docstring of cl-defun/defmacro are too short
From: |
Marcin Borkowski |
Subject: |
bug#22462: 25.0.50; Docstring of cl-defun/defmacro are too short |
Date: |
Mon, 25 Jan 2016 12:04:04 +0100 |
User-agent: |
mu4e 0.9.13; emacs 25.1.50.1 |
On 2016-01-25, at 09:43, Artur Malabarba <bruce.connor.am@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