Subject: Re: bug#49558: fill paragraph in texinfo-mode fails with @

From: Lars Ingebrigtsen <[email-masked]>
Date: Wed, 14 Jul 2021 16:29:43 +0200

Eli Zaretskii <[email-masked]> writes:

> But even if we do so, I'm not sure that
>
>   @cindex relative remapping, faces
>   @cindex base remapping, faces
>     The following functions implement a higher-level interface to
>   @code{face-remapping-alist}.  Most Lisp code should use these
>   functions instead of setting @code{face-remapping-alist} directly, to
>   avoid trampling on remappings applied elsewhere.  These functions are
>   intended for buffer-local remappings, so they all make
>   @code{face-remapping-alist} buffer-local as a side-effect.  They manage
>   @code{face-remapping-alist} entries of the form
>
> should be a single paragraph,

But it is one paragraph today.  With my proposed patch, it becomes two
paragraphs (since @cindex is the start of a paragraph).

> and likewise this:
>
>   @defun face-remap-add-relative face &rest specs
>   This function adds the face spec in @var{specs} as relative
>   remappings for face @var{face} in the current buffer.  The remaining
>   arguments, @var{specs}, should form either a list of face names, or a
>   property list of attribute/value pairs.

There would be no difference here -- that's one paragraph both before
and after the patch.

My preference would be to have the first example be three paragraphs,
and the second example two paragraphs, but I have no idea how to make
that happen with any paragraph-start/separate settings.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no