bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: @itemize @asis is not well supported


From: Bruno Haible
Subject: Re: @itemize @asis is not well supported
Date: Mon, 04 Mar 2024 18:23:23 +0100

Patrice Dumas wrote:
> @itemize @asis is definitely not the same as @table @asis.  Indeed,
> @table argument is applied to the @item argument, while @itemize
> argument precedes the @item argument.

Ah, thanks for explaining.

It also explains why
  @itemize @code
did not have the desired effect, whereas
  @table @code
is documented.

> It is already possible to use an
> empty @asis as @itemize argument, with braces, like
> 
> @itemize @asis{}
> 
> This seems to me to be a better use to advocate, in particular to avoid
> the idea that @itemize @asis could be similar to @table @asis.

Thanks, I'll use that, instead of @w{}.

> Regarding the lack of error by makeinfo, I would tend to consider that
> makeinfo is incorrect, I think that there should at least be a warning
> message ...

Yes, please. Since "make" only produces the info-formatted output by default,
without the warning, developers won't realize their mistake until the time
they run "make distcheck" (since "make distcheck" creates the dvi/ps/pdf
formatted documentation). It is better to get the developers' attention
already during "make".

Bruno






reply via email to

[Prev in Thread] Current Thread [Next in Thread]