From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#21225: 25.0.50; doc strings of `define-obsolete-*' Date: Tue, 11 Aug 2015 12:07:46 -0400 Message-ID: References: <7ec85eda-d5e0-4bda-8dba-4a75fe5f93e5@default> <7c3e32cc-1fec-4675-b330-5affa4452e95@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1439309306 10280 80.91.229.3 (11 Aug 2015 16:08:26 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 11 Aug 2015 16:08:26 +0000 (UTC) Cc: 21225@debbugs.gnu.org To: Artur Malabarba Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Aug 11 18:08:12 2015 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 1ZPC60-0000fv-4h for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Aug 2015 18:08:12 +0200 Original-Received: from localhost ([::1]:35118 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZPC5z-00014b-Fh for geb-bug-gnu-emacs@m.gmane.org; Tue, 11 Aug 2015 12:08:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59534) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZPC5v-00014J-Pl for bug-gnu-emacs@gnu.org; Tue, 11 Aug 2015 12:08:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZPC5q-0001OE-Nh for bug-gnu-emacs@gnu.org; Tue, 11 Aug 2015 12:08:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:32985) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZPC5q-0001O1-Ks for bug-gnu-emacs@gnu.org; Tue, 11 Aug 2015 12:08:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1ZPC5q-0008HJ-DY for bug-gnu-emacs@gnu.org; Tue, 11 Aug 2015 12:08:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 11 Aug 2015 16:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21225 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 21225-submit@debbugs.gnu.org id=B21225.143930926931795 (code B ref 21225); Tue, 11 Aug 2015 16:08:02 +0000 Original-Received: (at 21225) by debbugs.gnu.org; 11 Aug 2015 16:07:49 +0000 Original-Received: from localhost ([127.0.0.1]:53428 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZPC5d-0008Gl-DH for submit@debbugs.gnu.org; Tue, 11 Aug 2015 12:07:49 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181]:14139) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZPC5b-0008Gd-Dd for 21225@debbugs.gnu.org; Tue, 11 Aug 2015 12:07:47 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0AvEwA731xV//gFNJ1cgxCEAoVVuzcJhH6CTQQCAoE8ORQBAQEBAQEBgQpBBYNdAQEDAVYjEAsOJhIUGA0kiDcIzyMBAQEBAQUBAQEBHos6hQUHhC0FnxeDa5ICI4QUIoJ4AQEB X-IPAS-Result: A0AvEwA731xV//gFNJ1cgxCEAoVVuzcJhH6CTQQCAoE8ORQBAQEBAQEBgQpBBYNdAQEDAVYjEAsOJhIUGA0kiDcIzyMBAQEBAQUBAQEBHos6hQUHhC0FnxeDa5ICI4QUIoJ4AQEB X-IronPort-AV: E=Sophos;i="5.13,465,1427774400"; d="scan'208";a="159485007" Original-Received: from 157-52-5-248.cpe.teksavvy.com (HELO pastel.home) ([157.52.5.248]) by ironport2-out.teksavvy.com with ESMTP; 11 Aug 2015 12:07:46 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id D6BE06176E; Tue, 11 Aug 2015 12:07:46 -0400 (EDT) In-Reply-To: (Artur Malabarba's message of "Tue, 11 Aug 2015 13:50:09 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x 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:105416 Archived-At: >> The doc (doc strings and manual) should make clear that the args >> are evaluated. This is not obvious, as these are macros. > Yes please. Everytime I use these I have to manually check their > behavior because I'm never sure just by reading the docstring. Maybe a better fix is to turn them into functions (which basically means, to add special support for them in the byte-compiler, since that's the only reason they're defined as macros, AFAIK). Stefan