Missing documentation in Haskell Platform on Windows
Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all doc under Control.Monad.XXX is missing. What am I doing wrong ? Arnaud
On 1 September 2010 14:25, Arnaud Bailly
Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all doc under Control.Monad.XXX is missing. What am I doing wrong ?
Is this in the documentation for GHC? Sometimes Haddock links to libraries used when building GHC but aren't shipped with GHC; I'm not sure how to deal with this. (Note: this isn't a Windows-specific problem; it also occurs on Gentoo Linux for example.)
Arnaud
_______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe
-- Ivan Lazar Miljenovic Ivan.Miljenovic@gmail.com IvanMiljenovic.wordpress.com
Arnaud Bailly wrote:
Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all doc under Control.Monad.XXX is missing. What am I doing wrong ?
Almost every release of GHC that I can remember has had the links for the "mtl" package broken. (The Control.Monad.XXX modules are mostly from mtl. But, for example, Control.Monad.Fix is from base. I bet you'll find it works just fine.) Today I went and did a thorough check. HP 2009.2.x.x (I forget exactly which one) has links that point to C:\Program Files\Haskell Platform\2009.2.x.x\doc\ghc-mtl-x.x.x which does not exist. There is, however, a folder named C:\Program Files\Haskell Platform\2009.2.x.x\doc\mtl-x.x.x which exists just fine, and appears to contain the correct stuff. In HP 2010.1.0.0 and 2010.2.0.0, the links point to the latter address, but no such folder actually exists. The mtl documentation appears to simply be missing entirely, rather than being in a different place than where the links point to. Various older releases of GHC (before HP existed) have had one problem or the other, always with mtl, never with any other package. I have absolutely no idea why mtl is always broken, but all the other packages seem to work just fine. The fact that it happens so routinely suggests a problem with the build process rather than a one-off mistake.
andrewcoppin:
Arnaud Bailly wrote:
Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all doc under Control.Monad.XXX is missing. What am I doing wrong ?
Almost every release of GHC that I can remember has had the links for the "mtl" package broken. (The Control.Monad.XXX modules are mostly from mtl. But, for example, Control.Monad.Fix is from base. I bet you'll find it works just fine.)
Well spotted, Andrew! The way to get things like this fixed is to report a bug to the relevant project. Click on the 'bug report' button: http://trac.haskell.org/haskell-platform/ You installed the Haskell Platform on Windows, so please mention this in the bug ticket. The problem will likely be in the Windows installer script, and what docs were bundled with that specific installer. Be as detailed in the report as you can, to make sure we can reproduce what trouble you have. In the meantime, you can always read the 'mtl' documentation on its package page: http://hackage.haskell.org/package/mtl -- Don
On Thursday 02 September 2010 19:34:07, Don Stewart wrote:
andrewcoppin:
Arnaud Bailly wrote:
Hello, I installed (succesfully) HAskell Platform 2010.2 on windows and have a small but annoying issue: Some links in HTML documentation lead to broken links. I did not investigate all the links, but I have seen that all doc under Control.Monad.XXX is missing. What am I doing wrong ?
Almost every release of GHC that I can remember has had the links for the "mtl" package broken. (The Control.Monad.XXX modules are mostly from mtl. But, for example, Control.Monad.Fix is from base. I bet you'll find it works just fine.)
Well spotted, Andrew!
The way to get things like this fixed is to report a bug to the relevant project. Click on the 'bug report' button:
http://trac.haskell.org/haskell-platform/
You installed the Haskell Platform on Windows, so please mention this in the bug ticket. The problem will likely be in the Windows installer script, and what docs were bundled with that specific installer.
Probably not. I'm on Linux and build my GHCs from source. There's no directory mtl-1.1.0.2 in ~/share/doc/ghc/html/libraries although it's linked to from the package index built with the compiler. (Hadn't noticed before because I use the index in ~/.cabal). Seems to be a slip-up in the makefiles.
Be as detailed in the report as you can, to make sure we can reproduce what trouble you have.
In the meantime, you can always read the 'mtl' documentation on its package page:
http://hackage.haskell.org/package/mtl
-- Don
On Thursday 02 September 2010 20:05:12, Daniel Fischer wrote:
Probably not. I'm on Linux and build my GHCs from source. There's no directory mtl-1.1.0.2 in ~/share/doc/ghc/html/libraries although it's linked to from the package index built with the compiler. (Hadn't noticed before because I use the index in ~/.cabal). Seems to be a slip-up in the makefiles.
Also broken: utf8-string haskeline terminfo
On Thu, Sep 2, 2010 at 8:20 PM, Daniel Fischer
On Thursday 02 September 2010 20:05:12, Daniel Fischer wrote:
Probably not. I'm on Linux and build my GHCs from source. There's no directory mtl-1.1.0.2 in ~/share/doc/ghc/html/libraries although it's linked to from the package index built with the compiler. (Hadn't noticed before because I use the index in ~/.cabal). Seems to be a slip-up in the makefiles.
Also broken:
utf8-string haskeline terminfo
Note that on Hackage all links in haddock pages to the current base library (4.2.0.2) are broken. Possibly because the documentation for base-4.2.0.2 was not build. The docs for base-4.2.0.1 are build fine: http://hackage.haskell.org/package/base Regards, Bas
Don Stewart wrote:
andrewcoppin:
Almost every release of GHC that I can remember has had the links for the "mtl" package broken. (The Control.Monad.XXX modules are mostly from mtl. But, for example, Control.Monad.Fix is from base. I bet you'll find it works just fine.)
Well spotted, Andrew!
The way to get things like this fixed is to report a bug to the relevant project.
M'kay. And for this, that would be...?
Click on the 'bug report' button:
Ah, right. There's a HP-specific tracker. I guess now I just have to go register my details with yet *another* tracker and then I can report it. (Right after I finish checking that nobody has already reported it for me...)
You installed the Haskell Platform on Windows, so please mention this in the bug ticket. The problem will likely be in the Windows installer script, and what docs were bundled with that specific installer.
Be as detailed in the report as you can, to make sure we can reproduce what trouble you have.
The information above probably says it all, so that shouldn't be hard.
In the meantime, you can always read the 'mtl' documentation on its package page:
Well, yeah, there is that. It's just annoying to click on certain links and find it's dead, even if there is a workaround. (Assuming you have Internet access, which you occasionally don't...)
participants (6)
-
Andrew Coppin -
Arnaud Bailly -
Bas van Dijk -
Daniel Fischer -
Don Stewart -
Ivan Lazar Miljenovic