GNU bug report logs - #35344
26.2; (elisp) `Undo' for `undo-auto-amalgamate'

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 35344 in the body.
You can then email your comments to 35344 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.2; (elisp) `Undo' for `undo-auto-amalgamate'
Date: Sat, 20 Apr 2019 08:27:16 -0700 (PDT)

This doc does not seem sufficient.  Unlike the doc string, what it says
for `undo-auto-amalgamate' does not seem to describe the function at all.

It seems to try to provide some info about amalgamating, but it does not
tell what this function does (AFAICT).

Please describe this function.  But please also consider explaining how
to use it - that's not clear to me.  Presumably you can use it to group
what would otherwise be separate undo pieces into a single undo chunk.
How to do that is not clear (to me), and there is no distributed Lisp
code that uses it, to refer to as an example.  The only reference made
to its use is to C-coded functions (which are the only distributed
functions that use it).

In GNU Emacs 26.2 (build 1, x86_64-w64-mingw32)
 of 2019-04-13
Repository revision: fd1b34bfba8f3f6298df47c8e10b61530426f749
Windowing system distributor `Microsoft Corp.', version 10.0.17134
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 35344 <at> debbugs.gnu.org
Subject: Re: bug#35344: 26.2; (elisp) `Undo' for `undo-auto-amalgamate'
Date: Tue, 09 Jul 2019 16:29:50 +0200

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

> This doc does not seem sufficient.  Unlike the doc string, what it says
> for `undo-auto-amalgamate' does not seem to describe the function at all.
>
> It seems to try to provide some info about amalgamating, but it does not
> tell what this function does (AFAICT).
>
> Please describe this function.

I've now done that.

> But please also consider explaining how
> to use it - that's not clear to me.  Presumably you can use it to group
> what would otherwise be separate undo pieces into a single undo chunk.
> How to do that is not clear (to me), and there is no distributed Lisp
> code that uses it, to refer to as an example.  The only reference made
> to its use is to C-coded functions (which are the only distributed
> functions that use it).

I knew nothing about it before reading the section, and it seems pretty
clear to me what it does.

-- 
(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.