[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#46274: 28.0.50; Inconsistent doc for syntax-propertize-function
From: |
Stefan Monnier |
Subject: |
bug#46274: 28.0.50; Inconsistent doc for syntax-propertize-function |
Date: |
Thu, 04 Feb 2021 11:23:16 -0500 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) |
>> C-h v syntax-propertize-function contains this text:
>>
>> The specified function may call `syntax-ppss' on any position
>> before END, but if it calls `syntax-ppss' on some
>> position and later modifies the buffer on some earlier position,
>> then it is its responsibility to call `syntax-ppss-flush-cache' to flush
>> the now obsolete ppss info from the cache.
>>
>> But (info "(elisp) Syntax Properties") has a different view:
>>
>> It is allowed to call ‘syntax-ppss’ on any position before END.
>> However, it should not call ‘syntax-ppss-flush-cache’; so, it is not
>> allowed to call ‘syntax-ppss’ on some position and later modify the
>> buffer at an earlier position.
>>
>> Which is the right one?
>
> Good question. Stefan M added to the CCs.
Great question. Thanks for asking.
Stefan