[GHC] #4510: No links will be generated to these packages: base-4.3.0.0

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
9 messages Options
GHC
Reply | Threaded
Open this post in threaded view
|

[GHC] #4510: No links will be generated to these packages: base-4.3.0.0

GHC
#4510: No  links will be generated to these packages: base-4.3.0.0
---------------------------------+------------------------------------------
    Reporter:  claus             |       Owner:              
        Type:  bug               |      Status:  new        
    Priority:  normal            |   Component:  Compiler    
     Version:  7.0.1             |    Keywords:              
    Testcase:                    |   Blockedby:              
          Os:  Windows           |    Blocking:              
Architecture:  Unknown/Multiple  |     Failure:  None/Unknown
---------------------------------+------------------------------------------
 As reported earlier, (point 6. in #4292), running haddock (via cabal)
 leads to missing documentation links. This was assumed fixed
 (comment:4:ticket:4292), but apparently not tested - the problem still
 exists (to reproduce, `cabal-install` anything that uses `base` types in
 its documentation, on top of a `7.0.1` windows install, with documentation
 enabled). As I can't see similar failures in hackage build reports, I
 guess the issue is Windows-specific.

 From bug report to guessing at causes:

 My current best bet is the occurrence of unescaped backslashes in
 filepaths in `ghc-pkg` fields (I seem to recall an implicit contract that
 these fields are supposed to be valid Haskell Strings?). As a general
 remark, using forward-slashes seems to be less error-prone.

 Cabal (which generates these warnings, in
 `Distribution/Simple/Haddock.hs`) seems to parse these fields as Haskell
 Strings, and fails when `doesFileExist` can't find the `.haddock`
 interface file.
 {{{
 haddock-interfaces:
 $topdir/../doc/html/libraries/base-4.3.0.0\base.haddock
 }}}
 There are other fields in `ghc-pkg` output that have unescaped backslashes
 in file names (the `*-dirs` family), so apparently the Haskell String
 contract is just my imagination?

--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4510>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler
_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
GHC
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #4510: No links will be generated to these packages: base-4.3.0.0

GHC
#4510: No  links will be generated to these packages: base-4.3.0.0
---------------------------------+------------------------------------------
    Reporter:  claus             |       Owner:              
        Type:  bug               |      Status:  new        
    Priority:  normal            |   Component:  Compiler    
     Version:  7.0.1             |    Keywords:              
    Testcase:                    |   Blockedby:              
          Os:  Windows           |    Blocking:              
Architecture:  Unknown/Multiple  |     Failure:  None/Unknown
---------------------------------+------------------------------------------

Comment(by claus):

 I tried changing the `base...conf` file in `lib/package.conf.d`, followed
 by a `ghc-pkg recache`.
 {{{
 $ ghc-pkg field base haddock-interfaces,haddock-html
 haddock-interfaces:
 c:/haskell/ghc/ghc-7.0.1/doc/html/libraries/base-4.3.0.0/base.haddock
 haddock-html: c:/haskell/ghc/ghc-7.0.1/doc/html/libraries/base-4.3.0.0
 }}}
 That made no difference at all..

 I then tried `procmon` (systools' process monitor), which claims that for
 `cabal-0.8.2.exe haddock` (within a current `haddock` darcs repo), the
 only `base-4.3.0.0`-related file access until the error message was to
 {{{
 C:\haskell\ghc\doc\html\libraries\base-4.3.0.0\
 }}}
 which, of course, does not exist.

 Before my changes, the expanded paths were (possibly with a backslash
 before `base.haddock`)
 {{{
 $ ghc-pkg field base haddock-interfaces,haddock-html
 haddock-interfaces:
 C:/haskell/ghc/ghc-7.0.1\lib/../doc/html/libraries/base-4.3.0.0/base.haddock
 haddock-html:
 C:/haskell/ghc/ghc-7.0.1\lib/../doc/html/libraries/base-4.3.0.0
 }}}

--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4510#comment:1>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler
_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
GHC
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #4510: No links will be generated to these packages: base-4.3.0.0

GHC
In reply to this post by GHC
#4510: No  links will be generated to these packages: base-4.3.0.0
---------------------------------+------------------------------------------
    Reporter:  claus             |        Owner:  igloo      
        Type:  bug               |       Status:  new        
    Priority:  high              |    Milestone:  7.0.2      
   Component:  Compiler          |      Version:  7.0.1      
    Keywords:                    |     Testcase:              
   Blockedby:                    |   Difficulty:              
          Os:  Windows           |     Blocking:              
Architecture:  Unknown/Multiple  |      Failure:  None/Unknown
---------------------------------+------------------------------------------
Changes (by igloo):

  * owner:  => igloo
  * priority:  normal => high
  * milestone:  => 7.0.2


Comment:

 Thanks for the report. I'll try to take a look for 7.0.2.

--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4510#comment:2>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler
_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
GHC
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #4510: No links will be generated to these packages: base-4.3.0.0

GHC
In reply to this post by GHC
#4510: No  links will be generated to these packages: base-4.3.0.0
---------------------------------+------------------------------------------
    Reporter:  claus             |        Owner:  igloo      
        Type:  bug               |       Status:  new        
    Priority:  high              |    Milestone:  7.0.2      
   Component:  Compiler          |      Version:  7.0.1      
    Keywords:                    |     Testcase:              
   Blockedby:                    |   Difficulty:              
          Os:  Windows           |     Blocking:              
Architecture:  Unknown/Multiple  |      Failure:  None/Unknown
---------------------------------+------------------------------------------

Comment(by igloo):

 I can't reproduce this; are you doing anything different?:

 {{{
 $ cabal install --enable-documentation mtl
 [...]
 Running Haddock for mtl-2.0.1.0...
 Preprocessing library mtl-2.0.1.0...
 Warning: The documentation for the following packages are not installed.
 No
 links will be generated to these packages: ffi-1.0, rts-1.0
 Documentation created: .\.\dist\doc\html\mtl\.\index.html
 Installing library in C:\Documents and Settings\ian\Application
 Data\cabal\mtl-2.0.1.0\ghc-7.0.1
 Registering mtl-2.0.1.0...
 Updating documentation index C:\Documents and Settings\ian\Application
 Data\cabal\doc\index.html
 }}}

 {{{
 $ ghc-pkg dump | grep "haddock.*base"
 haddock-interfaces:
 $topdir/../doc/html/libraries/base-4.3.0.0\base.haddock
 haddock-html: $topdir/../doc/html/libraries/base-4.3.0.0

 $ ghc-pkg field base haddock-interfaces
 haddock-interfaces:
 C:/ghc/ghc-7.0.1\lib/../doc/html/libraries/base-4.3.0.0\base.haddock

 $ ghc-pkg field base haddock-html
 haddock-html: C:/ghc/ghc-7.0.1\lib/../doc/html/libraries/base-4.3.0.0
 }}}

 {{{
 $ ghc --version
 The Glorious Glasgow Haskell Compilation System, version 7.0.1

 $ cabal --version
 cabal-install version 0.8.2
 using version 1.8.0.6 of the Cabal library
 }}}

--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4510#comment:3>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler

_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
GHC
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #4510: No links will be generated to these packages: base-4.3.0.0

GHC
In reply to this post by GHC
#4510: No  links will be generated to these packages: base-4.3.0.0
---------------------------------+------------------------------------------
    Reporter:  claus             |        Owner:  igloo      
        Type:  bug               |       Status:  new        
    Priority:  high              |    Milestone:  7.0.2      
   Component:  Compiler          |      Version:  7.0.1      
    Keywords:                    |     Testcase:              
   Blockedby:                    |   Difficulty:              
          Os:  Windows           |     Blocking:              
Architecture:  Unknown/Multiple  |      Failure:  None/Unknown
---------------------------------+------------------------------------------

Comment(by claus):

 Here's my version:
 {{{
 $ cabal install mtl
 [..]
 Running Haddock for mtl-2.0.1.0...
 Preprocessing library mtl-2.0.1.0...
 Warning: The documentation for the following packages are not installed.
 No
 links will be generated to these packages: base-4.3.0.0, ffi-1.0, rts-1.0,
 ghc-prim-0.2.0.0, integer-gmp-0.2.0.2
 Warning: mtl-2.0.1.0:Control.Monad.Identity: Could not find documentation
 for exported module: Control.Monad
 Warning: mtl-2.0.1.0:Control.Monad.Identity: Could not find documentation
 for exported module: Control.Monad.Fix
 [..]
 Warning: Control.Monad.Writer.Class: could not find link destinations for:
     Data.Monoid.Monoid GHC.Base.Monad
 Warning: Control.Monad.State.Class: could not find link destinations for:
     GHC.Base.Monad Data.Monoid.Monoid
 Warning: Control.Monad.Reader.Class: could not find link destinations for:
     GHC.Base.Monad Data.Monoid.Monoid
 [..]
 Documentation created: .\.\dist\doc\html\mtl\.\index.html
 }}}
 {{{
 $ ghc-pkg.exe dump | grep "haddock.*/base"
 haddock-interfaces:
 $topdir/../doc/html/libraries/base-4.3.0.0/base.haddock
 haddock-html: $topdir/../doc/html/libraries/base-4.3.0.0

 $ ghc-pkg.exe field base haddock-interfaces,haddock-html
 haddock-interfaces:
 c:/haskell/ghc/ghc-7.0.1\lib/../doc/html/libraries/base-4.3.0.0/base.haddock
 haddock-html:
 c:/haskell/ghc/ghc-7.0.1\lib/../doc/html/libraries/base-4.3.0.0
 }}}
 {{{
 $ ghc --version
 The Glorious Glasgow Haskell Compilation System, version 7.0.1

 $ cabal-0.8.2.exe --version
 cabal-install version 0.8.2
 using version 1.8.0.2 of the Cabal library
 }}}
 The only difference I can see (apart from the whole thing not working for
 me) is that we're using the same cabal-install, but different Cabal
 library versions (I doubt it matters, but my machine is running Windows 7,
 64bit).

 I tried `cabal install cabal-install`, to see whether that would make any
 difference, but that turned out to be a very bad idea - not only did it
 break my package database by reinstalling core libraries (I thought only
 the old `upgrade` would try that?), it also failed to build `directory`,
 as it couldn't find `HsFFI.h` (has that not been fixed multiple times
 already?). Will have to resurrect my ghc-7.0.1 install, I guess.

--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4510#comment:4>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler

_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
GHC
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #4510: No links will be generated to these packages: base-4.3.0.0

GHC
In reply to this post by GHC
#4510: No  links will be generated to these packages: base-4.3.0.0
---------------------------------+------------------------------------------
    Reporter:  claus             |        Owner:  igloo      
        Type:  task              |       Status:  new        
    Priority:  high              |    Milestone:  7.0.2      
   Component:  Compiler          |      Version:  7.0.1      
    Keywords:  patio heaters     |     Testcase:              
   Blockedby:                    |   Difficulty:              
          Os:  Windows           |     Blocking:              
Architecture:  Unknown/Multiple  |      Failure:  None/Unknown
---------------------------------+------------------------------------------
Changes (by patioheater12):

  * keywords:  => patio heaters
  * type:  bug => task


Comment:

 == Patio Heaters - Wonderful way to heat outdoors ==
 [[Image(http://patioheaterexpert.com/wp-
 content/uploads/2009/09/patio_heater1.jpg)]]

 Having '''[http://patioheaterz.com/ patio heaters]''' at home keeps your
 family, guests and love ones to feel comfortable and warm. They may have
 different styles and designs but they still have the same function. You
 still need to be careful in using them and as well as proper handling and
 care of the heater is a must.

--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4510#comment:5>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler

_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
GHC
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #4510: No links will be generated to these packages: base-4.3.0.0

GHC
In reply to this post by GHC
#4510: No  links will be generated to these packages: base-4.3.0.0
---------------------------------+------------------------------------------
    Reporter:  claus             |        Owner:  igloo      
        Type:  bug               |       Status:  infoneeded  
    Priority:  high              |    Milestone:  7.2.1      
   Component:  Compiler          |      Version:  7.0.1      
    Keywords:                    |     Testcase:              
   Blockedby:                    |   Difficulty:              
          Os:  Windows           |     Blocking:              
Architecture:  Unknown/Multiple  |      Failure:  None/Unknown
---------------------------------+------------------------------------------
Changes (by igloo):

  * status:  new => infoneeded


Comment:

 Claus, having fixed your installation, are you still able to reproduce
 this?

--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4510#comment:6>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler

_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #4510: No links will be generated to these packages:base-4.3.0.0

Claus Reinke
> #4510: No  links will be generated to these packages: base-4.3.0.0
> ---------------------------------+------------------------------------------
>    Reporter:  claus             |        Owner:  igloo
>        Type:  bug               |       Status:  infoneeded
>    Priority:  high              |    Milestone:  7.2.1
>   Component:  Compiler          |      Version:  7.0.1
>    Keywords:                    |     Testcase:
>   Blockedby:                    |   Difficulty:
>          Os:  Windows           |     Blocking:
> Architecture:  Unknown/Multiple  |      Failure:  None/Unknown
> ---------------------------------+------------------------------------------

Hi,

I can't reach trac at the moment (first database lock error,
then no response to login), so replying here.

