GNU bug report logs - #11460
24.1.50; doc string of `assert'

Previous Next

Package: emacs;

Reported by: "Drew Adams" <drew.adams <at> oracle.com>

Date: Sat, 12 May 2012 15:07:02 UTC

Severity: minor

Tags: wontfix

Found in version 24.1.50

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Full log


Message #17 received at 11460 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Stefan Monnier <monnier <at> iro.umontreal.ca>, Lars Ingebrigtsen
 <larsi <at> gnus.org>
Cc: 11460 <at> debbugs.gnu.org
Subject: RE: bug#11460: 24.1.50; doc string of `assert'
Date: Sun, 9 Feb 2014 14:14:37 -0800 (PST)
> 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.




This bug report was last modified 11 years and 100 days ago.

Previous Next


GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.