Re: @itemize @asis is not well supported

[Gavin Smith]

On Wed, Mar 06, 2024 at 03:05:06PM +0100, pertusus@free.fr 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.