> Comment:
>
> Claus, having fixed your installation, are you still able to reproduce
> this?

Who says I have?-) Sadly, I still can't afford to spend time
on my Haskell interests, so I had to wait this one out. There
were some other doc-related problems with interim ghc
releases, so I didn't try again.

However, I've tried the following just now:

1. installed Haskell Platform 2011.2.0.0 and looked at the
    docs:

    Does not look good at all, all the extralibs docs seem
    missing (including mtl, apparently our testcase for this
    ticket) - apparently, they also have problems with the
    docs, but have either not noticed or not reported them?

2. installed ghc-7.0.3. Apart from the newest ghc release,
    this also gives me a current haddock (version 2.9.2),
    and I am using the new cabal-install (0.10.2/1.10.1.0)
    from the HP installation instead of the old one that
    broke my installation.

    Ran our testcase (cabal install mtl), and that looked
    much better (links to ffi-1.0, rts-1.0 missing, but that
    is standard, iirc).

I suggest cross-checking with the HP guys, especially the
windows release builder (they are working on an update
for ghc 7.0.3 anyway).

Docs tend to be the first thing to break when anything
gets reorganized (and that tends to happen whenever
nothing urgent needs fixing;-) - it would make sense
to have a few minimum tests on the ghc side (in
addition to the test suite that the HP still doesn't have):

    - no broken links in installer result
    - installing a cabal package like mtl with docs on top
        of ghc installer should work (no errors, correct
        location in ghc-pkg database, no missing links)

Once that is in place, this ticket could be closed (can't
test more thoroughly atm - sorry).

Claus
 


_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs
GHC
Reply | Threaded
Open this post in threaded view
|

Re: [GHC] #4510: No links will be generated to these packages: base-4.3.0.0

GHC
In reply to this post by GHC
#4510: No  links will be generated to these packages: base-4.3.0.0
---------------------------+------------------------------------------------
  Reporter:  claus         |          Owner:  igloo          
      Type:  bug           |         Status:  closed          
  Priority:  high          |      Milestone:  7.2.1          
 Component:  Compiler      |        Version:  7.0.1          
Resolution:  worksforme    |       Keywords:                  
  Testcase:                |      Blockedby:                  
Difficulty:                |             Os:  Windows        
  Blocking:                |   Architecture:  Unknown/Multiple
   Failure:  None/Unknown  |  
---------------------------+------------------------------------------------
Changes (by igloo):

  * status:  infoneeded => closed
  * resolution:  => worksforme


Comment:

 http://www.haskell.org/pipermail/glasgow-haskell-
 bugs/2011-April/029679.html

--
Ticket URL: <http://hackage.haskell.org/trac/ghc/ticket/4510#comment:7>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler

_______________________________________________
Glasgow-haskell-bugs mailing list
[hidden email]
http://www.haskell.org/mailman/listinfo/glasgow-haskell-bugs