GNU bug report logs -
#19571
25.0.50; `display-buffer-alist': ALIST is completely undefined
Previous Next
Reported by: Drew Adams <drew.adams <at> oracle.com>
Date: Mon, 12 Jan 2015 02:13:02 UTC
Severity: minor
Found in version 25.0.50
Done: Eli Zaretskii <eliz <at> gnu.org>
Bug is archived. No further changes may be made.
Full log
View this message in rfc822 format
[Message part 1 (text/plain, inline)]
Your message dated Mon, 19 Jan 2015 18:07:22 +0200
with message-id <83vbk2ycsl.fsf <at> gnu.org>
and subject line Re: bug#19571: 25.0.50; `display-buffer-alist': ALIST is completely undefined
has caused the debbugs.gnu.org bug report #19571,
regarding 25.0.50; `display-buffer-alist': ALIST is completely undefined
to be marked as done.
(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)
--
19571: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=19571
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
ALIST is mentioned only here:
ACTION is a cons cell (FUNCTION . ALIST), where FUNCTION is a
function or a list of functions. Each such function should
accept two arguments: a buffer to display and an alist of the
same form as ALIST. See `display-buffer' for details.
"of the same form as ALIST"? Really? What form is that? Where is
*anything* said about the form of ALIST?
In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
of 2014-10-20 on LEG570
Bzr revision: 118168 rgm <at> gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'
[Message part 3 (message/rfc822, inline)]
> Date: Sun, 18 Jan 2015 13:12:03 -0800 (PST)
> From: Drew Adams <drew.adams <at> oracle.com>
> Cc: 19571 <at> debbugs.gnu.org
>
> > > > > ALIST is mentioned only here:
> > > > >
> > > > > ACTION is a cons cell (FUNCTION . ALIST), where FUNCTION is a
> > > > > function or a list of functions. Each such function should
> > > > > accept two arguments: a buffer to display and an alist of the
> > > > > same form as ALIST. See `display-buffer' for details.
> > > > >
> > > > > "of the same form as ALIST"? Really? What form is that? Where is
> > > > > *anything* said about the form of ALIST?
> > > >
> > > > It's an alist. And you are referred to the documentation of
> > > > 'display-buffer' for details. I see nothing wrong with that.
> > >
> > > No, you are referred to `display-buffer' for ACTION - for info about
> > > everything in the ACTION paragraph.
> >
> > Since (see above) "ACTION is a cons cell (FUNCTION . ALIST)",
> > describing ACTION also describes ALIST, which is part of ACTION. IOW,
> > "everything in the ACTION paragraph" includes ALIST.
>
> The very next sentence I wrote is key:
>
> Nothing says that the ALIST here is related to the ALIST mentioned
> for `display-buffer', at all.
>
> That's the point. If ALIST here is the same as ALIST in the
> `display-buffer' description, then it is sufficient to refer
> to the latter.
It's the same word, and there are no other ALISTs around, so why
wouldn't it be?
We use the same word for the same thing all over the place, and the
last thing I'd imagine is that someone could not understand they mean
the same.
> See above. If it helps, great. If not, so be it. To repeat:
>
> But do with the doc string what you like. If you find it perfectly
> clear, more power to you. I'm just reporting that I find it
> confusing and not so helpful. HTH.
OK, closing.
This bug report was last modified 10 years and 128 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.