From mboxrd@z Thu Jan 1 00:00:00 1970 From: Michael J Gruber Subject: Re: RFD: tables in documentation Date: Sun, 02 May 2010 17:27:47 +0200 Message-ID: <4BDD99F3.9000305@drmicha.warpmail.net> References: <4BDC74F3.2020206@drmicha.warpmail.net> <20100502050622.GF14776@coredump.intra.peff.net> <4BDD7E96.2050603@drmicha.warpmail.net> <1272811394.24767.7.camel@dreddbeard> <1272811916.24767.16.camel@dreddbeard> <4BDD956F.5070800@drmicha.warpmail.net> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Cc: wmpalmer@gmail.com, Jeff King , Git Mailing List To: unlisted-recipients:; (no To-header on input) X-From: git-owner@vger.kernel.org Sun May 02 17:27:57 2010 connect(): No such file or directory Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1O8b5G-0005Tt-56 for gcvg-git-2@lo.gmane.org; Sun, 02 May 2010 17:27:54 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755846Ab0EBP1t (ORCPT ); Sun, 2 May 2010 11:27:49 -0400 Received: from out1.smtp.messagingengine.com ([66.111.4.25]:59641 "EHLO out1.smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751754Ab0EBP1s (ORCPT ); Sun, 2 May 2010 11:27:48 -0400 Received: from compute2.internal (compute2.internal [10.202.2.42]) by gateway1.messagingengine.com (Postfix) with ESMTP id F335FF21F6; Sun, 2 May 2010 11:27:47 -0400 (EDT) Received: from heartbeat1.messagingengine.com ([10.202.2.160]) by compute2.internal (MEProxy); Sun, 02 May 2010 11:27:48 -0400 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=messagingengine.com; h=message-id:date:from:mime-version:cc:subject:references:in-reply-to:content-type:content-transfer-encoding; s=smtpout; bh=86X/e+tZacUww0RMNot84h0vagk=; b=YAIH9z2g9wfVt6fIZami0GN7W/31Dsk5GE0wTxt5GM3PEBbzjPupN34bqqs14oAeuqNFotjTszsnNnSl1zEuExzJyymOypsXa0YFRzeKjBRl10dcwvEpizvt0NiBan2spWo4yomaJldU+EQfq9BqSMRBucUFOG8Pjh+Om4MKUbk= X-Sasl-enc: tYV5XwJ65PQfLfBjW3JxNX6l80dZPXA6pQakAfrJDauA 1272814067 Received: from localhost.localdomain (p5DCC03EE.dip0.t-ipconnect.de [93.204.3.238]) by mail.messagingengine.com (Postfix) with ESMTPSA id B9A1149FAC0; Sun, 2 May 2010 11:27:46 -0400 (EDT) User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.2.5pre) Gecko/20100429 Lightning/1.0b2pre Lanikai/3.1b2pre In-Reply-To: <4BDD956F.5070800@drmicha.warpmail.net> Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: Michael J Gruber venit, vidit, dixit 02.05.2010 17:08: > Will Palmer venit, vidit, dixit 02.05.2010 16:51: >> sorry about that, apparently "shift+enter" means "send" to this thing... >> >> On Sun, 2010-05-02 at 15:43 +0100, Will Palmer wrote: >>> On Sun, 2010-05-02 at 15:31 +0200, Michael J Gruber wrote: >>>> Jeff King venit, vidit, dixit 02.05.2010 07:06: >>>>> On Sat, May 01, 2010 at 08:37:39PM +0200, Michael J Gruber wrote: >>>>> Did you put the source up anywhere? I didn't see it, but it would be >>>>> interesting to see how painful it is to write. >>>> >>>> http://repo.or.cz/w/git/mjg.git/shortlog/refs/heads/doc-use-tables >>>> >>>> Tough guess, I know ;) >>>> >>>> Michael >>> >> >> that looks suspiciously like a format that's intended to be readable in >> both plaintext and eventually-generated form. This is me speaking in >> pure ignorance, but would something like (though I assume not exactly): >> >> [cols="1,3*5,8"] >> |===================== >> | |I |H |M |Result >> | 0 |nothing |nothing |nothing |(does not happen) >> | 1 |nothing |nothing |exists |use M >> | 2 |nothing |exists |nothing |remove path from index >> .2+| 3 .2+|nothing .2+|exists |exists, H == M |use M if "initial checkout", keep index otherwise >> exists, H != M |fail >> |===================== >> >> work as intended? >> > > Uhm, how is that different from my patch (except for spaces which I > didn't bother with for this p-o-c)? [This is AsciiDoc - you know, do > you? ;)] > > Jeff doesn't like the ascii art in the roff output (.1, as can be seen > in the .1.txt file). It looks very "strong", just like the content. > > Further experimentation (editing the xml) indicates that with my > toolchain, I can either shut off all borders (between cells as well as > outer) or none. Why does working with the toolchain always frustrate me? > It's often a hindrance for improvements. > > So, we could shut off all borders by adding an output dependent table > definition in asciidoc.conf, copying current asciidoc's own and > modifying it for docbook-man output. Is it worth it? Maybe others like > the strong ascii borders... For completeness, it results in this: I H M Result 0 nothing nothing nothing (does not happen) 1 nothing nothing exists use M 2 nothing exists nothing remove path from index 3 nothing exists exists, H ==M use M if "initial checkout", keep index exists, H != M fail otherwise [Same unealt rowspan issue, of course.] Michael