Re: @itemize @asis is not well supported

2024-03-04 Thread Bruno Haible
Andreas Schwab wrote: > It's not a might, it's a don't do it. It's a misuse of a command that > requires an argument, in a place that doesn't pass one. Thanks for the succint formulation. Can we use it in the warning? The command after @itemize should not require an argument, but @asis needs a

Re: @itemize @asis is not well supported

2024-03-04 Thread Andreas Schwab
On Mär 04 2024, Bruno Haible wrote: > 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 It's not a might, it's a don't do it. It's a

Re: @itemize @asis is not well supported

2024-03-04 Thread Patrice Dumas
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

Re: @itemize @asis is not well supported

2024-03-04 Thread Bruno Haible
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 argu

Re: @itemize @asis is not well supported

2024-03-04 Thread Raymond Toy
On Mon, Mar 4, 2024 at 1:23 PM Patrice Dumas wrote: > On Mon, Mar 04, 2024 at 06:23:23PM +0100, Bruno Haible wrote: > > > > 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

Re: @itemize @asis is not well supported

2024-03-04 Thread Patrice Dumas
On Mon, Mar 04, 2024 at 06:23:23PM +0100, Bruno Haible wrote: > > 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 >

Re: @itemize @asis is not well supported

2024-03-04 Thread Gavin Smith
On Mon, Mar 04, 2024 at 03:59:26PM +0100, Bruno Haible wrote: > @itemize @asis > seems to work in HTML and info mode only, not in TeX mode. > > > How to reproduce (with texinfo-7.1): Patrice covered most of it. It reproduces with any test file with "@itemize @asis" in it. > /tmp/gnulib/doc/gnu

Re: @itemize @asis is not well supported

2024-03-04 Thread Bruno Haible
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, w

Re: @itemize @asis is not well supported

2024-03-04 Thread Patrice Dumas
On Mon, Mar 04, 2024 at 03:59:26PM +0100, Bruno Haible wrote: > @itemize @asis > seems to work in HTML and info mode only, not in TeX mode. > > ... > > Here are four good reasons for supporting @itemize @asis: > > * @table @asis is supported, see [1] > "You may use the @asis command as an

@itemize @asis is not well supported

2024-03-04 Thread Bruno Haible
@itemize @asis seems to work in HTML and info mode only, not in TeX mode. How to reproduce (with texinfo-7.1): $ git clone git://git.savannah.gnu.org/gnulib.git $ cd gnulib $ git checkout f52d4a7b78be73060cf01640b40ebc88193c12e8 $ cd doc $ make pdf ... /tmp/gnulib/doc/gnulib-tool.texi:472: Argum