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

Reply via email to