unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#35361: 26.2; doc string of `read-buffer'
@ 2019-04-21 15:02 Drew Adams
  2019-05-04  9:47 ` Eli Zaretskii
  0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2019-04-21 15:02 UTC (permalink / raw)
  To: 35361

The doc string does not tell you what the completion candidates are
(they are apparently singleton conses with car a buffer name).  So
it is impossible for a user to know what kind of PREDICATEs to define, 
i.e., what kinds of completion candidates are to be accepted as arg
and tested.

Usually (e.g. for `completing-read') we tell users that PREDICATE is as
specified for `try-completion' etc.  That info is missing here.

In GNU Emacs 26.2 (build 1, x86_64-w64-mingw32)
 of 2019-04-13
Repository revision: fd1b34bfba8f3f6298df47c8e10b61530426f749
Windowing system distributor `Microsoft Corp.', version 10.0.17134
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''





^ permalink raw reply	[flat|nested] 2+ messages in thread

* bug#35361: 26.2; doc string of `read-buffer'
  2019-04-21 15:02 bug#35361: 26.2; doc string of `read-buffer' Drew Adams
@ 2019-05-04  9:47 ` Eli Zaretskii
  0 siblings, 0 replies; 2+ messages in thread
From: Eli Zaretskii @ 2019-05-04  9:47 UTC (permalink / raw)
  To: Drew Adams; +Cc: 35361-done

> Date: Sun, 21 Apr 2019 15:02:37 +0000 (UTC)
> From: Drew Adams <drew.adams@oracle.com>
> 
> The doc string does not tell you what the completion candidates are
> (they are apparently singleton conses with car a buffer name).  So
> it is impossible for a user to know what kind of PREDICATEs to define, 
> i.e., what kinds of completion candidates are to be accepted as arg
> and tested.

Thanks, fixed.





^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2019-05-04  9:47 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-04-21 15:02 bug#35361: 26.2; doc string of `read-buffer' Drew Adams
2019-05-04  9:47 ` Eli Zaretskii

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).