bug#69709: `sort` interface improvement and universal ordering predicate

[Mattias Engdegård]

29 mars 2024 kl. 16.35 skrev Eli Zaretskii <eliz@gnu.org>:

> The canonical sorting order for overlays is in compare_overlays,
> AFAIK.

Maybe, but I haven't see much Lisp code trying to use an order like that -- 
sorting overlays is common but is done with all kinds of orders. Perhaps I 
haven't looked very carefully.
In any case, maybe compare_overlays would work as a starting point. It seems to 
focus on vertical order (by priority), but much Lisp code sorts overlays 
horizontally (by position).

> Makeinfo can handle @code{@var{..}} just fine, we have that in many
> other places, so that's not a concern.  It is indeed possible to use
> @asis in @table, and then mark each @item with @code, but that's just
> too much trouble; "@table @code" exists to save us that...

Looking at the PDF makes me think that we should decide whether we prefer

  @code{:keyword @var{variable}}

or

  @code{:keyword} @var{variable}

in general. I can think of arguments for either but consistency would be even 
better.

> I think the places where keywords don't have the @code markup are
> simply wrong.

Yes, I agree.