On Wed, Mar 06, 2024 at 03:05:06PM +0100, [email protected] wrote:
> > I suggest
> >
> > ```
> > '@asis' needs braces here; say '@itemize @asis{}'.
> > ```
>
> I do not like much that option, because we do not have any idea why the
> user ended up using '@itemize @asis'. Maybe with @asis, it will be in
> general the case that @asis{} is correct, but with other @-command for
> example @strong, it is unlikely to be the case. It could be an error,
> for instance the user wanted to use @table, it could be that the user
> actually wanted to use
> @itemize @strong{@bullet{}}
> it could be that user wanted something like
> @itemize @asis{} (or @itemize @w{}).
>
> Saying that the user should say '@itemize @strong{}' is likely to be
> misleading in some cases, while saying that braces are needed
> forces the user to think again about what she/he wanted to do. Another
> option could be to just say
>
> '@asis' needs braces here
> '@strong' needs braces here
>
> What do other think on that possibility?
It could just be the same error message as when used outwith @itemize:
@asis foo
- which gives an error message like:
test.texi:11: @asis expected braces
I agree that @itemize @strong is certainly a mistake and the user is very
unlikely to have wanted to have said "@itemize @strong{}" instead.
Although it is very unlikely input, I notice with the current code, there
is also a warning for the following:
@itemize A @bullet
@item QQbar
Q foo man
@end itemize
giving the warning:
test.texi:11: warning: command `@bullet' must not be followed by new line
I don't know how easy it would be to make the error messages consistent or
if it is worth doing.
