GNU bug report logs - #42322
26.3; doc string of `cl-defmethod'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 42322 in the body.
You can then email your comments to 42322 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.3; doc string of `cl-defmethod'
Date: Sat, 11 Jul 2020 08:50:03 -0700 (PDT)

C-h f cl-defmethod:

 (cl-defmethod NAME [QUALIFIER] ARGS &rest [DOCSTRING] BODY)

 Define a new method for generic function NAME.
 I.e. it defines the implementation of NAME to use for invocations where the
 values of the dispatch arguments match the specified TYPEs.
 The dispatch arguments have to be among the mandatory arguments, and
 all methods of NAME have to use the same set of arguments for dispatch.
 Each dispatch argument and TYPE are specified in ARGS where the corresponding
 formal argument appears as (VAR TYPE) rather than just VAR.

Please say that by "dispatch arguments" you mean ARGS.
Please say what the form of ARGS is, as the way to introduce TYPE.

Currently, TYPE appears before any description of what it stands for and
where it occurs (in fact, there is no such clear description of it).

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.18362
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 42322 <at> debbugs.gnu.org
Subject: Re: bug#42322: 26.3; doc string of `cl-defmethod'
Date: Wed, 09 Dec 2020 14:53:06 +0100

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

> C-h f cl-defmethod:
>
>  (cl-defmethod NAME [QUALIFIER] ARGS &rest [DOCSTRING] BODY)
>
>  Define a new method for generic function NAME.
>  I.e. it defines the implementation of NAME to use for invocations where the
>  values of the dispatch arguments match the specified TYPEs.
>  The dispatch arguments have to be among the mandatory arguments, and
>  all methods of NAME have to use the same set of arguments for dispatch.
>  Each dispatch argument and TYPE are specified in ARGS where the corresponding
>  formal argument appears as (VAR TYPE) rather than just VAR.
>
> Please say that by "dispatch arguments" you mean ARGS.
> Please say what the form of ARGS is, as the way to introduce TYPE.
>
> Currently, TYPE appears before any description of what it stands for and
> where it occurs (in fact, there is no such clear description of it).

This is now fixed in Emacs 28.

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

Previous Next

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