Re: doc for multi-line font-lock

[Richard Stallman]

    Setting font-lock-multiline to t should allow font-lock-keywords that
    typically span a single line but sometimes a bit more (things like
    <title>blabla</title>) to work correctly most of the time.

can you doc that?

    > A concrete example is that I wanted to do something that's probably a
    > job for `font-lock-syntactic-face-function'.  I didn't know about that
    > function and only found it by grovelling a mode I thought must be
    > doing what I wanted.

    Documenting its behavior is not something I'm looking forward to.
    I'm responsible for introducing `font-lock-syntactic-face-function' as well
    as for all of the code that uses it in Emacs (AFAIK), but I think
    it's just a hack that's screaming for a replacement based on a significant
    improvement to font-lock rather than a quick hack.

how about if we mention it in the manual and say 3 lines abt what it
can do, and say we decided not to doc it fully since it is so obscure
and unfinished.