From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-workers-return-37862-mason-zsh=primenet.com.au@zsh.org>
Received: (qmail 22656 invoked by alias); 1 Feb 2016 03:23:34 -0000
Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm
Precedence: bulk
X-No-Archive: yes
List-Id: Zsh Workers List <zsh-workers.zsh.org>
List-Post: <mailto:zsh-workers@zsh.org>
List-Help: <mailto:zsh-workers-help@zsh.org>
X-Seq: 37862
Received: (qmail 2474 invoked from network); 1 Feb 2016 03:23:33 -0000
X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on f.primenet.com.au
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham
	autolearn_force=no version=3.4.0
X-Biglobe-Sender: <takimoto-j@kba.biglobe.ne.jp>
Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 6.6 \(1510\))
Subject: Re: typeset docs flow Re: [PATCH] typeset: set $? on incidental error
From: "Jun T." <takimoto-j@kba.biglobe.ne.jp>
In-Reply-To: <160131090359.ZM11407@torch.brasslantern.com>
Date: Mon, 1 Feb 2016 12:23:39 +0900
Content-Transfer-Encoding: 7bit
Message-Id: <8012DD0D-E474-4D82-9DAC-72D206D99E76@kba.biglobe.ne.jp>
References: <20160123235300.GC20278@tarsus.local2>  <56A445E0.50706@gmx.com>  <20160126225008.GA4731@tarsus.local2>  <160126201724.ZM2552@torch.brasslantern.com>  <20160129091834.GA8420@tarsus.local2>  <20160130074657.GA3030@tarsus.local2>  <160130114745.ZM10270@torch.brasslantern.com>  <2272F4CC-1655-4DF8-B913-45717A28E4F0@kba.biglobe.ne.jp> <160131090359.ZM11407@torch.brasslantern.com>
To: "zsh-workers@zsh.org" <zsh-workers@zsh.org>
X-Mailer: Apple Mail (2.1510)
X-Biglobe-Spnum: 52374


On 2016/02/01, at 2:03, Bart Schaefer <schaefer@brasslantern.com> 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).