From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mailout.scc.kit.edu (mailout.scc.kit.edu [129.13.185.202])
	by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id s2SLV1xk028798
	for <discuss@mdocml.bsd.lv>; Fri, 28 Mar 2014 17:31:02 -0400 (EDT)
Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82])
	by scc-mailout-02.scc.kit.edu with esmtp (Exim 4.72 #1)
	id 1WTeMe-000383-82; Fri, 28 Mar 2014 22:31:00 +0100
Received: from donnerwolke.usta.de ([172.24.96.3])
	by hekate.usta.de with esmtp (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1WTeMe-0005xA-6q; Fri, 28 Mar 2014 22:31:00 +0100
Received: from iris.usta.de ([172.24.96.5] helo=usta.de)
	by donnerwolke.usta.de with esmtp (Exim 4.72)
	(envelope-from <schwarze@usta.de>)
	id 1WTeMe-00057Z-8P; Fri, 28 Mar 2014 22:31:00 +0100
Received: from schwarze by usta.de with local (Exim 4.77)
	(envelope-from <schwarze@usta.de>)
	id 1WTeMd-0002OK-VQ; Fri, 28 Mar 2014 22:31:00 +0100
Date: Fri, 28 Mar 2014 22:30:59 +0100
From: Ingo Schwarze <schwarze@usta.de>
To: "Anthony J. Bentley" <anthony@cathet.us>
Cc: discuss@mdocml.bsd.lv
Subject: Re: tbl(7) text blocks
Message-ID: <20140328213059.GB10236@iris.usta.de>
References: <20314.1395991264@cathet.us>
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: <20314.1395991264@cathet.us>
User-Agent: Mutt/1.5.21 (2010-09-15)

Hi Anthony,

Anthony J. Bentley wrote on Fri, Mar 28, 2014 at 01:21:04AM -0600:

> Groff's tbl(1) manual has a section named "Text blocks." Quoting from it:
> 
>   A text block can be used to enter data as a single entry which would be
>   too long as a simple string between tabs.  It is started with `T{' and
>   closed with `T}'.  The former must end a line, and the latter must
>   start a line, probably followed by other data columns (separated with
>   tabs or the character given with the tab global option).

That's supported by mandoc as well, quoting tbl(7):

    If the last cell of a line is T{, all subsequent lines are included
    as part of the cell until T} is specified as its own data cell.
    It may then be followed by a tab (or as designated by tab) or an
    end-of-line to terminate the row.

> This feature is used by reStructuredText. For example, the following
> selection from mpv(1)'s documentation:
> 
>     =============   ================================================
>     left-click      play previous file in playlist
>     shift+L-click   show playlist
>     =============   ================================================
> 
> generates the following tbl(7) source:
> 
> .TS
> center;
> |l|l|.

Hum.  What mandoc doesn't seem to support is leading vertical lines
(ignored, see tbl_term.c, term_tbl(), 
 if (NULL != hp->prev) tbl_vrule(tp, hp); )
and trailing vertical lines
(errors out, see tbl_layout.c, cell() handles '|' at the beginning,
 but not at the end).

> _
> T{
> left\-click
> T}	T{
> play previous file in playlist
> T}
> _
> T{
> shift+L\-click
> T}	T{
> show playlist
> T}
> _
> .TE

The following slight modification works with mandoc:

.TH bentley140328mod 1
.SH NAME
bentley140328 \- bug report
.SH DESCRIPTION
normal text
.TS
box center;
l | l.
T{
left\-click
T}	T{
play previous file in playlist
T}
_
T{
shift+L\-click
T}	T{
show playlist
T}
.TE
normal text

Probably, the two missing features should be implemented in mandoc.

Thanks for the report,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv