Subject: Re: typeset docs flow Re: [PATCH] typeset: set $? on incidental error
From: "Jun T." <[email-masked]>
To: "[email-masked]" <[email-masked]>
Date: Mon, 1 Feb 2016 12:23:39 +0900
List-Id: Zsh Workers List <zsh-workers.zsh.org>

On 2016/02/01, at 2:03, Bart Schaefer <[email-masked]> wrote:
> } In which format? man pages? or pdf/html/info?
> 
> Info format, with the standalone info viewer.

I've found that makeinfo ver.4.8 has the problem (double blank lines
before example), but makeinfo 5.2 works fine.

Maybe you are using makeinfo (texinfo) 4.x?

The corresponding part in zsh.texi looks like:

----
Examples of the differences between command and reserved word parsing:

@noindent
@example
# Reserved word parsing
typeset svar=$(echo one word) avar=(several words)
@end example
----

and the extra blank line is caused by the @noindent. I think outputting
the extra blank line is a bug of makeinfo 4.x.
Since the example is indented anyway, the @noindent is redundant and
could be eliminated in theory. But it would not be easy to do so because
@noindent is output by PARAGRAPH() macro which is called immediately
after yodl finds one or more blank line(s) (without reading ahead).