Re: RFD: tables in documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Sat, May 01, 2010 at 08:37:39PM +0200, Michael J Gruber wrote:

> Currently, all tables are formatted using indentation by spaces. This
> breaks whenever AsciiDoc's parsing changes.
> 
> Instead, I suggest to use AsciiDoc's table syntax which also produces
> proper tables in the HTML and man output. I formatted the first part of
> the first table in git-read-tree(1) like that so that you can compare
> easily.

Conceptually I am in favor of semantic markup where possible. I find the
resulting manpage a little harder to read, though. Is it possible for us
to style it a bit more (e.g., such a simple table looks better, IMHO,
without ascii-art borders).

> I put it up at http://repo.or.cz/w/git/mjg.git/commit/table-example for
> your viewing pleasure. I'd say it looks great even in links (but not in
> lynx). It also shows a problem of xmlto with multiple rowspans (the xml
> is correct, .1 apparently not), which could be circumvented easily by
> repeating those cells.

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.

-Peff
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]