GNU bug report logs - #78713
30.1; Doc of `desktop-restore-mode-handlers'

Previous Next

To reply to this bug, email your comments to 78713 AT debbugs.gnu.org.

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" <bug-gnu-emacs <at> gnu.org>
Subject: 30.1; Doc of `desktop-restore-mode-handlers'
Date: Fri, 6 Jun 2025 21:08:44 +0000

The doc string says only this about the handler args:

Handlers are called with argument list

   (DESKTOP-BUFFER-FILE-NAME DESKTOP-BUFFER-NAME DESKTOP-BUFFER-MISC)

It should say something about each of those args, in particular, it's
not easy to guess what DESKTOP-BUFFER-MISC is.


In GNU Emacs 30.1 (build 2, x86_64-w64-mingw32) of 2025-02-23 built on
 AVALON
Windowing system distributor 'Microsoft Corp.', version 10.0.26100
System Description: Microsoft Windows 10 Pro (v10.0.2009.26100.4061)

Configured using:
 'configure --with-modules --without-dbus --with-native-compilation=aot
 --without-compress-install --with-tree-sitter CFLAGS=-O2
 prefix=/g/rel/install/emacs-30.1'

Configured features:
ACL GIF GMP GNUTLS HARFBUZZ JPEG LCMS2 LIBXML2 MODULES NATIVE_COMP
NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND SQLITE3 THREADS TIFF
TOOLKIT_SCROLL_BARS TREE_SITTER WEBP XPM ZLIB

(NATIVE_COMP present but libgccjit not available)

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>, Juanma Barranquero <lekktu <at> gmail.com>
Cc: 78713 <at> debbugs.gnu.org
Subject: Re: bug#78713: 30.1; Doc of `desktop-restore-mode-handlers'
Date: Sat, 07 Jun 2025 09:41:11 +0300

> Date: Fri, 6 Jun 2025 21:08:44 +0000
> From:  Drew Adams via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs <at> gnu.org>
> 
> The doc string says only this about the handler args:
> 
> Handlers are called with argument list
> 
>    (DESKTOP-BUFFER-FILE-NAME DESKTOP-BUFFER-NAME DESKTOP-BUFFER-MISC)
> 
> It should say something about each of those args, in particular, it's
> not easy to guess what DESKTOP-BUFFER-MISC is.

I think DESKTOP-BUFFER-MISC is not used nowadays (i.e. always nil).
It seems to be a backward compatibility shim or something.

But to properly document this we need a desktop.el expert.  I CC
Juanma in the hope that he could find some time to help us out here.

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

From: Juanma Barranquero <lekktu <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Drew Adams <drew.adams <at> oracle.com>, 78713 <at> debbugs.gnu.org
Subject: Re: bug#78713: 30.1; Doc of `desktop-restore-mode-handlers'
Date: Sat, 7 Jun 2025 16:34:16 +0200

[Message part 1 (text/plain, inline)]

Hi.

I'm sorry I won't be of much help. Not because of lack of time, but because
I've not used Emacs for a few years now and it's now all kind of nebulous.

That said, I don't think I was ever an expert in that particular bit,
which I suspect will fall more closely in Stefan's ballpark, likely.

On Sat, Jun 7, 2025 at 8:41 AM Eli Zaretskii <eliz <at> gnu.org> wrote:

> > Date: Fri, 6 Jun 2025 21:08:44 +0000
> > From:  Drew Adams via "Bug reports for GNU Emacs,
> >  the Swiss army knife of text editors" <bug-gnu-emacs <at> gnu.org>
> >
> > The doc string says only this about the handler args:
> >
> > Handlers are called with argument list
> >
> >    (DESKTOP-BUFFER-FILE-NAME DESKTOP-BUFFER-NAME DESKTOP-BUFFER-MISC)
> >
> > It should say something about each of those args, in particular, it's
> > not easy to guess what DESKTOP-BUFFER-MISC is.
>
> I think DESKTOP-BUFFER-MISC is not used nowadays (i.e. always nil).
> It seems to be a backward compatibility shim or something.
>
> But to properly document this we need a desktop.el expert.  I CC
> Juanma in the hope that he could find some time to help us out here.
>

[Message part 2 (text/html, inline)]

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Juanma Barranquero <lekktu <at> gmail.com>,
 Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: drew.adams <at> oracle.com, 78713 <at> debbugs.gnu.org
Subject: Re: bug#78713: 30.1; Doc of `desktop-restore-mode-handlers'
Date: Sat, 07 Jun 2025 18:46:18 +0300

> From: Juanma Barranquero <lekktu <at> gmail.com>
> Date: Sat, 7 Jun 2025 16:34:16 +0200
> Cc: Drew Adams <drew.adams <at> oracle.com>, 78713 <at> debbugs.gnu.org
> 
> I'm sorry I won't be of much help. Not because of lack of time, but because I've not used Emacs for a few
> years now and it's now all kind of nebulous.

Thanks for responding, anyway.

> That said, I don't think I was ever an expert in that particular bit, which I suspect will fall more closely in
> Stefan's ballpark, likely.

Stefan, any suggestions?

Previous Next

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