[darcs-devel] [issue1221] Option lists in reST

[Trent Buck]

New submission from Trent Buck <trentbuck at gmail.com>:

It turns out that while the current output from "darcs --help" is
well-formed reST, it is not marked up quite correctly -- resulting in
ugly output.

Darcs help's output needs to be changed so as to be marked up well for
reST.  If people think the reST output is too ugly, we need instead to
continue down the preproc.hs route and have two versions of show() for
darcs commands -- one for TeX (now reST) and one for humans.

Here is the original reply from the rst2pdf maintainer:

On Mon, Nov 10, 2008 at 11:11:12AM -0200, Roberto Alsina wrote:
> Trent W. Buck writes:
>> Hi, see attached example.  It looks really ugly.
>
> I took a careful look today and I think your option lists are not
> correctly written.
>
> If you check the restructured text spec, when there are multiple
> options in a line, you need to separate them using ", " and you have
> multiple spaces. [...]  Also, option lists are not supposed to be
> indented, or they are interpreted as being inside a block quote.
>
> I think the html writer is producing a "nice" output mostly by
> coincidence :-)

----------
messages: 6650
nosy: dagit, dmitry.kurochkin, kowey, simon, thorkilnaur, twb
status: unread
title: Option lists in reST

__________________________________
Darcs bug tracker <bugs at darcs.net>
<http://bugs.darcs.net/issue1221>
__________________________________