Eric Kow <[email protected]> writes:
> On Wed, Jan 21, 2009 at 21:10:04 -0800, Trent W. Buck wrote:
>> We should add these directories to the "find src" calls above, but
>> this hack is easier to understand and should suffice until we finish
>> switching to Cabal.
>
> Speaking of which, what are we waiting on?
The user documentation can't be built by Cabal at the moment. This is
mainly held up by needing to compile preproc.hs, then using that to
generate the .tex files, as Cabal can't compile build helper tools
without also installing them into the final system.
What preproc does is take a bunch of static TeX files that have some
minor extensions (\haskell{...}) and produce a pair of single .tex files
that LaTeX and latex2html (respectively) compile. Preproc handles
static .tex file include, but it also handles inclusion of docstrings
from the Haskell source code.
The immediate solution is to remove preproc and extend the main darcs
binary such that it can emit the internal docstring parts, in such a way
that an ordinary TeX \input{docstrings.tex} can access them.
I've been avoiding this because I tend to run off on a tangent when I
try to address this issue, e.g. lately I've been thinking stuff like
"wow, it'd be cool if darcs used pandoc, and you could just get the
whole manual in any format with "darcs manual --format foo!"
_______________________________________________
darcs-users mailing list
[email protected]
http://lists.osuosl.org/mailman/listinfo/darcs-users
