From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs Subject: bug#60399: 30.0.50; Usage of `isearch-open-invisible-temporary' is not documented Date: Thu, 29 Dec 2022 19:33:01 +0200 Organization: LINKOV.NET Message-ID: <865yduf73m.fsf@mail.linkov.net> References: <87tu1ev7uu.fsf@localhost> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="12901"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/30.0.50 (x86_64-pc-linux-gnu) Cc: 60399@debbugs.gnu.org To: Ihor Radchenko Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Dec 29 18:36:18 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pAwpF-00039T-Pu for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Dec 2022 18:36:17 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pAwp6-00052b-F8; Thu, 29 Dec 2022 12:36:08 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pAwp2-000518-1i for bug-gnu-emacs@gnu.org; Thu, 29 Dec 2022 12:36:04 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pAwp0-000790-MD for bug-gnu-emacs@gnu.org; Thu, 29 Dec 2022 12:36:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pAwp0-00044u-47 for bug-gnu-emacs@gnu.org; Thu, 29 Dec 2022 12:36:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Juri Linkov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 29 Dec 2022 17:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60399 X-GNU-PR-Package: emacs Original-Received: via spool by 60399-submit@debbugs.gnu.org id=B60399.167233530615607 (code B ref 60399); Thu, 29 Dec 2022 17:36:02 +0000 Original-Received: (at 60399) by debbugs.gnu.org; 29 Dec 2022 17:35:06 +0000 Original-Received: from localhost ([127.0.0.1]:60977 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pAwo5-00043D-Vq for submit@debbugs.gnu.org; Thu, 29 Dec 2022 12:35:06 -0500 Original-Received: from relay7-d.mail.gandi.net ([217.70.183.200]:44225) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pAwnu-00042t-Nf for 60399@debbugs.gnu.org; Thu, 29 Dec 2022 12:35:00 -0500 Original-Received: (Authenticated sender: juri@linkov.net) by mail.gandi.net (Postfix) with ESMTPSA id 65E1A20007; Thu, 29 Dec 2022 17:34:46 +0000 (UTC) In-Reply-To: <87tu1ev7uu.fsf@localhost> (Ihor Radchenko's message of "Thu, 29 Dec 2022 10:10:01 +0000") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:252046 Archived-At: > According to isearch.el source, one can use > `isearch-open-invisible-temporary' to implement custom hidden text > display during isearch. However, it is unclear what are the requirements > for that function. > > From isearch source code, it appears that the function should accept two > arguments: overlays and a flag to open/close the overlay: > > ;; Some modes would want to open the overlays temporary during > ;; isearch in their own way, they should set the > ;; `isearch-open-invisible-temporary' to a function doing this. > (funcall (overlay-get ov 'isearch-open-invisible-temporary) ov nil) > > However, it appears that deleting the passed overlay is, in fact, > prohibited. (manifested in > https://orgmode.org/list/87pmc4smdg.fsf@fastmail.fm) > > Is there some detailed information about this feature available somewhere? I don't know about this function more than you can read from source code, but can find two mentions in (info "(elisp) Invisible Text") and (info "(elisp) Overlay Properties").