From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mail-ie0-f170.google.com (mail-ie0-f170.google.com [209.85.223.170])
	by krisdoz.my.domain (8.14.5/8.14.5) with ESMTP id s2S7LD2U031222
	for <discuss@mdocml.bsd.lv>; Fri, 28 Mar 2014 03:21:14 -0400 (EDT)
Received: by mail-ie0-f170.google.com with SMTP id rd18so4565440iec.1
        for <discuss@mdocml.bsd.lv>; Fri, 28 Mar 2014 00:21:07 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20130820;
        h=x-gm-message-state:from:to:subject:date:message-id;
        bh=VT+rLgVNY2m1J60i6BRzbXRd0Gy39YTQx4v2a5/ZrQw=;
        b=arymDQ75UNm6z4fnRd6sMGPJYUUgMsaP0Yl/d5CqaniCg6BTdOZQcIYWmVUMHQETkq
         GiU2+Ijws7jD6AuTtmy11XHJkgsCNwn1txKNv5tMDsjimB4e0gVbrRfQAzDRT1x8zOBY
         mpBXtd1h4plGf5cSi10EEZHZjHHZ7uJGLh6Z17V+7LnFx58ja2y2w2e35Q8Jh0EmKsib
         m6LHisSeqpywnv0AGUeEQxnvUPB1KxfAd8P8ywFIFco3wNHI6O0Zua7hFGHOxogG7vCb
         Xub5Vz+L5Ea+JG7tBiIYeyPt8bAaafz7yXXlZcOazLNOR79YK4wJem88kZF6EHmEOUSf
         j36w==
X-Gm-Message-State: ALoCoQmAiyEXodO/d3EAfhlDkJFAg3Iqfqc1/L7E+aeiTOat1t/7goASdSL8DxNu5wrH7TDQ5yDt
X-Received: by 10.42.131.197 with SMTP id a5mr6135992ict.8.1395991266322;
        Fri, 28 Mar 2014 00:21:06 -0700 (PDT)
Received: from cathet.us. (97-123-136-196.albq.qwest.net. [97.123.136.196])
        by mx.google.com with ESMTPSA id sc8sm3126078igb.0.2014.03.28.00.21.05
        for <discuss@mdocml.bsd.lv>
        (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
        Fri, 28 Mar 2014 00:21:05 -0700 (PDT)
Received: from cathet.us (localhost [127.0.0.1]);
	by cathet.us. (OpenSMTPD) with ESMTP id 1ba6f598;
	for <discuss@mdocml.bsd.lv>;
	Fri, 28 Mar 2014 01:21:04 -0600 (MDT)
From: "Anthony J. Bentley" <anthony@cathet.us>
To: discuss@mdocml.bsd.lv
Subject: tbl(7) text blocks
Date: Fri, 28 Mar 2014 01:21:04 -0600
Message-ID: <20314.1395991264@cathet.us>
X-Mailinglist: mdocml-discuss
Reply-To: discuss@mdocml.bsd.lv

Hi,

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).

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|.
_
T{
left\-click
T}      T{
play previous file in playlist
T}
_
T{
shift+L\-click
T}      T{
show playlist
T}
_
.TE

Groff converts that to the following:

                       +--------------+-----------------------+
                       |left-click    | play previous file in |
                       |              | playlist              |
                       +--------------+-----------------------+
                       |shift+L-click | show playlist         |
                       +--------------+-----------------------+

Mandoc outputs nothing. -Tlint reveals:

/tmp/mpv.1:9:3: ERROR: bad table layout
/tmp/mpv.1:11:1: ERROR: bad table layout
/tmp/mpv.1:12:4: ERROR: bad table layout
/tmp/mpv.1:13:1: ERROR: bad table layout
/tmp/mpv.1:14:1: ERROR: bad table layout
/tmp/mpv.1:15:1: ERROR: bad table layout
/tmp/mpv.1:17:1: ERROR: bad table layout
/tmp/mpv.1:18:1: ERROR: bad table layout
/tmp/mpv.1:19:1: ERROR: bad table layout
/tmp/mpv.1:20:1: ERROR: bad table layout
/tmp/mpv.1:21:1: ERROR: bad table layout
/tmp/mpv.1:7:1: ERROR: no table data cells specified

-- 
Anthony J. Bentley
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv