Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-03 Thread Andrew Coppin

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:

http://trac.haskell.org/haskell-platform/
  


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:

http://hackage.haskell.org/package/mtl
  


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...)


___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Andrew Coppin

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.


___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Don Stewart
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
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Daniel Fischer
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

___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread 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
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-09-02 Thread Bas van Dijk
On Thu, Sep 2, 2010 at 8:20 PM, Daniel Fischer daniel.is.fisc...@web.de wrote:
 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
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Missing documentation in Haskell Platform on Windows

2010-08-31 Thread Ivan Lazar Miljenovic
On 1 September 2010 14:25, Arnaud Bailly arnaud.oq...@gmail.com 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 ?

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.miljeno...@gmail.com
IvanMiljenovic.wordpress.com
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe