GNU bug report logs - #76055
29.4; Doc of string-empty-p

Previous Next

Package: emacs;

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

Date: Tue, 4 Feb 2025 20:29:01 UTC

Severity: minor

Tags: wontfix

Found in version 29.4

Done: Stefan Kangas <stefankangas <at> gmail.com>

Bug is archived. No further changes may be made.

Full log

View this message in rfc822 format

From: "Alfred M. Szmidt" <ams <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 76055 <at> debbugs.gnu.org, eliz <at> gnu.org
Subject: bug#76055: 29.4; Doc of string-empty-p
Date: Wed, 05 Feb 2025 16:27:43 -0500

   A function such as `string-empty-p' is a prime
   candidate for checking and adding such mention.

   Its name (and its current doc string) provides
   no clue that it handles a symbol argument as
   if you were passing (symbol-name <the symbol>).

Why should it?  Lisp is a dynamic language, and predicates generally
accept anything.  If anything, if the notion is that string-empty-p
should _reject_ anything but strings, it should be an assert!  (Not
saying that should be the case ...)

   If a function name shouts that the function's
   only about a string, its doc should mention it if
   that's not the case.
This bug report was last modified 131 days ago.

Previous Next

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