command to fontify whole buffer?

["Drew Adams" <drew.adams@oracle.com>]

Sometimes I want to fontify a whole buffer (really).  One use case is to be able
to then use the fontification for other (e.g. code) purposes than visual
highlighting.  But it really doesn't matter why - I just want to. ;-)

With the current lazy/jit fontification, I see no command to do that.
`font-lock-fontify-buffer' doesn't do it.  Marking the whole buffer and using
`(font-lock-fontify-region BEG END)' doesn't do it.

Digging more than a bit, I finally found non-interactive function
`jit-lock-fontify-now', which seems to do the trick.  Why not provide a command
that does it?

(defun fontify-buffer-completely-no-but-really ()
  "Yes, really, completely, right now."
  (interactive)
  (jit-lock-fontify-now))

Oddly enough, the `jit-lock-fontify-now' doc is no different from the doc of all
the other `fontify' functions that do _not_ really, necessarily fontify
everything they apply to.  They all say only that they fontify.  The others do
not say that they don't really, necessarily fontify all they apply to.  And this
function doesn't say that it is any different from the others.  But it seems to
be.

Another question is whether there is some condition that can be tested to know
whether a buffer has really been completely fontified (whether or not that
fontification is completely up-to-date because of subsequent edits).  Text
property `fontified' does not indicate this - is there something that does?