Re: Broken documentation on Hackage.

2014-01-06 Thread Malcolm Wallace
On 5 Jan 2014, at 10:15, Mateusz Kowalczyk wrote: It seems that we are having a rather big issue with Hackage in recent months and I'm sure many of you have noticed: a lot of packages aren't getting their docs built. As far as I can tell, there can be multiple reasonable causes: *

Re: Broken documentation on Hackage.

2014-01-06 Thread Mateusz Kowalczyk
Oops, seems I sent to libraries. Let's keep the thread on cabal-devel only as here's where the replies happened. On 06/01/14 10:27, Malcolm Wallace wrote: On 5 Jan 2014, at 10:15, Mateusz Kowalczyk wrote: It seems that we are having a rather big issue with Hackage in recent months and I'm

Re: Broken documentation on Hackage.

2014-01-06 Thread Malcolm Wallace
On 6 Jan 2014, at 12:32, Henning Thielemann wrote: Am 06.01.2014 12:59, schrieb Mateusz Kowalczyk: On 06/01/14 10:27, Malcolm Wallace wrote: Haddock also was once stand-alone. I think it might be time to wind the clock backwards and retrieve this desirable property. Was Haddock ever

Re: Broken documentation on Hackage.

2014-01-06 Thread Brandon Allbery
On Mon, Jan 6, 2014 at 5:27 AM, Malcolm Wallace malcolm.wall...@me.comwrote: I think the fundamental problem is that Haddock is now built on top of ghc. So if a package cannot be built by ghc (for whatever reason, e.g. missing C library dependency), then it cannot be documented either. This

Re: Broken documentation on Hackage.

2014-01-06 Thread Johan Tibell
On Mon, Jan 6, 2014 at 3:33 PM, Brandon Allbery allber...@gmail.com wrote: On Mon, Jan 6, 2014 at 5:27 AM, Malcolm Wallace malcolm.wall...@me.comwrote: I think the fundamental problem is that Haddock is now built on top of ghc. So if a package cannot be built by ghc (for whatever reason,

Re: Broken documentation on Hackage.

2014-01-06 Thread Peter Selinger
Thank you, this worked like a charm! (Modulo using dist/doc/html instead of dist/doc). Now all my packages have online documentation. One day I'd still like to find out why it didn't build automatically. But as long as documentation builder doesn't generate a log saying what problem it thought

Re: Broken documentation on Hackage.

2014-01-06 Thread Carter Schonwald
i'm sure patches are welcome to improve hackage infrastructure in these ways! :) On Mon, Jan 6, 2014 at 3:00 PM, Peter Selinger selin...@mathstat.dal.cawrote: Thank you, this worked like a charm! (Modulo using dist/doc/html instead of dist/doc). Now all my packages have online documentation.

Re: Broken documentation on Hackage.

2014-01-06 Thread Mateusz Kowalczyk
On 05/01/14 10:15, Mateusz Kowalczyk wrote: Hi all, It seems that we are having a rather big issue with Hackage in recent months and I'm sure many of you have noticed: a lot of packages aren't getting their docs built. As far as I can tell, there can be multiple reasonable causes: [snip]

Re: Broken documentation on Hackage.

2014-01-06 Thread Simon Michael
Mateusz, thanks for the great sleuth work and communication on this. I'm working on fixing my missing docs (hledger*, broken due to pretty-show requiring a newer-than-default happy executable). ___ cabal-devel mailing list cabal-devel@haskell.org

Re: Broken documentation on Hackage.

2014-01-06 Thread Peter Selinger
Thanks, that's even better! However, I find that the --contents-location option to cabal haddock does not work properly. Apparently it not only prevents index.html from being built (which makes modest sense), but it also prevents index-frames.html from being built (which does not). So in the

Re: Broken documentation on Hackage.

2014-01-06 Thread Mateusz Kowalczyk
On 07/01/14 01:23, Peter Selinger wrote: Thanks, that's even better! However, I find that the --contents-location option to cabal haddock does not work properly. Apparently it not only prevents index.html from being built (which makes modest sense), but it also prevents index-frames.html

Re: Broken documentation on Hackage.

2014-01-06 Thread Peter Selinger
Hi Mateusz, of course you could do the same thing with a bash script. It's a matter of personal taste and workflow. Just for the record, you can pass arguments into a Makefile like this: make PACKAGE=bla. And $$ is indeed an escape, to denote a literal dollar sign (as opposed to a Makefile

Broken documentation on Hackage.

2014-01-05 Thread Mateusz Kowalczyk
Hi all, It seems that we are having a rather big issue with Hackage in recent months and I'm sure many of you have noticed: a lot of packages aren't getting their docs built. As far as I can tell, there can be multiple reasonable causes: * Dependencies fail to build so your package does * Your

Re: Broken documentation on Hackage.

2014-01-05 Thread Peter Selinger
I agree. Two of my packages are in your list: easyrender and newsynth (both have Nothing for a reason in your list). The problem for me is that, although you seem to have access to build logs, I don't. I have not found the way to access the hackage build logs for my packages or their

Re: Broken documentation on Hackage.

2014-01-05 Thread Mateusz Kowalczyk
On 05/01/14 14:14, Sven Panne wrote: My ALUT package is among the ones without documentation, and I have a theory what's wrong (probably a missing installed C library/package libalut-dev, see https://github.com/haskell-openal/ALUT/blob/master/.travis.yml). Two questions: * As a package

Re: Broken documentation on Hackage.

2014-01-05 Thread Mateusz Kowalczyk
On 05/01/14 18:15, Peter Selinger wrote: I agree. Two of my packages are in your list: easyrender and newsynth (both have Nothing for a reason in your list). If a package has Nothing for a reason, that means that no build log is available. From what I've read yesterday, it's a problem with