On 3/27/24 04:57, Jakub Jelinek wrote:
Hi!We got internally a question about the Spec File syntax, misunderstanding what is the literal syntax and what are the placeholder variables in the syntax descriptions. The following patch attempts to use @var{S} etc. instead of just S to clarify it stands for any option (or start of option etc.) rather than literal S, say in %{S:X}. At least in HTML documentation it then uses italics. Bootstrapped/regtested on x86_64-linux and i686-linux, ok for trunk?
Looks good for me, as long as you visually inspected the changed text in the manual and didn't just make sure it still builds. (I generally consider any markup/formatting changes "obvious" as long as they actually look OK.)
-Sandra
