GNU bug report logs - #64353
29.0.91; Doc string of `jump-to-register'

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 64353 in the body.
You can then email your comments to 64353 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" <bug-gnu-emacs <at> gnu.org>
Subject: 29.0.91; Doc string of `jump-to-register'
Date: Thu, 29 Jun 2023 19:24:41 +0000

This part of the doc string needs improvement:

 Optional second arg non-nil (interactively, prefix argument) says to
 delete any existing frames that the frameset doesn't mention.
 (Otherwise, these frames are iconified.)

It makes no sense at all, if the register is not for a frame
configuration.

And the interactive behavior (e.g. for the prefix arg) should be
presented before the Lisp description of arguments.  And instead of (or
at least in addition to) talking about the "first" and "second" args it
should refer to them by name.  And the first line could helpfully say
"Move point to location stored in REGISTER".


In GNU Emacs 29.0.91 (build 2, x86_64-w64-mingw32) of 2023-05-14 built
 on AVALON
Windowing system distributor 'Microsoft Corp.', version 10.0.19045
System Description: Microsoft Windows 10 Pro (v10.0.2009.19045.3086)

Configured using:
 'configure --with-modules --without-dbus --with-native-compilation
 --without-compress-install --with-tree-sitter CFLAGS=-O2'

Configured features:
ACL GIF GMP GNUTLS HARFBUZZ JPEG JSON 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 64353 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Drew Adams <drew.adams <at> oracle.com>, "64353 <at> debbugs.gnu.org"
 <64353 <at> debbugs.gnu.org>
Subject: RE: 29.0.91; Doc string of `jump-to-register'
Date: Thu, 29 Jun 2023 19:34:55 +0000

BTW, the doc for `jump-to-register' talks about
framesets, but the rest of library `register.el'
was updated to change references of "frameset"
to "frame configuration" everywhere.  Dunno
whether that should be done also in the
`jump-to-register' doc.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 64353 <at> debbugs.gnu.org
Subject: Re: bug#64353: 29.0.91; Doc string of `jump-to-register'
Date: Fri, 30 Jun 2023 10:17:13 +0300

> From: Drew Adams <drew.adams <at> oracle.com>
> Date: Thu, 29 Jun 2023 19:24:41 +0000
> 
> This part of the doc string needs improvement:
> 
>  Optional second arg non-nil (interactively, prefix argument) says to
>  delete any existing frames that the frameset doesn't mention.
>  (Otherwise, these frames are iconified.)
> 
> It makes no sense at all, if the register is not for a frame
> configuration.

Thanks, fixed on the emacs-29 branch.

Message #16 received at 64353-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 64353-done <at> debbugs.gnu.org
Subject: Re: bug#64353: 29.0.91; Doc string of `jump-to-register'
Date: Fri, 30 Jun 2023 10:17:37 +0300

> From: Drew Adams <drew.adams <at> oracle.com>
> Date: Thu, 29 Jun 2023 19:34:55 +0000
> 
> BTW, the doc for `jump-to-register' talks about
> framesets, but the rest of library `register.el'
> was updated to change references of "frameset"
> to "frame configuration" everywhere.  Dunno
> whether that should be done also in the
> `jump-to-register' doc.

Fixed, and closing the bug.

Previous Next

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