From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Artur Malabarba Newsgroups: gmane.emacs.bugs Subject: bug#22462: 25.0.50; Docstring of cl-defun/defmacro are too short Date: Mon, 25 Jan 2016 08:43:13 +0000 Message-ID: <87d1sqqcbi.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1453718667 25670 80.91.229.3 (25 Jan 2016 10:44:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 25 Jan 2016 10:44:27 +0000 (UTC) To: 22462@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 25 11:44:15 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aNed0-00046X-QY for geb-bug-gnu-emacs@m.gmane.org; Mon, 25 Jan 2016 11:44:11 +0100 Original-Received: from localhost ([::1]:37040 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNecz-0003jm-Ub for geb-bug-gnu-emacs@m.gmane.org; Mon, 25 Jan 2016 05:44:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37590) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNecv-0003fs-Bc for bug-gnu-emacs@gnu.org; Mon, 25 Jan 2016 05:44:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aNecs-0004v1-3R for bug-gnu-emacs@gnu.org; Mon, 25 Jan 2016 05:44:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:47270) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNecr-0004ux-Vb for bug-gnu-emacs@gnu.org; Mon, 25 Jan 2016 05:44:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aNecr-000391-Oa for bug-gnu-emacs@gnu.org; Mon, 25 Jan 2016 05:44:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Artur Malabarba Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 25 Jan 2016 10:44:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 22462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.145371863012055 (code B ref -1); Mon, 25 Jan 2016 10:44:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 25 Jan 2016 10:43:50 +0000 Original-Received: from localhost ([127.0.0.1]:35490 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aNecg-00038N-N8 for submit@debbugs.gnu.org; Mon, 25 Jan 2016 05:43:50 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:46485) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aNece-000389-Vj for submit@debbugs.gnu.org; Mon, 25 Jan 2016 05:43:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aNecY-0004rm-TQ for submit@debbugs.gnu.org; Mon, 25 Jan 2016 05:43:43 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:44927) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNecY-0004ri-QQ for submit@debbugs.gnu.org; Mon, 25 Jan 2016 05:43:42 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37441) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNecX-0003O5-TW for bug-gnu-emacs@gnu.org; Mon, 25 Jan 2016 05:43:42 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aNecU-0004r4-GO for bug-gnu-emacs@gnu.org; Mon, 25 Jan 2016 05:43:41 -0500 Original-Received: from mail-qg0-x22f.google.com ([2607:f8b0:400d:c04::22f]:33472) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNecU-0004r0-CM for bug-gnu-emacs@gnu.org; Mon, 25 Jan 2016 05:43:38 -0500 Original-Received: by mail-qg0-x22f.google.com with SMTP id b35so104731963qge.0 for ; Mon, 25 Jan 2016 02:43:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:subject:date:message-id:mime-version:content-type :content-transfer-encoding; bh=opJP1MalgA6GVGlU4xaLLeuuZ6TogFjB3XFxH0OkTaM=; b=TM4zzq68gqrcJqCMvXBcD1AFC6hB9QYtzIGZ+wp2WLxNTEIk9xdJziUeuI1sQKJSKs AC76L+GSaB8jNIqng1HOSwqB1i9/l6GAuzlsD/qGqU9bVjxUJ/D1cBXwS+ioxoVBFyyi LVnCKsX56Yt0OLSCB+OGqpFC1QSE18+tc2GmRzn1wr60F2lhqSw/z8gQZWt3ACvp8sK9 rxVLX5ocoju+xLVXWaT549xYEYDppGi2l08QhX5k0pZsGeCjN0PBqXWrIp7gtVc/iZTY V8qmxoa31HoN2hwuMzA/FVGt0Ygq8x3NrDuJEj/O0gibJEL9mn1e/Lb3+fCfS0CyRATU tILg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:from:to:subject:date:message-id :mime-version:content-type:content-transfer-encoding; bh=opJP1MalgA6GVGlU4xaLLeuuZ6TogFjB3XFxH0OkTaM=; b=C2tSg6FN6hM57F/Kd2GjNthew6V+2IHbSyrgXkMyHTD3+HGMyoxAd39UdmMqwgTqKs 0xV+I2J4yrbr4GmM5z+1/vJsi2My1xVh1rhr9BcaCuqK9Y6ynALryDxTQfqOQIU6Bg0P lmVFHqdM1tcKP1yGm5hhYJr0b++W3n3A+5QUVoFeAqfuMlCjQzGkCV1USTe9X8jPQYoB KI0qi6LxKF4+TL+Z3hMrA/nY1tPwpH2TZXp+z5nrzcveVM+K7cW/QuQ6Aae883W/DsX+ X8Wzklg2I01UuNOFuppib3i+9V4+3HM1v+3Vzs5fpkbsg3AwvRZ3xUU98RlWyrXgexYF Ekmg== X-Gm-Message-State: AG10YOSpfV+JvABlC6tbfK59U9nX//jC1kL1Rel0Lt6lXEsyVL865d5/A7VDVSLmCRKSug== X-Received: by 10.140.104.100 with SMTP id z91mr20191872qge.26.1453718617658; Mon, 25 Jan 2016 02:43:37 -0800 (PST) Original-Received: from Gandalf-Linux.gmail.com ([201.37.162.188]) by smtp.gmail.com with ESMTPSA id r8sm8444258qha.47.2016.01.25.02.43.35 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 25 Jan 2016 02:43:37 -0800 (PST) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:111957 Archived-At: Every time I turn to cl-defun or cl-defmacro (usually for the extra arglist versatility), I end up asking myself =E2=80=9Cwas it &key or &keys?= =E2=80=9D or =E2=80=9Cwhat was the name of that really long option?=E2=80=9D. Naturally, I turn to `C-h f cl-defun', only to be told that it works =E2=80=9CLike normal =E2=80=98defun=E2=80=99, except ARGLIST allows full Co= mmon Lisp conventions=E2=80=9D. That's not very helpful for someone who's not proffic= ient in Common Lisp. I think there should be a link to the relevant info node and, preferably, a brief summary of the conventions.