git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: RFD: tables in documentation

From
Michael J Gruber <git@drmicha.warpmail.net>
Date
May 2, 2010, 19:23 UTC
Message-ID
<4BDDD14C.7040503@drmicha.warpmail.net>
In-Reply-To
<20100502175353.GA15521@progeny.tock>
Jonathan Nieder venit, vidit, dixit 02.05.2010 19:53:
Show 34 quoted lines
> Hi Michael,
> 
> Michael J Gruber wrote:
>> Michael J Gruber venit, vidit, dixit 02.05.2010 17:08:
> 
>>> 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.
> [...]
>> 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.]
> 
> For what it’s worth, except for the broken last row, I like this and
> find it readable.  It is too bad there is no way to make it more
> compact so more rows can fit on a screen or page.
> 
> The ideal, to delimit the header without appearing busy, would be to
> just have a thin horizontal rule separating the header from the
> remaining rows[1].  Vertical rules are almost never a good idea.
> Maybe frame="topbot",grid="none",options="header" would be a good
> approximation.

That looks nice in HTML (and produces the correct xml), but unfortunately my docbook renders this as if I had frame="all",grid="all" :(

Show 5 quoted lines
> 
> Jonathan
> 
> [1] Just my opinion.  I probably learned the aesthetic from Simon Fear.
> http://www.tex.ac.uk/cgi-bin/texfaq2html?label=destable
Previous: Jonathan NiederNext: Jeff King
Message 9 of 11 in “RFD: tables in documentation”
  1. Michael J GruberMay 1, 2010
  2. Jeff KingMay 2, 2010
  3. Michael J GruberMay 2, 2010
  4. Will PalmerMay 2, 2010
  5. Will PalmerMay 2, 2010
  6. Michael J GruberMay 2, 2010
  7. Michael J GruberMay 2, 2010
  8. Jonathan NiederMay 2, 2010
  9. Michael J GruberMay 2, 2010
  10. Jeff KingMay 25, 2010
  11. Michael J GruberMay 25, 2010

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.