bug#20158: 25.0.50; (elisp) `Choosing Window' typo?

bug#20158: 25.0.50; (elisp) `Choosing Window' typo?

[Drew Adams]

From that doc node:

  These steps are described by means of "display actions",
  which have the form `(FUNCTION . ALIST)'.  Here, FUNCTION
  is either a function or a list of functions, which we
  refer to as "action functions"; ALIST is an association
                                           ^^
  list, which we refer to as "action alists".
                             ^^^^^^^^^^^^^^^

My impression is that there is only one ALIST per (FUNCTION
. ALIST).  If so, then presumably the last part should read
'which we refer to as an "action alist"' (singular "alist").

IOW, it is only FUNCTION that can be a list of functions.
My impression is that ALIST cannot be a list of alists.

And if my impression is wrong then it is the first part of
that same phrase that is then incorrect.  In that case, it
should read "ALIST is a list of association lists", or
perhaps "ALIST is either an association list or a list of
association lists".  Whatever the case, it seems wrong to
me, currently.

In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

bug#20158: 25.0.50; (elisp) `Choosing Window' typo?

[Lars Ingebrigtsen]

Drew Adams <drew.adams@oracle.com> writes:

>>From that doc node:
>
>   These steps are described by means of "display actions",
>   which have the form `(FUNCTION . ALIST)'.  Here, FUNCTION
>   is either a function or a list of functions, which we
>   refer to as "action functions"; ALIST is an association
>                                            ^^
>   list, which we refer to as "action alists".
>                              ^^^^^^^^^^^^^^^
>
> My impression is that there is only one ALIST per (FUNCTION
> . ALIST).  If so, then presumably the last part should read
> 'which we refer to as an "action alist"' (singular "alist").

I think so.  Fixed now.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no