bug#50041: Add font-lock-doc-markup-face

[Eli Zaretskii]

> From: Mattias Engdegård <mattiase@acm.org>
> Date: Fri, 13 Aug 2021 16:08:59 +0200
> Cc: 50041@debbugs.gnu.org
> 
> > Which one of these justifies having these faces in font-lock.el, as
> > opposed in markdown mode itself, or in rst.el?
> 
> All of them -- it's not primarily intended for editing whole texts in those 
> formats (and modes) but for doc comments specific to each programming 
> language. Fontifying those is done by the respective language mode, such as 
> haskell-mode or java-mode.
> 
> Sorry if I was unclear on that point. I've made the NEWS entry a bit less 
> ambiguous.
> 
> >  It is unusual to have
> > mode-specific faces in a general-purpose Lisp file, let alone a
> > preloaded one.
> 
> The face is not mode-specific. It's like font-lock-doc-face.

Sorry, I still don't get it.  Could you show a couple of examples of
use of this face, and tell how these use cases are handled without
that face?  TIA.