From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#12884: 24.2.50; defun*: argument lists in documentation look terrible Date: Wed, 14 Nov 2012 22:51:09 +0100 Message-ID: <87wqxnkg4y.fsf@web.de> References: <87ip985dyf.fsf@web.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1352929892 28510 80.91.229.3 (14 Nov 2012 21:51:32 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 14 Nov 2012 21:51:32 +0000 (UTC) To: 12884@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Nov 14 22:51:42 2012 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 1TYks2-0000l8-Db for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Nov 2012 22:51:42 +0100 Original-Received: from localhost ([::1]:43344 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYkrs-0006GK-OH for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Nov 2012 16:51:32 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:36337) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYkrn-0006Fg-Sf for bug-gnu-emacs@gnu.org; Wed, 14 Nov 2012 16:51:30 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TYkrk-0003ez-QB for bug-gnu-emacs@gnu.org; Wed, 14 Nov 2012 16:51:27 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:60875) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYkrk-0003eu-MT for bug-gnu-emacs@gnu.org; Wed, 14 Nov 2012 16:51:24 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TYksL-0007mV-QS for bug-gnu-emacs@gnu.org; Wed, 14 Nov 2012 16:52:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 14 Nov 2012 21:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12884 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.135292988429855 (code B ref -1); Wed, 14 Nov 2012 21:52:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 14 Nov 2012 21:51:24 +0000 Original-Received: from localhost ([127.0.0.1]:42892 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TYkrk-0007lU-37 for submit@debbugs.gnu.org; Wed, 14 Nov 2012 16:51:24 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:48484) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TYkrh-0007lN-VG for submit@debbugs.gnu.org; Wed, 14 Nov 2012 16:51:23 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TYkr3-0003Vy-FF for submit@debbugs.gnu.org; Wed, 14 Nov 2012 16:50:44 -0500 Original-Received: from lists.gnu.org ([208.118.235.17]:52521) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYkr3-0003Vu-C2 for submit@debbugs.gnu.org; Wed, 14 Nov 2012 16:50:41 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:36102) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYkr0-0005xO-9W for bug-gnu-emacs@gnu.org; Wed, 14 Nov 2012 16:50:41 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TYkqx-0003Tl-6r for bug-gnu-emacs@gnu.org; Wed, 14 Nov 2012 16:50:38 -0500 Original-Received: from mout.web.de ([212.227.15.4]:59787) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TYkqw-0003TP-UW for bug-gnu-emacs@gnu.org; Wed, 14 Nov 2012 16:50:35 -0500 Original-Received: from drachen.dragon ([89.204.137.194]) by smtp.web.de (mrweb003) with ESMTPA (Nemesis) id 0MCIoz-1TQGWe0yoL-009Aez; Wed, 14 Nov 2012 22:50:33 +0100 In-Reply-To: (Stefan Monnier's message of "Wed, 14 Nov 2012 14:49:08 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) X-Provags-ID: V02:K0:Q638WF2wWf963HXv9Y9/LYlihvZJ+YXEtkpaC+YwHC5 E9UloyzSPCN0ghRJNNy1Xae/uYiJK+l8S47+uryZ83PtypR3bD X3uo+IkucIvJ1tEjly0xld8JovYQsUPKjcRWSPGda5aWhEvUdf 5DT2ahsn01G5G7fZsoI3je9gY9fLntqeURImFkxWQ6A3qmWBzY ofwFckED0jABRzVlxy8UXl/irGwiDWFqk3ISTocjnc= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: -3.4 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-Spam-Score: -4.2 (----) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 140.186.70.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:66936 Archived-At: Stefan Monnier writes: > > | (my-toggle-item #:MODE-OR-VAR &key ((:selected #:ENABLED-SPEC) (\` > > | (am-bound-and-true-p (quote (\, mode-or-var))))) ((:help > > | #:HELP-STRING) (am-make-symbol-docstring mode-or-var))) > > Let me just say that I will resist the urge to tell you what I think > about this style of argument list ;-) Please don't resist. What's wrong with it? > > This looks terrible with all this #: and quote \, stuff. > > Binding print-quoted makes sense to improve the quote/backquote syntax. > But I don't understand why we have those #: in there. I understand it's > there to say the symbols are not interned, but I don't understand why > they're not interned. See `cl--make-usage-args'. It upcases the names of the arguments and makes them a symbol again. The one who wrote that wanted that no new symbols are interned, and so used `make-symbol'. Dunno if there's a reason to do so. - Michael.