From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#11460: 24.1.50; doc string of `assert' Date: Sun, 9 Feb 2014 14:14:37 -0800 (PST) Message-ID: <7f9d070d-8147-494a-848b-a03dfa3badbd@default> References: <796323B5CCA7479C83BB0DD5B731553A@us.oracle.com> <87bnyggbst.fsf@building.gnus.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1391984122 8615 80.91.229.3 (9 Feb 2014 22:15:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 9 Feb 2014 22:15:22 +0000 (UTC) Cc: 11460@debbugs.gnu.org To: Stefan Monnier , Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Feb 09 23:15:28 2014 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 1WCces-0007Vf-OA for geb-bug-gnu-emacs@m.gmane.org; Sun, 09 Feb 2014 23:15:26 +0100 Original-Received: from localhost ([::1]:52303 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCces-0004ub-AU for geb-bug-gnu-emacs@m.gmane.org; Sun, 09 Feb 2014 17:15:26 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56872) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCced-0004l3-Mg for bug-gnu-emacs@gnu.org; Sun, 09 Feb 2014 17:15:20 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WCceV-0002ie-3r for bug-gnu-emacs@gnu.org; Sun, 09 Feb 2014 17:15:11 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:46889) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCceU-0002hj-PJ for bug-gnu-emacs@gnu.org; Sun, 09 Feb 2014 17:15:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WCceU-0004oq-BN for bug-gnu-emacs@gnu.org; Sun, 09 Feb 2014 17:15:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 09 Feb 2014 22:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11460 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 11460-submit@debbugs.gnu.org id=B11460.139198408718489 (code B ref 11460); Sun, 09 Feb 2014 22:15:02 +0000 Original-Received: (at 11460) by debbugs.gnu.org; 9 Feb 2014 22:14:47 +0000 Original-Received: from localhost ([127.0.0.1]:60908 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCceE-0004o8-PC for submit@debbugs.gnu.org; Sun, 09 Feb 2014 17:14:47 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:39295) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCceB-0004nz-Sn for 11460@debbugs.gnu.org; Sun, 09 Feb 2014 17:14:44 -0500 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s19MEgDZ022678 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 9 Feb 2014 22:14:42 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s19MEe8C012470 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Sun, 9 Feb 2014 22:14:41 GMT Original-Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s19MEeKq029407; Sun, 9 Feb 2014 22:14:40 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: acsinet22.oracle.com [141.146.126.238] 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: 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:85100 Archived-At: > FWIW, this part of `cl-assert' is not only poorly documented, but > it's poorly designed. And it doesn't have the excuse that it's > inherited from Common Lisp. > > So I'd rather not document that mis-feature in any more detail. In that case, my request would be that the entire bug be recorded and kept open for future fixing (e.g., todo list or whatever): design + implementation + doc. IOW, let's not use the fact that the design, in addition to the doc, is faulty as an excuse to just drop this. If it needs fixing and you cannot or do not want to tackle that now, then it should be kept open for fixing later.