From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from smtp1.rz.uni-karlsruhe.de (Debian-exim@smtp1.rz.uni-karlsruhe.de [129.13.185.217])
	by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id o570ZLf8025301
	for <discuss@mdocml.bsd.lv>; Sun, 6 Jun 2010 20:35:22 -0400 (EDT)
Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82])
	by smtp1.rz.uni-karlsruhe.de with esmtp (Exim 4.63 #1)
	id 1OLQJD-0002yK-2a; Mon, 07 Jun 2010 02:35:19 +0200
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.71)
	(envelope-from <schwarze@usta.de>)
	id 1OLQJD-0002N0-16
	for discuss@mdocml.bsd.lv; Mon, 07 Jun 2010 02:35:19 +0200
Received: from iris.usta.de ([172.24.96.5] helo=usta.de)
	by donnerwolke.usta.de with esmtp (Exim 4.69)
	(envelope-from <schwarze@usta.de>)
	id 1OLQJD-0000qH-0M
	for discuss@mdocml.bsd.lv; Mon, 07 Jun 2010 02:35:19 +0200
Received: from schwarze by usta.de with local (Exim 4.71)
	(envelope-from <schwarze@usta.de>)
	id 1OLQJC-0006mf-L4
	for discuss@mdocml.bsd.lv; Mon, 07 Jun 2010 02:35:18 +0200
Date: Mon, 7 Jun 2010 02:35:18 +0200
From: Ingo Schwarze <schwarze@usta.de>
To: discuss@mdocml.bsd.lv
Subject: Re: Giving up on emulating SYNOPSIS vspace.
Message-ID: <20100607003518.GG5137@iris.usta.de>
References: <4C0C2CC4.3040306@bsd.lv>
X-Mailinglist: mdocml-discuss
Reply-To: discuss@mdocml.bsd.lv
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <4C0C2CC4.3040306@bsd.lv>
User-Agent: Mutt/1.5.20 (2009-06-14)

Hi Kristaps,

> First, I propose that SYNOPSIS sections be grouped into the
> following macro sets,
> 
>  .In
>  .Ft/Fn ("combo", i.e., one after the other)
>  .Ft/Fo (same)
>  .Fo
>  .Fn
>  .Fd
> 
> with rules as follows.  Any macro/combo of these sets will be
> preceded and proceeded by a newline.  It doesn't matter what the
> hell comes before or after or whether these are line macros or not.
> 
> Next, non-like pair-wise sets will be separated by a single vertical space.
> 
> Lastly, like pairwise Ft/Fn, Ft/Fo, Fo, and Fn are separated by a
> single vertical space.

That definitely sounds sane, and it covers the most important use cases.

I'm not 100% sure this covers all sane use cases, even though i couldn't
name a real-world manual page that needs additional rules, off the top
of my head.

So, i think implementing this has good chances to be OK;
there is a small risk it turns out to not be better in practice
than what we have now, but in that case it will hopefully not be
too difficult to add the missing feature(s).

[...]
> move on with PostScript and Ingo's block-breaking patches.

Oh, you don't have the final version yet, what you have is
 1) known buggy
 2) not feature-complete

I need to check that the final version in my tree is really
complete and correct, extract it and post it.  I hope to get
round to that.  It's really the next thing i should do with
respect to mandoc, now that 1.10.1 is merged into OpenBSD.

Yours,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv