From unknown Tue Jun 17 22:30:02 2025 X-Loop: help-debbugs@gnu.org Subject: bug#42687: 26.3; `ediff-inferior-compare-regions' - doc (and behavior) Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 02 Aug 2020 23:11:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 42687 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 42687@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.159640981424764 (code B ref -1); Sun, 02 Aug 2020 23:11:01 +0000 Received: (at submit) by debbugs.gnu.org; 2 Aug 2020 23:10:14 +0000 Received: from localhost ([127.0.0.1]:43675 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2N7K-0006RJ-RP for submit@debbugs.gnu.org; Sun, 02 Aug 2020 19:10:14 -0400 Received: from lists.gnu.org ([209.51.188.17]:39494) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2N75-0006QW-5I for submit@debbugs.gnu.org; Sun, 02 Aug 2020 19:10:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:41116) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k2N74-0004Et-Sx for bug-gnu-emacs@gnu.org; Sun, 02 Aug 2020 19:09:54 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:33848) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k2N72-0002K2-KU for bug-gnu-emacs@gnu.org; Sun, 02 Aug 2020 19:09:54 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 072N8Ybv182758 for ; Sun, 2 Aug 2020 23:09:47 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=erSTy1/0iWzjs03KaYRg9Ifx9zaGcZopgRwNR3yOZqM=; b=sy2orYe/nYsKBvbd3KMX8D+wFFtpuzcBTNHd9qge9+aymrTj8FBIcaYMtvbHmK1UiUlC dtJTOhumzP1/O4NDRfeB62T8sesfMWa3KDq7U7q8sPWpDm4vLisJOomqu4zVgiG72J2z S08qcvBzEkLwOLMEUrQiM+EPBa+g0tGIc20VQ38AlhL43B0E8QEr2IkYfrzGC53PvxDz DfY7fzrfJ1yfWR8EYv8QYFfhV+nOTNx2uBbuNrjBm9OIQoCUOkY06J/DX/0rTWKdbWaB 3iUqXr+YNSImPVSn+ZzlDhJUTJgFYuGh7UuC1y7cKnEXRm6FB8ZgSVV9ytg/KyrY5O2a PQ== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2120.oracle.com with ESMTP id 32n11mun6q-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL) for ; Sun, 02 Aug 2020 23:09:47 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 072N7ajr142119 for ; Sun, 2 Aug 2020 23:09:47 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3030.oracle.com with ESMTP id 32njau5v05-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 02 Aug 2020 23:09:47 +0000 Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 072N9kh2013233 for ; Sun, 2 Aug 2020 23:09:46 GMT MIME-Version: 1.0 Message-ID: <443b4058-09b4-4a1d-a8e6-6ecc30f4a238@default> Date: Sun, 2 Aug 2020 16:09:45 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5017.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9701 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 malwarescore=0 adultscore=0 suspectscore=1 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008020182 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9701 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 clxscore=1015 priorityscore=1501 impostorscore=0 lowpriorityscore=0 malwarescore=0 spamscore=0 mlxscore=0 suspectscore=1 mlxlogscore=999 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008020182 Received-SPF: pass client-ip=156.151.31.85; envelope-from=drew.adams@oracle.com; helo=userp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/08/02 19:09:51 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] X-Spam_score_int: -53 X-Spam_score: -5.4 X-Spam_bar: ----- X-Spam_report: (-5.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-1, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) I'd never tried this (`=3D' in Ediff) before, but a problem reported by another user drew my attention to it. I don't claim to understand it (what it does or is supposed to do), so consider this feedback that of one naive first-time user. Some of what I report might not be real problems, from your point of view. And there may be additional problems, from the point of view of someone who really understands. 1. I have two buffers, `*sc' and `*scratch*', whose text I compare with `ediff-buffers'. The only difference is that `*sc' has "FOO" in place of "with". The second line in the buffers is highlighted, with the word difference highlighted differently, to stand out. All normal. 2. In the Ediff control window I use `C-h k =3D', and I see this: ediff-inferior-compare-regions is an interactive compiled Lisp function in 'ediff-util.el'. (ediff-inferior-compare-regions) Compare regions in an active Ediff session. Like `ediff-regions-linewise' but is called from under an active Ediff se= ssion on the files that belong to that session. After quitting the session invoked via this function, type C-l to the par= ent Ediff Control Panel to restore highlighting. First, one line is too long (81 chars). Second, I'm comparing buffers, not files, so the doc is off-base here: "the files that belong to that session". Third, the doc is obscure - not comprehensible to me, and I've used Ediff for 35 years (but mostly just `ediff-buffers', and without being an expert, by any means). What does "is called from under an active Ediff session" means? "Under" a session? (And what's an Ediff "session"? OK, I can guess what is meant by a "session", but I'm not sure it's a great name for it.) It says, "After quitting the session invoked via this function, type C-l to the parent Ediff Control Panel to restore highlighting." How do I quit that child (?) session? Does it mean quitting Ediff altogether? If not, do I use the same key, `q', to quit this "under", or "child" session? The doc should say how to quit this child Ediff. 3. Next, I look in the Ediff manual. First, I try `i ediff-inferior-compare-regions', and it takes me to node `Quick Help Commands', where I can read about `=3D'. OK. But `C-s ediff-inferior-compare-regions' from the start of the manual doesn't find that command anywhere. And the doc for `=3D' doesn't give its command name. I think it should. Next, that explanation of `=3D' talks only about files, not buffers, except that it later talks about "files or buffers". The main text describing the command shouldn't make it sound like this is only about comparing text in files. 4. The behavior of `ediff-inferior-compare-regions' (`=3D') seems really awful, but I can't pronounce on that as I clearly don't understand some of it. With `ediff-buffers' for buffers in two different frames, `=3D', and quitting from it and using `C-l' in the parent control window, ends up duplicating one of the buffers in a window in the other buffer's frame. And you can easily get errors saying that a window is too small to be split etc. At first view, at least, this command seems like a real mess. But this bug report is about the doc, as I don't pretend to understand the command well. 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=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From unknown Tue Jun 17 22:30:02 2025 X-Loop: help-debbugs@gnu.org Subject: bug#42687: 26.3; `ediff-inferior-compare-regions' - doc (and behavior) Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 02 Aug 2020 23:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 42687 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 42687@debbugs.gnu.org Received: via spool by 42687-submit@debbugs.gnu.org id=B42687.159641035525578 (code B ref 42687); Sun, 02 Aug 2020 23:20:01 +0000 Received: (at 42687) by debbugs.gnu.org; 2 Aug 2020 23:19:15 +0000 Received: from localhost ([127.0.0.1]:43683 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2NG6-0006eU-Q5 for submit@debbugs.gnu.org; Sun, 02 Aug 2020 19:19:15 -0400 Received: from aserp2120.oracle.com ([141.146.126.78]:38744) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2NG3-0006eA-M5 for 42687@debbugs.gnu.org; Sun, 02 Aug 2020 19:19:12 -0400 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 072NBsY4168541 for <42687@debbugs.gnu.org>; Sun, 2 Aug 2020 23:19:06 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=+GTUCzeQhxbW6qheyrZETbZ0ENCMMx+0GWd1qf0oqhg=; b=vYS3Lqg3VXZIH3qWC/ZG/uIcK27+oQss9vcjgLrCy36UAIDe/nTXoMyR5sEPPQkHbxVD iP8iCzVoC8qVlG/fcyv54SL98UrFOSGYmeFtGS4Msj4Az6ihbykH/2HUX01/1Vzbob0x B1VKw0I7+4yNVKGcxNps7femw/F2oYQ1h5do8P8OS5tN0LdXr+52y5cXRKMHKKZFqD41 83bQFn0CEP/Vw3XaQxtx18s2Jpj8jfNVKZ7kE4Sc0Ny73bPPCPrGTiN/90tpdXozpdH9 WK1mfNdLrg3uLt5PwijU9tZy49wQ+9JMfXtr+AgMMroT5eKi9VFlgoBkfCHPZuUlmHTh hg== Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 32nc9yab7c-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL) for <42687@debbugs.gnu.org>; Sun, 02 Aug 2020 23:19:06 +0000 Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 072NIsju187428 for <42687@debbugs.gnu.org>; Sun, 2 Aug 2020 23:19:05 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userp3020.oracle.com with ESMTP id 32nj5p70jd-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for <42687@debbugs.gnu.org>; Sun, 02 Aug 2020 23:19:05 +0000 Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 072NJ1LZ024263 for <42687@debbugs.gnu.org>; Sun, 2 Aug 2020 23:19:04 GMT MIME-Version: 1.0 Message-ID: Date: Sun, 2 Aug 2020 16:19:00 -0700 (PDT) From: Drew Adams References: <443b4058-09b4-4a1d-a8e6-6ecc30f4a238@default> In-Reply-To: <443b4058-09b4-4a1d-a8e6-6ecc30f4a238@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5017.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9701 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=600 mlxscore=0 spamscore=0 phishscore=0 suspectscore=1 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008020184 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9701 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 mlxscore=0 suspectscore=1 phishscore=0 lowpriorityscore=0 spamscore=0 impostorscore=0 adultscore=0 clxscore=1011 malwarescore=0 bulkscore=0 mlxlogscore=604 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008020183 X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > I'd never tried this (`=3D' in Ediff) before, but a problem reported by > another user drew my attention to it. FWIW, that other-user question is here: https://superuser.com/q/1572341/250462 Someone knowledgeable in Ediff might want to provide a better (more helpful= ) reply/answer there than what I came up with.