Re: imenu fails in mode without comment-start-skip defined

[Dave Love]

Richard Stallman <address@hidden> writes:

> I don't know this subject well enough to write about it.
> I'm not sure what the programmer needs to know in order to
> program efficiently using syntax-ppss.  It is true that I
> could study the code and learn the answers, but that is inefficient
> and my time is a limiting factor for many things.
>
> Could someone who already knows these things please write about them?

I think basically all it needs is to say that it's a more efficient
version of parse-partial-sexp (using a cache) with the restrictions
mentioned in the doc string (and any others?).  Warn that it might
clobber the match data via syntax-begin-function and maybe also
mention syntax-ppss-context.