bug#60399: 30.0.50; Usage of `isearch-open-invisible-temporary' is not documented

[Ihor Radchenko <yantar92@posteo.net>]

Juri Linkov <juri@linkov.net> writes:

>>       ;; 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").

Manual provides no more information.

Would it make sense to mention that overlays passed as an argument of
'isearch-open-invisible-temporary function must not be destroyed?

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>