font-lock-syntactic-face-function isn't easy to find

[Bielawski, Richard]

I'd like to suggest a change.

In lispref/modes.text

   Syntactic fontification uses the syntax table to find comments and
-  string constants (@pxref{Syntax Tables}).  It highlights them using
+  string constants (@pxref{Syntax Tables}).  It highlights them based
-  @code{font-lock-comment-face} and @code{font-lock-string-face}
+  on a value returned by @code{font-lock-syntactic-face-function}
   (@pxref{Faces for Font Lock}).  There are several variables that
   affect syntactic fontification; you should set them by means of
   @code{font-lock-defaults} (@pxref{Font Lock Basics}).

The current wording sounds like 'That's just the way it is.  We use
these
faces and that's that.'  I wanted to highlight \" syntax strings
differently from \| string fence strings.  Because of the wording's
impression I wasted several hours searching code for an answer.

Mentioning font-lock-syntactic-face-function here makes it more clear
that there are options.  Readers will still find the face names right
away no matter which path they follow (the 'Faces' link or the variable
description) but at the same time will be more aware that a modifiable 
function is in control.

Thanks

Rick Bielawski

________________________________________________________________________________________________________________________________________________________________________________________

This message may contain confidential information.  If you are not the intended 
recipient, please notify the sender immediately and delete this email from your 
system.