[Top][All Lists]

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

Re: [Gnu-arch-users] Re: doc formats

From: Stephen J. Turnbull
Subject: Re: [Gnu-arch-users] Re: doc formats
Date: Fri, 20 Jan 2006 20:53:22 +0900
User-agent: Gnus/5.1007 (Gnus v5.10.7) XEmacs/21.5-b24 (dandelion, linux)

>>>>> "Miles" == Miles Bader <address@hidden> writes:

    Miles> Er, I don't know about that.  There are about 1,783
    Miles> different "structured text" formats out there, and ReST
    Miles> doesn't seem to be a particularly great one.

Have you actually used it?  I use it all the time, and I like it a
lot.  I've tried others, including StructuredText and ASCIIText and
YaML, and reST is the best of those I tried.

    Miles> and the table syntax is completely awful (tables are
    Miles> actually ascii-art tables, which are a big pain in the butt
    Miles> to maintain).

==== == ======================================
What is so hard about a format like this?
==== == ======================================
Hell I  sure don't know.
It's a  pretty easy thing to type.
Yes, a  reST table does require some fiddling.
Eg,  I  had to extend the rules for fiddling.
==== == ======================================

Of course if you want something complex, with cells spanning rows and
columns, it's annoying because you need the vertical rules.  I don't
see how to avoid that, though, and table.el does pretty well with it
(IIRC -- I don't actually use anything but the simple format above in

On the other hand, when reST as the standard markup for manuals came
up on python-dev a couple weeks ago, there was determined opposition
from both the LaTeX crowd (current standard) and the "semantic markup"
(ie, XML) crowd.  Not a great recommendation.

School of Systems and Information Engineering
University of Tsukuba                    Tennodai 1-1-1 Tsukuba 305-8573 JAPAN
               Ask not how you can "do" free software business;
              ask what your business can "do for" free software.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]