From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: npostavs@users.sourceforge.net Newsgroups: gmane.emacs.bugs Subject: bug#24459: 24.5; cl-flet and cl-labels are not properly documented Date: Mon, 19 Sep 2016 22:42:47 -0400 Message-ID: <87bmzjz3yw.fsf@users.sourceforge.net> References: <87wpi7s3lu.fsf@cochranmail.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1474339402 1107 195.159.176.226 (20 Sep 2016 02:43:22 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 20 Sep 2016 02:43:22 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) Cc: Carlos =?UTF-8?Q?Garc=C3=ADa?= , 24459@debbugs.gnu.org To: Robert Cochran Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Sep 20 04:43:17 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bmB1h-000812-1z for geb-bug-gnu-emacs@m.gmane.org; Tue, 20 Sep 2016 04:43:17 +0200 Original-Received: from localhost ([::1]:59676 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bmB1f-0002eW-Ca for geb-bug-gnu-emacs@m.gmane.org; Mon, 19 Sep 2016 22:43:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41178) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bmB1X-0002cs-01 for bug-gnu-emacs@gnu.org; Mon, 19 Sep 2016 22:43:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bmB1S-0006d4-1j for bug-gnu-emacs@gnu.org; Mon, 19 Sep 2016 22:43:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51524) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bmB1R-0006cy-UQ for bug-gnu-emacs@gnu.org; Mon, 19 Sep 2016 22:43:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bmB1R-0006yr-My for bug-gnu-emacs@gnu.org; Mon, 19 Sep 2016 22:43:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: npostavs@users.sourceforge.net Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 20 Sep 2016 02:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24459 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 24459-submit@debbugs.gnu.org id=B24459.147433935026794 (code B ref 24459); Tue, 20 Sep 2016 02:43:01 +0000 Original-Received: (at 24459) by debbugs.gnu.org; 20 Sep 2016 02:42:30 +0000 Original-Received: from localhost ([127.0.0.1]:57714 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bmB0w-0006y6-2O for submit@debbugs.gnu.org; Mon, 19 Sep 2016 22:42:30 -0400 Original-Received: from mail-it0-f54.google.com ([209.85.214.54]:37094) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bmB0u-0006xu-42 for 24459@debbugs.gnu.org; Mon, 19 Sep 2016 22:42:28 -0400 Original-Received: by mail-it0-f54.google.com with SMTP id 186so6630891itf.0 for <24459@debbugs.gnu.org>; Mon, 19 Sep 2016 19:42:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=c+SdUDSclhp5Uuyu8AAF7DjqZD4mhGMFqbH/IyrZHjc=; b=JQPb8/DltAW9v0x14P/P7U4W/hP5R1zU9rruLf4rAenhqwjoj91n3pgN5SYO061UnC KVWpUMVglOTMro67wjKMKsE0jSMYZpwCnNa5iWDskQ6lpfCyMYnXmzE9tK8kq+Xcej6f fsi+mNBlvNCw6tfJcNFERu21Tt+r8ere4N5+TiYiZuFeojd9XlEtHQcdp31FTD3soBVu 9a/CvYxOgUBcEAAM/2ketZnBy4zF9aDv+uXFqJFYXRzAzEeqY1oYnltQ/jQdSsWTVafI yRVFSbo0nepJkl6WMqTv1OFtkTQsDv6aDTKDILozrig2n/AIksl3FPu7/LQu6hvNP3dY oU9w== 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:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=c+SdUDSclhp5Uuyu8AAF7DjqZD4mhGMFqbH/IyrZHjc=; b=DzpX7EZL8Wel8RNWhNNqLstwbktpvDK2MQ9JJ/nKBIa4hGvch4RLZAU7gALGMTKJcU ajHCvmQM3nsROapHgZTwtmPulFVWLKLziYIXKsX6hPo6S2xtv05BNEtzBn5R9rMiU1jq NSlxPVnU8L88581EC6zVAFRlrAwo6guz4F0WvrKoEsYojoIS0LhIX9zkHqp11HEj2bXC nWWZs8YLFKrwoYhvFNPdDYnXI5H7zPDtWfZpNSKN9W6IcFULYPFXqSExai/p+fHH/FGS 8WD7bKDINJdzlM74Er4iFf1ZNEEDidDjv1VGJYSR0uVgq89ezs5JLqHum5oNOJ37mBTZ jn1A== X-Gm-Message-State: AE9vXwOWdHKrEAcFj3+daZ3RlmApMN6zJ0/SCCYiVRNdDa0JGep3lVG0Hmz8MfYOHNNwkQ== X-Received: by 10.36.34.204 with SMTP id o195mr1479146ito.29.1474339342424; Mon, 19 Sep 2016 19:42:22 -0700 (PDT) Original-Received: from zony ([45.2.7.130]) by smtp.googlemail.com with ESMTPSA id z125sm12061294itc.0.2016.09.19.19.42.21 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 19 Sep 2016 19:42:21 -0700 (PDT) In-Reply-To: <87wpi7s3lu.fsf@cochranmail.com> (Robert Cochran's message of "Mon, 19 Sep 2016 19:32:29 -0700") 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" Xref: news.gmane.org gmane.emacs.bugs:123465 Archived-At: Robert Cochran writes: > > As for use cases, well, I don't think that *any* docstring explicitly > spells out the 'exact purpose' of the function Docstrings indeed shouldn't be too verbose, but it may be worth linking to the CL manual which has some more details on these macros. (cl) Function Bindings, https://www.gnu.org/software/emacs/manual/html_node/cl/Function-Bindings.html