Re: `info` swallows vertical space and indentation after `@image`

[Gavin Smith]

On Tue, Apr 27, 2021 at 04:39:58AM +0000, Werner LEMBERG wrote:
> 
> >> ```
> >> \input texinfo.tex
> >> 
> >> @node Top
> >> 
> >> @node Foo
> >> @chapter Foo
> >> 
> >> @image{image,,,image} test
> >> 
> >> bar
> >> 
> >> @image{image,,,image} test
> >> 
> >> baz
> >> 
> >> @bye
> > 
> > I don't have time to test it right now but one thing to try is
> > 
> > @noindent @image{image,,,image} test
> > 
> > instead, to start the paragraph before the image.
> 
> Yes, inserting `@noindent` for the first and `@indent` for the second
> image makes everything work as expected, thanks.  However, it would be
> still nice if it worked out of the box :-)
> 
> On the other hand, these two work-arounds for the unusual case of
> having an inline image at the beginning of a paragraph are good enough
> IMHO.  In other words, a possible fix is to simply document this
> behaviour.

Apologies for the delayed reponse.  I've made the following change
to the manual.

diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 0aa76da1da..51f12775a6 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -8037,10 +8037,13 @@ @node Image Syntax
 The @var{width} and @var{height} arguments are described in the next
 section.
 
-For @TeX{} output, if an image is the only thing in a paragraph it
-will ordinarily be displayed on a line by itself, respecting the
-current environment indentation, but without the normal paragraph
-indentation.  If you want it centered, use @code{@@center}
+If an image is the first thing in a paragraph and followed by
+more text, then you should precede the @code{@@image} command with
+@code{@@indent} or @code{@@noindent} to indicate the beginning of
+paragraph formatting.  This is especially important for @TeX{} output
+to get correct paragraph indentation.
+
+Use @code{@@center} to center an image
 (@pxref{@code{@@titlefont @@center @@sp}}).
 
 @cindex Alt attribute for images