On Mon, Mar 04, 2024 at 10:57:08PM +0100, Bruno Haible wrote:
> Patrice Dumas wrote:
> > Ok, I propose as warning message :
> >
> > "non-mark brace command `\@%s' as \@%s argument should have braces"
> >
> > leading to something like
> >
> > non-mark brace command `@asis' as @itemize argument should have braces
>
> This is not easy to understand. How about
>
> @itemize argument @asis might not work in TeX mode; try using @asis{}
> instead
> @itemize argument @code might not work in TeX mode; try using @code{}
> instead
There are two issues with that message, first, we should not refer to
TeX mode, this is a Texinfo language issue, not tied to a specific
output. Second, I would prefer if we did say that braces are required,
but not how they should be used, if, for example, the user actually
wanted to have a command with something in the argument, ie @code{aa}
instead of @code{}.
--
Pat