Strange comment in font-lock-fontify-buffer

[Andreas Röhler]

Hi,

in command font-lock-fontify-buffer there is a comment saying:

   ;; When called from Lisp, this function is a big mess.  The caller 
usually
   ;; expects one of the following behaviors:
   ;; - refresh the highlighting (because the font-lock-keywords have been
   ;;   changed).
   ;; - apply font-lock highlighting even if font-lock-mode is not enabled.
   ;; - reset the highlighting rules because font-lock-defaults
   ;;   has been changed (and then rehighlight everything).
   ;; Of course, this function doesn't do all of the above in all 
situations
   ;; (e.g. depending on whether jit-lock is in use) and it can't guess 
what
   ;; the caller wants.

Don't understand these concerns, resp. commenting.

font-lock-mode is expected to care for more things and in a different 
way then a single explicit call here - which should work from scratch 
indeed.

Best,

Andreas