[Haskell] Re: haddock not finding base lib docs -- $topdir ?

[Conal Elliott]

Oops!  There's another problem with these paths.  Haddock-generated links to
library functions come out like

    c:/ghc/ghc-6.6/doc/html/libraries/base/Data-Char.html#t%3AString

which is not a valid URL, as it's missing a "file:///" prefix.

On 12/5/06, Conal Elliott <conal at conal.net> wrote:
>
> Thanks for the explanation & suggestions, Simon.  Your "other workaround"
> worked for me: I replaced $topdir\\html with c:\\ghc\\ghc-6.6\\doc\\htmlin my
> package.conf.  Note the *doc*, so a straightforward $topdir splice would
> not do the trick.   Cheers,  - Conal
>
> On 12/5/06, Simon Marlow <simonmarhaskell at gmail.com> wrote:
> >
> > Conal Elliott wrote:
> > > I'm running haddock for the first time, via cabal.  I get the
> > following
> > > message when i do "runhaskell Setup.hs haddock" on monadLib:
> > >
> > >  Warning: cannot use package base-2.0:
> > >     HTML directory $topdir\html\libraries\base does not exist.
> > >
> > > I do have c:/ghc/ghc-6.6/doc/html/libraries/base/.  Is there some way
> > i
> > > can let cabal know how to find it?  What is $topdir about?
> >
> > This is due to the way GHC is installed on Windows, the package database
> > doesn't
> > have hardcoded pathnames, the idea being that you can move your GHC
> > anywhere in
> > the filesystem and it will still work.
> >
> > Unfortunately this means that Haddock can't find the documentation for
> > the packages.
> >
> > One workaround is to specify the paths by hand, using Haddock's
> > --read-interface
> > flag.  You're using Haddock via Cabal though, so that doesn't work too
> > well.
> > The other workaround is to find GHC's package.conf file and replace the
> > string
> > $topdir with the literal path ("c:/ghc/ghc-6.6" in your case - perhaps
> > you have
> > to append "/doc" for the haddock fields, though).
> >
> > I'll file a bug report against Cabal, we should really make this work.
> >
> > Cheers,
> >         Simon
> >
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.haskell.org/pipermail/haskell/attachments/20061205/444ce2d2/attachment.htm