Re: [PATCH] Add section headings to index types doc

On 30/09/2020 14:25, Dagfinn Ilmari Mannsåker wrote:
> Michael Paquier <michael@paquier.xyz> writes:
> 
>> On Mon, Aug 10, 2020 at 12:52:17PM +0000, Jürgen Purtz wrote:
>>> The new status of this patch is: Waiting on Author
>>
>> This has not been answered yet, so I have marked the patch as returned
>> with feedback.
> 
> Updated patch attached, wich reformats the operator lists as requested
> by Jürgen, and skips the reindentation as suggested by Tom.

I wonder if "synopsis" is the right markup for the operator lists. I'm 
not too familiar with SGML, but the closest similar list I could find is 
this in create_operator.sgml:

>    The operator name is a sequence of up to <symbol>NAMEDATALEN</symbol>-1
>    (63 by default) characters from the following list:
> <literallayout>
> + - * / &lt; &gt; = ~ ! @ # % ^ &amp; | ` ?
> </literallayout>

Reading up on the meaning of "literallayout" at 
https://tdg.docbook.org/tdg/4.5/literallayout.html, though, it doesn't 
sound quite right either. Maybe "<simplelist type=horiz'>" ?

- Heikki