[darcs-users] Separating the user manual and code

David Roundy daveroundy at gmail.com
Sat Oct 25 14:01:59 UTC 2008


On Wed, Oct 22, 2008 at 12:59 AM, Jason Dagit <dagit at codersbase.com> wrote:
> On Tue, Oct 21, 2008 at 9:27 PM, Trent W. Buck <trentbuck at gmail.com> wrote:
>
> I like your points, here are just a few comments I had.
>
>>  Literate Haskell means the user manual source has to be TeX.  A
>>  separate tree would allow us to evaluate alternative source formats,
>>  such as texinfo, docbook or restructured text (reST).
>
> I don't think this is strictly true unless the alternative format
> doesn't allow \begin{code} ... \end{code} or lines beginning with the
> greater than symbol.

To be more accurate, it's strictly false.  Since we remove all the
code blocks before processing the  documentation, it could be done in
any language.

David


More information about the darcs-users mailing list