[GHC] #2602: Haddock not installed properly
Claus Reinke
claus.reinke at talk21.com
Thu Sep 25 11:21:33 EDT 2008
haddock also does not seem to generate cross-package references
correctly; some of them it warns about (second example below), some
it just inserts wrongly, using $httptopdir/doc/libraries/ (first example below).
Claus
-- after installing haddocked syb-utils:
$ grep -A2 IntSet /cygdrive/c/Program\ Files/Haskell/doc/syb-utils-0.0.2008.9.22/html/Data-Generics
-GPS.html
build IntSets of TypeRep keys, both for the domains of traversals and
for substructure types; then several short-circuiting decisions can be
based on fast intersection tests with the same IntSet).
</P
><P
--
> keys combined with IntSets or IntMaps can be used to speed up
other generic programming problems as well, including typecase and
extensible records libraries.
--
> = <A HREF="$httptopdir/doc/libraries/containers/Data-IntSet.html#t%3AIntSet"
>IntSet</A
></TD
></TR
--
> = <A HREF="$httptopdir/doc/libraries/containers/Data-IntSet.html#t%3AIntSet"
>IntSet</A
></TD
></TR
In the output below, note that haddock is supplied with
--read-interface=$httptopdir/doc/libraries/syb,C:\ghc\ghc-6.11.20080925/doc/libraries/syb\syb.haddock
but still can't find Data.Generics.Basics in syb, and always seems to use
the $httptopdir/doc/libraries/ for crosslinks.
$ runhaskell Setup.hs haddock --verbose
Creating dist\build\tmp (and its parents)
Creating dist\doc\html\syb-utils (and its parents)
Preprocessing library syb-utils-0.0.2008.9.22...
Running Haddock for syb-utils-0.0.2008.9.22...
Warning: The documentation for the following packages are not installed. No
links will be generated to these packages: rts-1.0
C:\ghc\ghc-6.11.20080925\bin\haddock.exe --ghc-version
C:\ghc\ghc-6.11.20080925\bin\ghc.exe --print-libdir
Creating dist\build (and its parents)
Creating dist\build\autogen (and its parents)
Preprocessing library syb-utils-0.0.2008.9.22...
C:\ghc\ghc-6.11.20080925\bin\haddock.exe --html --odir=dist\doc\html\syb-utils --title=syb-utils-0.0
.2008.9.22: Modifications and Additions to Data.Generics/Syb --dump-interface=dist\doc\html\syb-util
s\syb-utils.haddock --prologue=dist\syb-utils-0.0.2008.9.22-haddock-prolog3380.txt --optghc=-package
-name --optghc=syb-utils-0.0.2008.9.22 --read-interface=$httptopdir/doc/libraries/Cabal,C:\ghc\ghc-6
.11.20080925/doc/libraries/Cabal\Cabal.haddock --read-interface=$httptopdir/doc/libraries/Win32,C:\g
hc\ghc-6.11.20080925/doc/libraries/Win32\Win32.haddock --read-interface=$httptopdir/doc/libraries/ar
ray,C:\ghc\ghc-6.11.20080925/doc/libraries/array\array.haddock --read-interface=$httptopdir/doc/libr
aries/base,C:\ghc\ghc-6.11.20080925/doc/libraries/base\base.haddock --read-interface=$httptopdir/doc
/libraries/bytestring,C:\ghc\ghc-6.11.20080925/doc/libraries/bytestring\bytestring.haddock --read-in
terface=$httptopdir/doc/libraries/containers,C:\ghc\ghc-6.11.20080925/doc/libraries/containers\conta
iners.haddock --read-interface=$httptopdir/doc/libraries/directory,C:\ghc\ghc-6.11.20080925/doc/libr
aries/directory\directory.haddock --read-interface=$httptopdir/doc/libraries/filepath,C:\ghc\ghc-6.1
1.20080925/doc/libraries/filepath\filepath.haddock --read-interface=$httptopdir/doc/libraries/ghc,C:
\ghc\ghc-6.11.20080925/doc/libraries/ghc\ghc.haddock --read-interface=$httptopdir/doc/libraries/ghc-
prim,C:\ghc\ghc-6.11.20080925/doc/libraries/ghc-prim\ghc-prim.haddock --read-interface=$httptopdir/d
oc/libraries/haskell98,C:\ghc\ghc-6.11.20080925/doc/libraries/haskell98\haskell98.haddock --read-int
erface=$httptopdir/doc/libraries/hpc,C:\ghc\ghc-6.11.20080925/doc/libraries/hpc\hpc.haddock --read-i
nterface=$httptopdir/doc/libraries/integer,C:\ghc\ghc-6.11.20080925/doc/libraries/integer\integer.ha
ddock --read-interface=$httptopdir/doc/libraries/old-locale,C:\ghc\ghc-6.11.20080925/doc/libraries/o
ld-locale\old-locale.haddock --read-interface=$httptopdir/doc/libraries/old-time,C:\ghc\ghc-6.11.200
80925/doc/libraries/old-time\old-time.haddock --read-interface=$httptopdir/doc/libraries/packedstrin
g,C:\ghc\ghc-6.11.20080925/doc/libraries/packedstring\packedstring.haddock --read-interface=$httptop
dir/doc/libraries/pretty,C:\ghc\ghc-6.11.20080925/doc/libraries/pretty\pretty.haddock --read-interfa
ce=$httptopdir/doc/libraries/process,C:\ghc\ghc-6.11.20080925/doc/libraries/process\process.haddock
--read-interface=$httptopdir/doc/libraries/random,C:\ghc\ghc-6.11.20080925/doc/libraries/random\rand
om.haddock --read-interface=$httptopdir/doc/libraries/syb,C:\ghc\ghc-6.11.20080925/doc/libraries/syb
\syb.haddock --read-interface=$httptopdir/doc/libraries/template-haskell,C:\ghc\ghc-6.11.20080925/do
c/libraries/template-haskell\template-haskell.haddock -BC:\ghc\ghc-6.11.20080925 --optghc=-hide-all-
packages --optghc=-package --optghc=base-4.0.0.0 --optghc=-package --optghc=containers-0.2.0.0 --opt
ghc=-package --optghc=ghc-6.11.20080925 --optghc=-package --optghc=syb-0.1.0.0 --optghc=-i --optghc=
-i. --optghc=-idist\build\autogen --optghc=-idist\build --optghc=-optP-include --optghc=-optPdist\bu
ild\autogen\cabal_macros.h --optghc=-odir --optghc=dist\build --optghc=-hidir --optghc=dist\build --
optghc=-XExistentialQuantification --optghc=-XRankNTypes --optghc=-XScopedTypeVariables --optghc=-XD
eriveDataTypeable --optghc=-XFlexibleInstances --optghc=-XStandaloneDeriving --optghc=-XCPP GHC.Syb.
Instances GHC.Syb.Utils Data.Generics.Alt Data.Generics.NoInstances Data.Generics.GPS Data.Generics.
Utils Data.Generics.Instances.Standard Data.Generics.Instances.Partial Data.Generics.Instances.Dubio
us
Warning: in export list of "Data.Generics.NoInstances": module not found: "Data.Generics.Basics"
Warning: in export list of "Data.Generics.NoInstances": module not found: "Data.Generics.Aliases"
Warning: in export list of "Data.Generics.NoInstances": module not found: "Data.Generics.Schemes"
Warning: in export list of "Data.Generics.NoInstances": module not found: "Data.Generics.Text"
Warning: in export list of "Data.Generics.NoInstances": module not found: "Data.Generics.Twins"
Warning: in export list of "Data.Generics.Alt": module not found: "Data.Generics.Basics"
Warning: in export list of "Data.Generics.Alt": module not found: "Data.Generics.Aliases"
Warning: in export list of "Data.Generics.Alt": module not found: "Data.Generics.Schemes"
Warning: in export list of "Data.Generics.Alt": module not found: "Data.Generics.Text"
Warning: in export list of "Data.Generics.Alt": module not found: "Data.Generics.Twins"
Warning: syb-utils-0.0.2008.9.22:Data.Generics.Utils: could not find link destinations for:
Data.Generics.Utils.X
Documentation created: dist\doc\html\syb-utils\index.html
> [using email instead of haddock trac, which still doesn't send notifications]
>
> The haddock package still has the wrong paths, though:
>
> $ /cygdrive/c/ghc/ghc-6.11.20080925/bin/ghc-pkg describe haddock | grep ghc
> import-dirs: d:/fptools/ghc/ghc-6.11.20080925\haddock-2.2.2
> library-dirs: d:/fptools/ghc/ghc-6.11.20080925\haddock-2.2.2
> extra-ghci-libraries:
> directory-1.0.0.2 filepath-1.1.0.1 ghc-6.11.20080925
> haddock-html: d:/fptools/ghc/ghc-6.11.20080925/doc
>
> (pointing to build, rather than install directories)
>
> Claus
>
> ----- Original Message -----
> From: "GHC" <trac at galois.com>
> Cc: <glasgow-haskell-bugs at haskell.org>
> Sent: Thursday, September 25, 2008 12:41 PM
> Subject: Re: [GHC] #2602: Haddock not installed properly
>
>
>> #2602: Haddock not installed properly
>> --------------------------+-------------------------------------------------
>> Reporter: NeilMitchell | Owner: Type: bug | Status: closed
>> Priority: normal | Milestone: Component: Compiler | Version:
>> 6.9 Severity: normal | Resolution: fixed Keywords: |
>> Difficulty: Unknown
>> Testcase: | Architecture: Unknown
>> Os: Unknown
>> | --------------------------+-------------------------------------------------
>> Changes (by igloo):
>>
>> * status: new => closed
>> * difficulty: => Unknown
>> * resolution: => fixed
>>
>> Comment:
>>
>> Thanks for the report; now fixed.
>>
>> --
>> Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/2602#comment:2>
>> GHC <http://www.haskell.org/ghc/>
>> The Glasgow Haskell Compiler
>
>
> --------------------------------------------------------------------------------
>
>
>> _______________________________________________
>> Glasgow-haskell-bugs mailing list
>> Glasgow-haskell-bugs at haskell.org
>> http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
>>
> _______________________________________________
> Glasgow-haskell-bugs mailing list
> Glasgow-haskell-bugs at haskell.org
> http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
More information about the Glasgow-haskell-bugs
mailing list