GNU bug report logs - #52317
29.0.50; Unintelligible sentence in EIEIO info

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 52317 in the body.
You can then email your comments to 52317 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: Marco Wahl <marcowahlsoft <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 29.0.50; Unintelligible sentence in EIEIO info
Date: Sun, 05 Dec 2021 21:48:48 +0100

Visit (info "(eieio) Generics") .
Find the sentence

       In CLOS, a generic call also be used to provide an argument list
       and dispatch precedence for all the arguments.

This sentence is unintelligible AFAICT.



In GNU Emacs 29.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.20, cairo version 1.16.0)
 of 2021-12-03 built on aspire-5942
Repository revision: f5f5297a9254bb2da751da184eaf03a919a1766a
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12011000
System Description: Linux Mint 20

Configured using:
 'configure --with-native-compilation'

Configured features:
CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GSETTINGS HARFBUZZ JPEG JSON
LIBSELINUX LIBXML2 MODULES NATIVE_COMP NOTIFY INOTIFY PDUMPER PNG RSVG
SECCOMP SOUND THREADS TIFF TOOLKIT_SCROLL_BARS X11 XDBE XIM XPM GTK3
ZLIB

Important settings:
  value of $LC_MONETARY: de_DE.UTF-8
  value of $LC_NUMERIC: de_DE.UTF-8
  value of $LANG: en_US.UTF-8
  locale-coding-system: utf-8-unix

Major mode: Info


-- 
Marco Wahl

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Marco Wahl <marcowahlsoft <at> gmail.com>
Cc: 52317 <at> debbugs.gnu.org
Subject: Re: bug#52317: 29.0.50; Unintelligible sentence in EIEIO info
Date: Sun, 05 Dec 2021 22:02:40 +0100

Marco Wahl <marcowahlsoft <at> gmail.com> writes:

> Visit (info "(eieio) Generics") .
> Find the sentence
>
>        In CLOS, a generic call also be used to provide an argument list
>        and dispatch precedence for all the arguments.
>
> This sentence is unintelligible AFAICT.

I've now changed it to:

In CLOS, a generic method can also be used to provide an argument list
and dispatch precedence for all the arguments.  In @eieio{},
dispatching only occurs for the first argument, so the @var{arglist}
is not used.

in Emacs 29.  But the documentation here talks about cl-defgeneric, so
it's extra confusing.  (The `defgeneric' in eieio-compat.el does behave
like described, apparently, so it's not totally wrong...  but...  it
think perhaps the ieieo/cl method stuff needs some editing.)

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

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

From: Marco Wahl <marcowahlsoft <at> gmail.com>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: Marco Wahl <marcowahlsoft <at> gmail.com>, 52317 <at> debbugs.gnu.org
Subject: Re: bug#52317: 29.0.50; Unintelligible sentence in EIEIO info
Date: Sun, 05 Dec 2021 22:28:25 +0100

>> Visit (info "(eieio) Generics") .
>> Find the sentence
>>
>>        In CLOS, a generic call also be used to provide an argument list
>>        and dispatch precedence for all the arguments.
>>
>> This sentence is unintelligible AFAICT.
>
> I've now changed it to:
>
> In CLOS, a generic method can also be used to provide an argument list
> and dispatch precedence for all the arguments.  In @eieio{},
> dispatching only occurs for the first argument, so the @var{arglist}
> is not used.

Thanks Lars!  This fixes the issue!

> in Emacs 29.  But the documentation here talks about cl-defgeneric, so
> it's extra confusing.  (The `defgeneric' in eieio-compat.el does behave
> like described, apparently, so it's not totally wrong...  but...  it
> think perhaps the ieieo/cl method stuff needs some editing.)

Possibly.  I'll keep reporting in case I find something else...


Thanks again!
-- 
Marco

Previous Next

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