Hi,

There is a lack of documentation concerning blank lines in the
texinfo source, in particular concerning their effect with the
various output formats.

In the GNU Texinfo 7.1.1 manual, it is said that blank lines are
significant for @example and @verbatim.

For @itemize and @enumerate, it is recommended to put a blank line
between items.

Ditto for @table:

------------------------------------------------------------------------
   Normally, you should put a blank line between table entries.  This
puts a blank line in the Info file, which looks better unless the
entries are very brief.

   End the table with a line consisting of ‘@end table’.  Follow the end
of the table by a blank line for consistent formatting across output
formats.

   For example, the following table highlights the text in the first
column with the ‘@samp’ command:

     @table @samp
     @item foo
     This is the text for
     @samp{foo}.

     @item bar
     Text for @samp{bar}.
     @end table

This produces:

‘foo’
     This is the text for ‘foo’.
‘bar’
     Text for ‘bar’.
------------------------------------------------------------------------

But I don't see a blank line above for the produced output.

However, when testing, I do get a blank line:

‘foo’
     This is the text for ‘foo’.

‘bar’
     Text for ‘bar’.

BTW, this seems to affect only the info file (not the generated
HTML and PDF files).

There is no documentation at all for @multitable.
On the following example:

\input texinfo    @c -*-texinfo-*-
@setfilename multitable.info

@ifnottex
@node Top, (dir), (dir), (dir)
@top multitable test
@end ifnottex

@multitable {col 1} {col 2}
@item a @tab 1
@item b @tab 2

@item c @tab 3
@item d @tab 4
@end multitable

@bye

from <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=512307>,
the behavior has changed over the time. With texi2any 7.1.1, I get
a blank line in the info and PDF files between the second and third
items, but not in the HTML file.

For @multitable, there was this discussion:

  https://lists.gnu.org/archive/html/bug-texinfo/2019-07/msg00000.html

-- 
Vincent Lefèvre <vinc...@vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / Pascaline project (LIP, ENS-Lyon)

Reply via email to