
I've been working on some haddock-related Cabal tweaks and a "make" include
file called "cabal-make", which manages syntax coloring (vis hscolour) with
links from the haddock docs, web-based links to other libraries, and
wiki-based user comments. It's ready to release for others' use except for
one problem (as mentioned below). The --haddock-args flag ends up turning
my forward slashes into backslashes (on my WinXP machine), so all of the web
links are broken. I'd appreciate suggestions about this problem.
You can find an example doc generated by cabal-make (a previous
implementation that didn't quite fit cabal) at
http://darcs.haskell.org/packages/TV/doc/html/Interface-TV-Output.html .
Suggestions welcome.
- Conal
---------- Forwarded message ----------
From: Conal Elliott
Hi Conel. Thanks for this! It sounds like the ideas from your makefile could be used for Hackage for generating nice Haddock :)
There is a general meachanism for adding --foo-args for each Program that cabal knows about; can you use this meachanism to add --foo-arg as well, instead of special-casing for haddock?
If you do that, can you make the help output not suck? Currently it does something like this:
--ar-args=ARGS give the args to ar --haddock-args=ARGS give the args to haddock --ld-args=ARGS give the args to ld --pfesetup-args=ARGS give the args to pfesetup --ranlib-args=ARGS give the args to ranlib --runghc-args=ARGS give the args to runghc --runhugs-args=ARGS give the args to runhugs --tar-args=ARGS give the args to tar
it would be nice to concerve lines with sometthing like this:
--ar-arg=ARG --ar-args=ARGS give the arg or args to ar --haddock-arg=ARG --haddock-args=ARGS give the arg or args to haddock etc
The patch you sent seemed like an empty file to me. Maybe I'm just being nihilistic ;)
peace,
isaac

Do forward slashes get turned into backslashes for xxxx-args arguments in
Windows? Could someone point me to the code that does it? I could add a
setup flag that disables the translation, or maybe detect the "http://" and
just preserve what looks to be URLs.
BTW, cabal-make now has a target that auto-subscribes to all wiki talk pages
generated for a project.
- Conal
On 1/22/07, Conal Elliott
I've been working on some haddock-related Cabal tweaks and a "make" include file called "cabal-make", which manages syntax coloring (vis hscolour) with links from the haddock docs, web-based links to other libraries, and wiki-based user comments. It's ready to release for others' use except for one problem (as mentioned below). The --haddock-args flag ends up turning my forward slashes into backslashes (on my WinXP machine), so all of the web links are broken. I'd appreciate suggestions about this problem.
You can find an example doc generated by cabal-make (a previous implementation that didn't quite fit cabal) at http://darcs.haskell.org/packages/TV/doc/html/Interface-TV-Output.html . Suggestions welcome.
- Conal
---------- Forwarded message ---------- From: Conal Elliott
Date: Jan 19, 2007 5:18 PM Subject: Re: [Conal Elliott] Re: getting cabal to pass more info to haddock To: Isaac Jones Cc: cabal-devel < cabal-devel@haskell.org> Hi Isaac. Now I see why the patch file was empty. And after some head-scratching about your note below, I'm glad the patch was empty. I hadn't noticed the --xxx-args flags for configure, and instead added a new haddock flag. Giving a flag to configure makes a lot more sense.
So now I have just a new pair of flags enable-use-packages & disable-use-packages, which control whether haddock gets automatically-generated --use-package flags.
My makefile are now performing this sort of incantation:
./setup configure --disable-use-packages --haddock-args="\ --read-interface=http://haskell.org/ghc/docs/latest/html/libraries/base,c:/ghc/ghc-6.6/doc/ht... \ --read-interface=http://haskell.org/ghc/docs/latest/html/libraries/mtl,c:/ghc/ghc-6.6/doc/html/libraries/mtl/mtl.haddock\ "
The only problem is --haddock-args ends up turning my forward slashes into backslashes, so all of the web links are broken.
Any advice?
- Conal
On 1/17/07, Isaac Jones
wrote: Hi Conel. Thanks for this! It sounds like the ideas from your makefile could be used for Hackage for generating nice Haddock :)
There is a general meachanism for adding --foo-args for each Program that cabal knows about; can you use this meachanism to add --foo-arg as well, instead of special-casing for haddock?
If you do that, can you make the help output not suck? Currently it does something like this:
--ar-args=ARGS give the args to ar --haddock-args=ARGS give the args to haddock --ld-args=ARGS give the args to ld --pfesetup-args=ARGS give the args to pfesetup --ranlib-args=ARGS give the args to ranlib --runghc-args=ARGS give the args to runghc --runhugs-args=ARGS give the args to runhugs --tar-args=ARGS give the args to tar
it would be nice to concerve lines with sometthing like this:
--ar-arg=ARG --ar-args=ARGS give the arg or args to ar --haddock-arg=ARG --haddock-args=ARGS give the arg or args to haddock etc
The patch you sent seemed like an empty file to me. Maybe I'm just being nihilistic ;)
peace,
isaac

On Wed, 2007-01-24 at 22:51 -0800, Conal Elliott wrote:
Do forward slashes get turned into backslashes for xxxx-args arguments in Windows?
Are you using a shell like Mingw's MSYS? If so it does do that kind of translation. If you're getting that behaviour when using an ordinary windows command prompt (cmd.exe) then it's a cabal issue. Duncan

I've been using Cygwin's bash & make, but I just verified that I get the same behavior when I use cmd.exe directly. I run this command (in cmd.exe): setup configure --disable-use-packages --haddock-args=" --read-interface=
http://haskell.org/ghc/docs/latest/html/libraries/base,c:/ghc/ghc-6.6/doc/ht... http://haskell.org/ghc/docs/latest/html/libraries/mtl,c:/ghc/ghc-6.6/doc/htm... http://wxhaskell.sourceforge.net/doc,c:/Haskell/wxhaskell/out/doc/wxhaskell...." --prefix=c:/Haskell/packages --datadir=c:/Haskell/packages
and the resulting.setup-config file's withProgram field contains this element: ("haddock",Program {programName = "haddock", programBinName = "haddock",
programArgs = ["--read-interface=http:\\\\haskell.org\\ghc\\docs\\latest\\html\\libraries\\base,c:\\ghc\\ghc- 6.6\\doc\\html\\libraries\\base\\base.haddock ","--read-interface=http:\\\\haskell.org\\ghc\\docs\\latest\\html\\libraries\\mtl,c:\\ghc\\ghc- 6.6\\doc\\html\\libraries\\mtl\\mtl.haddock","--read-interface=http:\\\\wxhaskell.sourceforge.net\\doc,c:\\Haskell\\wxhaskell\\out\\doc\\wxhaskell.haddock"], programLocation = FoundOnSystem "c:\\Haskell\\packages\\Haskell\\bin\\haddock.exe"})
and many other fields with similar translation of file paths.
- Conal
On 1/25/07, Duncan Coutts
On Wed, 2007-01-24 at 22:51 -0800, Conal Elliott wrote:
Do forward slashes get turned into backslashes for xxxx-args arguments in Windows?
Are you using a shell like Mingw's MSYS? If so it does do that kind of translation. If you're getting that behaviour when using an ordinary windows command prompt (cmd.exe) then it's a cabal issue.
Duncan
participants (2)
-
Conal Elliott
-
Duncan Coutts